HP-UX SNAplus2 NOF Programmer's Guide

NOF API Verbs (ACTIVATE_SESSION to OPEN_FILE)
DEFINE_EMULATOR_USER
Chapter 3 233
• If neither the user ID nor the group ID can be
matched, but there is a <DEFAULT> record
defined, 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 (3270) or .stx
(5250) 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.