6.7.39SHOW MPI ROOT

#Syntax

#Description

Show (i.e. get) the MPI root process rank (for gathering processed (HDF5) data by other MPI processes) that may have been set through the operation SET MPI ROOT. If using an HDFql non MPI-based distribution, an error is raised.

#Parameter(s)

post_processing_option – optional option that transforms the result set according to the programmer’s needs, such as ordering or truncating (please refer to the section PROCESSING for additional information).

output_redirecting_option – optional option that specifies the cursor in use, an HDF5 object (i.e. dataset or attribute), a (text, binary, or Excel) file, or memory (i.e. user-defined variable) to write the result set into (please refer to the subsection INTO for additional information). If not specified, the cursor in use is populated with the result set instead (please refer to the chapter CURSOR for additional information).

#Return

The MPI root process rank (for gathering processed (HDF5) data by other MPI processes) as an HDFQL_INT.

#Example(s)

# set the MPI root process rank (to use when gathering processed (HDF5) data by other MPI processes) to 3
SET MPI ROOT 3

# show (i.e. get) rank of the MPI process specified as the root (should return 3) 
SHOW MPI ROOT

# set the MPI root process rank (to use when gathering processed (HDF5) data by other MPI processes) to the default value (i.e. 0)
SET MPI ROOT DEFAULT

# show (i.e. get) rank of the MPI process specified as the root (should return 0) 
SHOW MPI ROOT