Command Reference Guide

Administration Commands
query_3270_user_sessions
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.
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).
lu_name
The name of the LU used by the 3270 session for which information is required, or the LU name to be used
as an index into the list of sessions. This parameter is ignored if list_options is set to FIRST_IN_LIST; all
sessions for the combination of the user_name, system_name, and user_pid parameters are returned.
2.100.2 Returned Parameters: Summary Information
Parameter name Type Length
lu_name character 8
If the command executes successfully and you specified SUMMARY as the list_options parameter value, the following
parameter is returned:
lu_name
The LU used by the 3270 session.
2.100.3 Returned Parameters: Detailed Information
Parameter name Type Length
lu_name character 8
nau_address decimal
If the command executes successfully and you specified DETAIL as the list_options parameter value, the following
parameters are returned:
lu_name
The LU used by the 3270 session.
nau_address
The NAU address of the LU used by the 3270 session.
2.100.4 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:
301