HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_MODE
Detailed information.
Combine this value using a logical OR operation with one of the following values:
AP_FIRST_IN_LIST
Start at the first entry in the list (the first partner LU and mode for the specified local LU).
AP_LIST_INCLUSIVE
Start at the entry specified by the supplied partner LU name and mode name.
AP_LIST_FROM_NEXT
Start at the entry immediately following the entry specified by the supplied partner LU name and mode
name.
For AP_FIRST_IN_LIST, the entry used as the index into the list is defined by the combination of
lu_name
(or lu_alias) and fqplu_name (or plu_alias). If fqplu_name or plu_alias is not specified, the entry used as the
index is lu_name (or lu_alias).
For AP_LIST_INCLUSIVE or AP_LIST_FROM_NEXT, the entry used as the index into the list is defined
by the combination of lu_name (or lu_alias), fqplu_name (or plu_alias) and mode_name specified. For more
information about how the list is ordered and how the application can obtain specific entries from it, see
Section 2.7, List Options For QUERY_* Verbs.
lu_name
LU name. This is an 8-byte type-A EBCDIC string, padded on the right with spaces if the name is shorter
than 8 characters. To specify that the LU is identified by its alias rather than its LU name, set this parameter
to 8 binary zeros and specify the LU alias in the following parameter.
lu_alias
Locally defined LU alias. This parameter is used only if lu_name is set to 8 binary zeros; it is ignored
otherwise.
The alias is an 8-byte ASCII string, padded on the right with spaces if the name is shorter than 8 bytes. To
indicate the LU associated with the CP (the default LU), set both lu_name and lu_alias to binary zeros.
plu_alias
Partner LU alias. This is an 8-byte ASCII string, padded on the right with spaces if the name is shorter than 8
bytes. If list_options is set to AP_FIRST_IN_LIST, this parameter is ignored; otherwise you must specify
either the LU alias or the fully qualified LU name for the partner LU. To specify that the LU is identified
by its LU name rather than its alias, set this parameter to 8 binary zeros and specify the LU name in the
following parameter.
fqplu_name
Fully qualified network name for the partner LU. If list_options is set to AP_FIRST_IN_LIST, this parameter
is ignored; otherwise you must specify either the LU alias or the fully qualified LU name for the partner LU.
This parameter is used only if plu_alias is set to 8 binary zeros; it is ignored otherwise.
The name is a 17-byte EBCDIC string, right-padded with EBCDIC spaces. It consists of a network ID of
up to 8 A-string characters, an EBCDIC dot (period) character, and a network name of up to 8 A-string
characters.
mode_name
Mode name which designates the network properties for a group of sessions. This is an 8-byte type-A
EBCDIC string, padded on the right with spaces if the name is shorter than 8 characters. This parameter is
ignored if list_options is set to AP_FIRST_IN_LIST.
active_sessions
Specifies whether to return information only on modes for which sessions are active, or on all modes. Possible
values are:
545