HP-UX SNAplus2 R7 Administration Command Reference

Administration Commands
query_3270_user
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_ALERT_NUMBER
The list_options parameter was set to LIST_INCLUSIVE or LIST_FROM_NEXT, but one of the
following events has occurred:
• The alert_number parameter was not in the valid range.
• The alert with the specified number has not been defined.
• No alerts have been defined.
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.99 query_3270_user
The query_3270_user command returns information about users of the SNAplus2 3270 emulation program.
The command can return summary or detailed information about a single user or multiple users, depending on the
options used. It returns information about the user’s current usage of 3270 emulation, not on the definition of this
user in the configuration file; use query_emulator_user_def to obtain information about the configuration
file definition (such as session limits and access to 3270 functions), and query_3270_user_sessions to
obtain detailed information about individual sessions for the user.
This command must be issued to a running node.
2.99.1 Supplied Parameters
Parameter name Type Length Default
[query_3270_user]
num_entries decimal 1
list_options constant SUMMARY + LIST_INCLUSIVE
scope constant USER
user_name character 32 (null string)
system_name character 128 (null string)
user_pid decimal 0
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.
296