Command Reference Guide

Administration Commands
query_mode_definition
2.149 query_mode_definition
The query_mode_definition command returns information about modes, including SNA-defined modes. This
command can be used to obtain summary or detailed information about a specific mode or about multiple modes,
depending on the options used.
This command returns information about the definition of the modes, not about their current usage; use
query_mode to obtain information about the current usage of a mode by local and partner LUs. Modes are
ordered by name length and then by ASCII lexicographical ordering for names of the same length.
This command does not return information about the default COS name that will be used for any unrecognized
mode names; use query_mode_to_cos_mapping for information about the default COS name.
2.149.1 Supplied Parameters
Parameter name Type Length Default
[query_mode_definition]
num_entries decimal 1
list_options constant SUMMARY + LIST_INCLUSIVE
mode_name character 8 (null string)
Supplied parameters are:
num_entries
Maximum number of modes for which data should be returned. You can specify 1 to return data for a specific
mode, a number greater than 1 to return data for multiple modes, or 0 (zero) to return data for all modes.
list_options
The level of information required for each entry and the position in the list of modes from which SNAplus2
begins to return data.
Specify the level of information required with one of the following values:
SUMMARY
Summary information only
DETAIL
Detailed information
Use a + character to combine this value with one of the following values:
FIRST_IN_LIST
Start at the first entry in the list
LIST_INCLUSIVE
Start at the entry specified by the mode_name parameter
LIST_FROM_NEXT
Start at the entry immediately following the entry specified by the mode_name parameter
mode_name
Mode name that designates the network properties for a group of sessions. This parameter is ignored if
list_options is set to FIRST_IN_LIST. This name is a type-A character string.
461