Administration Commands
query_3270_user
If the computer name includes a . (period) character, SNAplus2 assumes that it is a
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 specified, 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
