HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_MODE_DEFINITION
primary_rc
AP_PARAMETER_CHECK
secondary_rc
Possible values are:
AP_INVALID_LIST_OPTION
The list_options parameter was not set to a valid value.
AP_INVALID_LU_ALIAS
The list_options parameter was set to AP_LIST_INCLUSIVE to list all entries starting from the
supplied name, but the lu_alias parameter was not valid.
AP_INVALID_LU_NAME
The list_options parameter was set to AP_LIST_INCLUSIVE to list all entries starting from the
supplied name, but the lu_name parameter was not valid.
AP_INVALID_MODE_NAME
The list_options parameter was set to AP_LIST_INCLUSIVE to list all entries starting from the
supplied name, but the mode_name parameter was not valid.
AP_INVALID_PLU_NAME
The list_options parameter was set to AP_LIST_INCLUSIVE to list all entries starting from the
supplied name, but one of the following conditions applies:
• The fqplu_name parameter does not match the name of any of this local LU’s partners.
• No sessions have been active (since the node was last started) for the specified combination of local
LU, partner LU, and mode.
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_PARAMETER_CHECK,
which are common to all NOF verbs.
3.137.5 Returned Parameters: Other Conditions
Appendix B, Common Return Codes lists further combinations of primary and secondary return codes that are
common to all NOF verbs.
3.138 QUERY_MODE_DEFINITION
QUERY_MODE_DEFINITION returns information about modes defined using DEFINE_MODE, or about SNA-
defined modes.
This verb can be used to obtain either summary or detailed information, about a specific mode or about multiple
modes, depending on the options used. It 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.
This verb cannot be used to return information about the default COS name that will be used for any unrecognized
mode names; use QUERY_MODE_TO_COS_MAPPING to do this.
3.138.1 VCB Structure
typedef struct query_mode_definition
{
549