HP-UX SNAplus2 NOF Programmer's Guide

NOF API Verbs (ACTIVATE_SESSION to OPEN_FILE)
DEFINE_3270_DIAG
Chapter 3 163
order (rtm_thresh2 must be higher than
rtm_thresh1 , rtm_thresh3 must be higher than
rtm_thresh2 , and so on).
def_data.num_alerts
The number of 3270 user alerts defined for the
SNAplus2 system; the range is 0-20.
The host NetView program identifies each alert by a
number in the range 1-20; check with the NetView
administrator at the host to determine which alert
numbers are used and the meaning of each alert. The
alert_3270_data structures supplied to this verb are
assigned to these numbers in sequence (the first
structure is assigned to alert number 1, the second
structure to alert number 2, and so on). If the host does
not use all the alert numbers in the range, include a
blank alert structure (with all parameters set to null
strings) for each unused number. For example, if the
host uses only alert numbers 10 and 11, set
num_alerts to 11 and include 9 blank alert structures
followed by the structures for alerts 10 and 11.
For each alert, up to the number specified in num_alerts , an
alert_3270_data structure is required with the following information:
alert_3270_data.description
A text description of the alert. This is an ASCII string
of 1-52 characters, followed by a null character.
This description is displayed in the 3270 user interface,
to identify the alert to the user. It is not sent to
NetView; the NetView operator identifies the alert by
its number.
alert_3270_data.parameter1 through alert_3270_data.parameter3
Text strings describing any parameters that the user
should enter for the alert. Each one is an ASCII string
of 1-32 characters, followed by a null character.
Check with the NetView administrator at the host to
determine the parameters required for each alert. An
alert may not require all three parameters; if so,