HP-UX SNAplus2 NOF Programmer's Guide

NOF API Verbs (QUERY Verbs)
QUERY_COS
Chapter 4 561
Start at the entry immediately
following the entry specified by the
cos_name parameter.
For more information about how the list is ordered and
how the application can obtain specific entries from it,
see “List Options For QUERY_* Verbs”.
cos_name
Class of service name for which data is required, or the
name to be used as an index into the list. This value is
ignored if list_options is set to AP_FIRST_IN_LIST.
The name is an 8-byte type-A EBCDIC string (starting
with a letter), padded on the right with EBCDIC spaces
if the name is shorter than 8 characters.
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
Total number of entries available. A value greater than
num_entries indicates that not all the available
entries were returned.