Command Reference Guide

Administration Commands
define_emulator_user
YES
The user_name parameter identifies a group name. Any user in this group will use this emulator user
record unless there is an explicit record for the user’s user name.
NO
The user_name parameter identifies a user name.
One or more
3270_session_data subrecords may follow. Each subrecord contains the following additional parameters:
session_name
A name identifying the session. This name is an 8-byte string consisting of locally displayable characters.
If the name matches an existing session name defined for this 3270 user, the information for that session is
replaced; otherwise, a new session is added.
To define sessions that are initially displayed in the 3270 emulation program’s control interface, specify a
name in the range
SESS0001–SESS0010. These names correspond to the session numbers 1–10 in the
control interface. If you use the names SESS0002, SESS0003, and SESS0005, the control interface will
display session numbers 2, 3, and 5 using the information defined for these names. (The names SESS0001–
SESS0010 are not displayed in the control interface; they are replaced by the long names defined for these
sessions in the 3270 style file.)
Sessions that are available for the user to remap to must be given names that are not in the range SESS0001–
SESS0010. The user will be able to access these sessions only if the change_lu parameter enables the user
to remap sessions.
description
An optional string of 0–31 characters. SNAplus2 uses this string for information only. It is stored in the
node’s configuration file and returned on the query_emulator_user_def command.
lu_name
Name of the LU or LU pool that this session uses. This name is an 8-byte type-A character string. It must
match the name of a type 0–3 LU or an LU pool that has already been defined.
If you assign the session to an LU that is in an LU pool, SNAplus2 will try to use this LU when the session
is activated. If the LU is not available, SNAplus2 will attempt to find a free LU from the pool (as though the
session had been assigned to the pool).
session_type
Type of the LU or pool (display or printer, and the screen model for display LUs). Possible values are:
3270_DISPLAY_MODEL_2
Display model 2 (80 x 24)
3270_DISPLAY_MODEL_3
Display model 3 (80 x 32)
3270_DISPLAY_MODEL_4
Display model 4 (80 x 43)
3270_DISPLAY_MODEL_5
Display model 5 (132 x 27)
PRINTER
Printer LU (this value is not valid if lu_name specifies an LU pool)
model_override
91