HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_3270_DIAG
} DIAG_3270_DATA;
typedef struct alert_3270_data
{
AP_UINT16 overlay_size; /* reserved */
unsigned char description[53]; /* description */
unsigned char parameter1[33]; /* parameter 1 */
unsigned char parameter2[33]; /* parameter 2 */
unsigned char parameter3[33]; /* parameter 3 */
unsigned char reserv1[8]; /* reserved */
} ALERT_3270_DATA;
3.87.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_QUERY_3270_DIAG
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 3270 user alerts for which data should be returned. To request data for a specific alert
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 alerts 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 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 Section 2.7, 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.
3.87.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
332