HP-UX SNAplus2 NOF Programmer's Guide

NOF API Verbs (QUERY Verbs)
QUERY_3270_DIAG
Chapter 4502
Start at the entry specified by the
alert_number parameter.
AP_LIST_FROM_NEXT
Start at the entry immediately
following the entry specified by the
alert_number parameter.
For more information about how the application can
obtain specific entries from the list, see “List Options
For QUERY_* Verbs”.
If no alerts have been defined, this parameter must be
set to AP_FIRST_IN_LIST.
alert_number
The number of the alert for which information is
required, or the number to be used as an index into the
list of alerts. This is a number in the range 1-20; it is
ignored if list_options is set to AP_FIRST_IN_LIST.
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 buffer.
total_buf_size
Returned value indicating the size of buffer that would
have been required to return all the list information
requested. This may be higher than buf_size .
total_num_entries
Total number of alert entries that could have been
returned. This may be higher than num_entries .
num_entries
The number of alert entries actually returned.