Command Reference Guide

Administration Commands
query_emulator_user_def
2.130.3 Error Return Codes
If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a
secondary return code to provide specific details about the reason for unsuccessful execution.
Parameter Check
If the command does not execute because of a parameter error, SNAplus2 returns the following parameters:
primary_rc
PARAMETER_CHECK
secondary_rc
Possible values are:
INVALID_TEMPLATE_NAME
The template specified in the template_name parameter was not valid.
State Check
No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands,
occur for this command.
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.131 query_emulator_user_def
The query_emulator_user_def command returns information about 3270 users or 5250 users defined in
a SNAplus2 configuration file. It can return summary or detailed information about a single user or multiple
users, depending on the options used. The command returns information about the definition of this user in the
configuration file, not on the user’s current usage of the emulation program. You can use query_3270_user
and query_3270_user_sessions to obtain information about a user’s current 3270 emulation usage.
This command is not associated with a particular node because emulation program users are defined as domain
resources.
2.131.1 Supplied Parameters
Parameter name Type Length Default
[query_emulator_user_def]
num_entries decimal 1
list_options constant SUMMARY+LIST_INCLUSIVE
user_name character 32 (null string)
emulator_type constant ALL
Supplied parameters are :
num_entries
Maximum number of users for which data should be returned. You can specify 1 to return data for a specific
user, a number greater than 1 to return data for multiple users, or 0 (zero) to return data for all users.
list_options
383