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

Page 383
Image 383
HP UX Internet and Networking Software manual Queryemulatoruserdef, Error Return Codes