HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_EMULATOR_USER
When the user starts the emulation program, SNAplus2 checks the user ID against the emulator user records
in the configuration to find the correct record, in the following order:
• If the user ID matches a record for a specific user name, this record is used.
• If the user ID cannot be matched but the user’s group ID matches a record for a group, this record is used.
• If neither the user ID nor the group ID can be matched, but there is a <DEFAULT> record de
fined, this
record is used.
def_data.description
An optional text string (0–31 characters followed by a null character). The string is for information only; it is
stored in the configuration file and returned on the QUERY_EMULATOR_USER_DEF verb, but SNAplus2
does not make use of it. You can use it to store additional information such as the user
’s full name, to help
distinguish between users.
def_data.style_file
The name of this user’s default style file. This is a string of 1–8 characters, followed by a null character. For
HP-UX, the actual file name used is the name specified here with the extension
.stu appended to it. For
Windows, check the emulator documentation for details of style file naming conventions.
def_data.num_sessions
The number of sessions (3270, 5250, or both) being defined or modified by this verb. Each session must be
specified by a
session_def_data structure following the
def_data structure.
def_data.max_act_sessions
The maximum number of 3270 sessions that this user can access simultaneously. (For a 5250-only user, this
field is ignored.) Use this field as follows:
• To prevent the user from using 3270 emulation, set this field to zero.
• To restrict the number of sessions that the user can use simultaneously, set this field to a value between
1 and 10 (or between 1 and the total number of sessions defined for the user, if this is less than 10).
• To specify no limit, set this field to 0xFFFFFFFF.
def_data.view_rtm
Specifies whether the user has permission to view Response Time Monitor (RTM) data. This also determines
whether the Last Transaction Time Indicator (LTTI) is displayed on the 3270 status line. (For a 5250-only
user, this field is ignored.) Possible values are:
AP_YES
The user can view RTM data; the LTTI is displayed.
AP_NO
The user cannot view RTM data; the LTTI is not displayed.
def_data.alert_permission
Specifies whether the user has permission to send 3270 user alerts. (For a 5250-only user, this field is ignored.)
Possible values are:
AP_YES
The user can send alerts.
AP_NO
The user cannot send alerts.
def_data.change_lu
152