HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_3270_DIAG
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.
diag_3270_data
Data structure containing 3270 diagnostics information. The format of this information is the same as for the
DEFINE_3270_DIAG verb.
For each alert, up to the number specified in num_entries,an
alert_3270_data structure is included. The format of
the information in this structure is the same as for the DEFINE_3270_DIAG verb.
3.87.4 Returned Parameters: Parameter Check
If the verb does not execute because of a parameter error, SNAplus2 returns the following parameters:
primary_rc
AP_PARAMETER_CHECK
secondary_rc
Possible values are:
AP_INVALID_ALERT_NUMBER
The list_options parameter was set to AP_LIST_INCLUSIVE or AP_LIST_FROM_NEXT, but one of
the following has occurred:
• The alert_number parameter was not in the valid range.
• The alert with the specified number has not been defined.
• No alerts have been defined.
AP_INVALID_LIST_OPTION
The list_options parameter was not set to a valid value.
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_PARAMETER_CHECK,
which are common to all NOF verbs.
3.87.5 Returned Parameters: Other Conditions
Appendix B, Common Return Codes lists further combinations of primary and secondary return codes that are
common to all NOF verbs.
333