HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_SESSION
AP_QUERY_SESSION
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 sessions for which data should be returned. To request data for a specific session 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 session_id parameter.
AP_LIST_FROM_NEXT
Start at the entry immediately following the entry specified by the session_id parameter.
The combination of the local LU (lu_name or lu_alias), partner LU (plu_alias or fqplu_name), and
mode_name specified is used as an index into the list of sessions if the list_options parameter is set to
AP_LIST_INCLUSIVE or AP_LIST_FROM_NEXT.
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. To specify the LU associated with the
local CP (the default LU), set both lu_name and lu_alias to binary zeros.
lu_alias
Locally defined LU alias. This is an 8-byte ASCII string, padded on the right with spaces if the name is
shorter than 8 bytes. This parameter is used only if lu_name is set to 8 binary zeros; it is ignored otherwise.
To specify 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. To return information only about sessions associated with a specific partner LU, specify
the partner LU alias (in this parameter) or the partner LU fully qualified name (in the following parameter).
647