HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_PARTNER_LU_DEFINITION
Size of the supplied data buffer.
num_entries
Maximum number of LUs for which data should be returned. To request data for a specific LU rather than a
range, specify the value
1. To return as many entries as possible, specify zero; in this case, SNAplus2 will
return the maximum number of entries that can be accommodated in the supplied data buffer.
list_options
The position in the list from which SNAplus2 should begin to return data, and the level of information required
for each entry. Specify the level of information with one of the following values:
AP_SUMMARY
Summary information only.
AP_DETAIL
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.
AP_LIST_INCLUSIVE
Start at the entry specified by the plu_alias or fqplu_name parameter.
AP_LIST_FROM_NEXT
Start at the entry immediately following the entry specified by the plu_alias or fqplu_name parameter.
If AP_FIRST_IN_LIST is specified, you can also include the following option, using a logical OR
operation:
AP_LIST_BY_ALIAS
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.)
For more information about how the application can obtain specific entries from the list, see Section 2.7, List
Options For QUERY_* Verbs.
plu_alias
Partner LU alias. The name 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 partner LU
is defined by its fully qualified name instead of its alias, set this parameter to 8 binary zeros and specify the
name in the following parameter.
fqplu_name
Fully qualified name of the partner LU for which information is required, or the name to be used as an index
into the list of LUs. 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 parameter is set to zeros, and 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.
605