HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_3270_DIAG
primary_rc
AP_INVALID_VERB
secondary_rc
(No secondary return code is returned.)
3.86.9 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.
3.87 QUERY_3270_DIAG
QUERY_3270_DIAG returns information about the 3270 diagnostics parameters for the SNAplus2 system. It returns
information about the parameters used to record and display response-time data; depending on the options used, it
can also return data on a 3270 user alert that users can send to the host NetView program, or on multiple alerts.
This verb must be issued to the domain configuration file. If 3270 diagnostics parameters have not been defined,
the verb returns the default parameters that SNAplus2 uses for response-time data; no alert definitions are returned.
3.87.1 VCB Structure
typedef struct query_3270_diag
{
AP_UINT16 opcode; /* verb operation code */
unsigned char reserv2; /* reserved */
unsigned char format; /* reserved */
AP_UINT16 primary_rc; /* primary return code */
AP_UINT32 secondary_rc; /* secondary return code */
unsigned char *buf_ptr; /* pointer to buffer */
AP_UINT32 buf_size; /* buffer size */
AP_UINT32 total_buf_size; /* total buffer size required */
AP_UINT16 num_entries; /* number of entries */
AP_UINT16 total_num_entries; /* total number of entries */
unsigned char list_options; /* listing options */
unsigned char reserv3; /* reserved */
AP_UINT16 alert_number; /* index into alerts */
DIAG_3270_DATA def_data;
} QUERY_3270_DIAG;
typedef struct diag_3270_data
{
unsigned char rtm_overflow; /* Send RTM data at counter */
/* overflow */
unsigned char rtm_unbind; /* Send RTM data at UNBIND */
unsigned char rtm_timer_option; /* RTM timers option */
unsigned char reserv1; /* reserved */
AP_UINT16 rtm_thresh1; /* RTM threshold #1 */
AP_UINT16 rtm_thresh2; /* RTM threshold #2 */
AP_UINT16 rtm_thresh3; /* RTM threshold #3 */
AP_UINT16 rtm_thresh4; /* RTM threshold #4 */
AP_UINT16 num_alerts; /* Number of user alerts */
unsigned char reserv2[6]; /* Reserved */
331