High Availability Monitors Version A.03.02 Release Notes
NOF API Verbs (QUERY Verbs)
QUERY_MODE_TO_COS_MAPPING
Chapter 4814
Mode name for which information is required, or the
name to be used as an index into the list. This value is
ignored if
list_options
is set to AP_FIRST_IN_LIST.
The mode name is an 8-byte type-A EBCDIC string,
padded on the right with spaces if the name is shorter
than 8 characters. To return information about the
default COS that is used for any unrecognized mode
names, set this parameter to 8 binary zeros.
Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following
parameters:
primary_rc
AP_OK
buf_size
Length of the information returned in the supplied
buffer.
total_buf_size
Returned value indicating the size of buffer that would
have been required to return all the list information
requested. A value greater than
buf_size
indicates
that not all the available entries were returned.
num_entries
Number of entries returned in the data buffer.
total_num_entries
Total number of entries available. A value greater than
num_entries
indicates that not all the available
entries were returned.
Each entry in the data buffer consists of the following
parameters:
mode_to_cos_mapping_data.overlay_size
The size of the returned mode_to_cos_mapping_data
structure, and therefore the offset to the start of the
next entry in the data buffer.