HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_LU_LU_PASSWORD
AP_QUERY_LU_LU_PASSWORD
buf_ptr
A pointer to a data buffer that SNAplus2 will use to return the requested information.
buf_size
Size of the supplied data buffer.
num_entries
Maximum number of partner LUs for which password information should be returned. To request a specific
entry 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. 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 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.
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 name is an 8-byte type-A EBCDIC character string. 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
lu_alias parameter.
lu_alias
Locally defined LU alias. This is an 8-byte ASCII character string. This parameter is used only if lu_name
is set to all zeros; it is ignored otherwise. To indicate the LU associated with the CP (the default LU), set
both lu_name and lu_alias to all zeros.
plu_alias
Partner LU alias. This is an 8-byte ASCII character string. 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 identified by its fully qualified LU name instead of its LU
alias, set this parameter to 8 binary zeros, and specify the LU alias in the fqplu_name 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 all 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.
3.132.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
528