HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_SNA_NET
opcode
AP_QUERY_SNA_NET
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 server names for which data 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 server_name parameter.
AP_LIST_FROM_NEXT
Start at the entry immediately following the entry specified by the server_name parameter.
For more information about how the application can obtain specific entries from the list, see Section 2.7, List
Options For QUERY_* Verbs. The server names are listed in the same order as in the file, not in order of
name length and/or lexicographical order as for other QUERY_* verbs.
server_name
Name of the server for which information is required, or the name to be used as an index into the list of
servers. The server name is ignored if list_options is set to AP_FIRST_IN_LIST.
If the server name includes a . (period) character, SNAplus2 assumes that it is a fully-qualified name;
otherwise it performs a DNS lookup to determine the server name.
3.158.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
Returned value indicating the size of buffer that would have been required to return all the list information
requested. A value greater than buf_size indicates that not all the available entries were returned.
num_entries
Number of entries returned in the data buffer.
total_num_entries
654