HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_PARTNER_LU
The list is returned in order of LU alias rather than LU name. This option is only valid if
AP_FIRST_IN_LIST is also specified. (For AP_LIST_FROM_NEXT or AP_LIST_INCLUSIVE,
the list is in order of LU alias or LU name, depending on which was specified as the index into the
list.)
The combination of the local LU (
lu_name or lu_alias) and partner LU (plu_alias or fqplu_name) specified
is used as an index into the list of partner LUs if the list_options parameter is set to AP_LIST_INCLUSIVE
or AP_LIST_FROM_NEXT.
The list is ordered by fqplu_name. 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 of the local LU. This is an 8-byte type-A EBCDIC string, padded on the right with spaces if the
name is shorter than 8 characters. To indicate that the LU is identified by its LU alias instead of its LU name,
set this parameter to 8 binary zeros and specify the LU alias in the following parameter.
lu_alias
LU alias of the local LU. This parameter is used only if the lu_name field is set to 8 binary zeros, and 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 local 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 indicate that the LU is identified
by its fully qualified name instead of its alias, set this parameter to 8 binary zeros and specify the LU name
in the following parameter.
fqplu_name
17-byte 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 the plu_alias field is set to 8 binary zeros, and is ignored other-
wise.
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.
active_sessions
Specifies whether to return information only on partner LUs for which sessions are active, or on all partner
LUs. Possible values are:
AP_YES
Return information only on partner LUs for which sessions are currently active.
AP_NO
Return information about all partner LUs for which sessions are active or have been active.
3.147.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
primary_rc
AP_OK
buf_size
599