Command Reference Guide

Administration Commands
define_emulator_user
State Check
If the command does not execute because of a state error, SNAplus2 returns the following parameters:
primary_rc
STATE_CHECK
secondary_rc
Possible values are:
INVALID_HOST_LU_NAME
The specified host_lu_name parameter value was not valid.
Other Conditions
Appendix A, Common Return Codes from snapadmin Commands, lists combinations of primary and secondary
return codes that are common to all commands.
2.22 define_emulator_user
The define_emulator_user command identifies a user of the SNAplus2 system who can use 3270 emulation
or 5250 emulation, and it defines the resources available to that user. Use this command to define a new user, to
define new sessions for use by an existing user, or to modify the user parameters and session parameters for an
existing user. (To delete sessions from an existing user, use delete_emulator_user.)
This command is not associated with a particular node because emulation program users are defined as domain
resources.
2.22.1 Supplied Parameters
Parameter name Type Length Default
[define_emulator_user]
user_name character 32
description character 31 (null string)
style_file character 8 (null string)
max_act_sessions decimal 10
view_rtm constant NO
alert_permission constant NO
change_lu constant NO
change_style constant NORMAL
user_is_group constant NO
{3270_session_data}
session_name character 8
description character 31 (null string)
lu_name character 8
session_type constant 3270_DISPLAY_MODEL_2
model_override constant YES
(One or more 3270_session_data subrecords may be included.)
{5250_session_data}
session_name character 8
description character 31 (null string)
local_lu_alias character 8
88