HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_AVAILABLE_TP
opcode
AP_QUERY_AVAILABLE_TP
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 TPs for which data should be returned. To request data for a specific TP 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 of TPs from which SNAplus2 should begin to return data. Possible values are:
AP_FIRST_IN_LIST
Start at the first entry in the list.
AP_LIST_INCLUSIVE
Start at the entry specified by the combination of TP name and system name.
AP_LIST_FROM_NEXT
Start at the entry immediately following the entry specified by the combination of TP name and system
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.
tp_name
TP name. This is a 64-byte string, padded on the right with spaces if the name is shorter than 64 characters.
This value is ignored if list_options is set to AP_FIRST_IN_LIST.
system_name
The computer name for which TP information is required. The system name is an ASCII string of 1–128
characters, which must match a SNAplus2 computer name. This value is ignored if list_options is set to
AP_FIRST_IN_LIST.
If the computer name includes a . (period) character, SNAplus2 assumes that it is a fully-qualified name;
otherwise it performs a DNS lookup to determine the computer name.
If SNAplus2 is running with all programs on a single computer, there is no need to specify the computer
name (it can be left as all binary zeros). For a client-server system, specify the computer name to list only
TPs on the specified computer, or leave it as all binary zeros to list TPs on all computers.
3.92.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
primary_rc
AP_OK
buf_size
Length of the information returned in the supplied buffer.
total_buf_size
350