HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_LS_ROUTING
The position in the list of LS routing entries from which SNAplus2 begins to return data.
Specify 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 combination of the lu_name and fq_partner_lu parameters.
AP_LIST_FROM_NEXT
Start at the entry immediately following the entry specified by the combination of the lu_name,
fq_partner_lu, and wildcard_fqplu parameters.
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
Name of the local LU, as defined to SNAplus2. This is an 8-byte type-A EBCDIC string, padded on the
right with spaces if the name is shorter than eight bytes. This parameter is ignored if list_options is set to
AP_FIRST_IN_LIST.
lu_alias
This parameter is reserved; set it to binary zeros.
fq_partner_lu
Fully qualified name of the partner LU, as defined to SNAplus2. The name is a 17-byte EBCDIC string,
padded on the right with EBCDIC spaces. This parameter is used to qualify the entry to return within
the list of partner LU names for the specified local LU. This parameter is ignored if list_options is set to
AP_FIRST_IN_LIST.
If this parameter is set to binary zeros and list_options is set to AP_LIST_FROM_NEXT, the returned list
starts at the first partner LU name for the LU identified by the lu_name parameter.
wildcard_fqplu
Wildcard partner LU flag indicating whether the fq_partner_lu parameter contains a full or partial wildcard.
This flag is used only to identify the first record to return. It cannot be used to specify that only entries
matching the wildcard specification are to be returned. Possible values are:
AP_YES
The fq_partner_lu parameter contains a wildcard entry.
AP_NO
The fq_partner_lu parameter does not contain a wildcard entry.
3.130.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
primary_rc
AP_OK
lu_name
Name of the local LU.
fq_partner_lu
513