HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_3270_DIAG
3.11 DEFINE_3270_DIAG
DEFINE_3270_DIAG specifies the 3270 diagnostics parameters for SNAplus2 (the parameters used to record and
display response-time data, and the 3270 user alerts that users can send to the host NetView program). It can be
used to define 3270 diagnostics parameters for the first time, or to modify an existing definition.
This verb must be issued to the domain configuration file.
3.11.1 VCB Structure
The DEFINE_3270_DIAG verb contains a variable number of
alert_3270_data structures, each of which defines a
3270 user alert. The structures are included at the end of the
diag_3270_data
structure; the number of these structures
is specified by the
num_alerts parameter.
typedef struct define_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 */
DIAG_3270_DATA def_data;
} DEFINE_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 */
} 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.11.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_DEFINE_3270_DIAG
106