HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_3270_DIAG
def_data.rtm_overflow
Specifies whether to send RTM data to the host every time one of the RTM counters overflows (reaches its
maximum value). There is a counter for each of the intervals defined by the
rtm_thresh values below. Possible
values are:
AP_YES
Send RTM data to the host each time a counter overflows.
AP_NO
Do not send RTM data to the host at counter overflow. RTM data may be lost when a counter overflows.
def_data.rtm_unbind
Specifies whether to send RTM data to the host every time a 3270 session is unbound (ends). Possible values
are:
AP_YES
Send RTM data to the host each time a session ends.
AP_NO
Do not send RTM data to the host at session end. RTM data may be lost when the session ends.
def_data.rtm_timer_option
Specifies how the host response time is measured. The response time is defined as the interval between the
user pressing
ENTER or an AID key to send data to the host, and one of the following events:
AP_RTM_SCREEN
The first data from the host reaches the user’s screen.
AP_RTM_UNLOCK
The host unlocks the user’s keyboard.
AP_RTM_DIRECTION
The host gives the 3270 emulation program direction, so that the user can send more data.
def_data.rtm_thresh1 through def_data.rtm_thresh4
Specify the threshold values used to classify response times. These values divide the range of possible response
times into five intervals (below rtm_thresh1, between rtm_thresh1 and rtm_thresh2, between rtm_thresh2 and
rtm_thresh3, between rtm_thresh3 and rtm_thresh4, and above rtm_thresh4). SNAplus2 maintains a counter
for each of these intervals; each time a host response is received, SNAplus2 determines which of these
intervals it falls into, and increments the appropriate counter.
For each threshold, specify a number representing tenths of seconds; for example, the value 25 indicates 2.5
seconds. The values must be in the range 1–1000 (0.1 second–100 seconds), and must be in ascending 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.
107