Command Reference Guide

Administration Commands
query_3270_user
If the computer name includes a . (period) character, SNAplus2 assumes that it is a fully-qualified name;
otherwise it performs a DNS lookup to determine the computer name.
If all SNAplus2 components are running on one computer, there is no need to specify the computer name.
Otherwise, if no computer name is specified, SNAplus2 returns the first entry it finds for the specified user
name; you do not need to specify the computer name unless the specified user is using the 3270 emulation
program on more than one computer, or unless the
scope is set to USER_PROCESS.
user_pid
The process ID of the 3270 emulation program for which information is required.
If the SNAplus2 system includes only one server, this parameter is required only if the user is using more
than one copy of the 3270 emulation program. If there are multiple servers and no process ID is speci
fied,
SNAplus2 returns the first entry it finds for the specified user name; you do not need to specify the process
ID unless the specified user is using more than one copy of the 3270 emulation programon the computer
specified by the system_name parameter. If you specify this parameter, you must also specify the system_name
parameter.
If the process ID is not required, set it to 0 (zero).
2.99.2 Returned Parameters: Summary Information
Parameter name Type Length
user_name character 31
system_name character 63
user_pid decimal
If the command executes successfully and you specified SUMMARY as the list_options parameter value, the following
parameters are returned:
user_name
The name of the 3270 user.
system_name
The computer name on which the 3270 emulation program is running.
user_pid
The process ID of the 3270 emulation program.
2.99.3 Returned Parameters: Detailed Information
Parameter name Type Length
user_name character 31
system_name character 63
user_pid decimal
user_uid decimal
user_gid decimal
user_gname character 31
user_session_count decimal
user_start_time character 26
If the command executes successfully and you specified DETAIL as the list_options parameter value, the following
parameters are returned:
user_name
The name of the 3270 user.
system_name
298