LOGWHO command: Difference between revisions
m (→Usage notes) |
|||
| Line 21: | Line 21: | ||
<p>The LOGWHO command lists the user IDs of all users currently logged in to <var class="product">Model 204</var>. LOGWHO also lists each SNA Communications Server (formerly VTAM) terminal that is in session with <var class="product">Model 204</var> even if no user is currently logged in through that thread; in this case, NO ACCOUNT appears in the user ID field of the output.</p> | <p>The LOGWHO command lists the user IDs of all users currently logged in to <var class="product">Model 204</var>. LOGWHO also lists each SNA Communications Server (formerly VTAM) terminal that is in session with <var class="product">Model 204</var> even if no user is currently logged in through that thread; in this case, NO ACCOUNT appears in the user ID field of the output.</p> | ||
<p>For each user ID listed, LOGWHO provides a terminal identification field if the SNA Communications Server or IUCV access method is being used by that thread. LOGWHO also displays the names of any files opened by each user ID.</p> | <p>For each user ID listed, LOGWHO provides a terminal identification field if the SNA Communications Server or IUCV access method is being used by that thread. LOGWHO also displays the names of any files opened by each user ID.</p> | ||
<p>LOGWHO also lists process and processgroup names.</p> | <p> | ||
LOGWHO also lists process and processgroup names.</p> | |||
====LOGWHO for PQO==== | |||
For Parallel Query Option/204 (PQO) users, the LOGWHO display depends on whether it is issued for a client or server. Issued at a client node, LOGWHO shows the remote files currently open. Issued at a server node for a service thread, the display includes identification of client users and any service thread subsystem. | |||
<p> | |||
The format of the PQO display follows. The fields are left-justified and blank-filled, except for nn, the user number, which is right-justified, blank-filled, and in a field of two digits for numbers 0 through 99 or of as many digits necessary for larger numbers. <b>bb</b> is two blanks.</p> | |||
<p class="code">USER nn userid<b><i>bb</i></b>termid<b><i>bb</i></b>file1<b><i>bb</i></b>file2...<b><i>bb</i></b> | <p class="code">USER nn userid<b><i>bb</i></b>termid<b><i>bb</i></b>file1<b><i>bb</i></b>file2...<b><i>bb</i></b> | ||
[CLNT:<b><i>bb</i></b>mmmmm<b><i>bb</i></b>ON<b><i>bb</i></b>clntname] [APSY: apsyname] | [CLNT:<b><i>bb</i></b>mmmmm<b><i>bb</i></b>ON<b><i>bb</i></b>clntname] [APSY: apsyname] | ||
| Line 30: | Line 34: | ||
<table> | <table> | ||
<tr> <th | <tr class="head"> | ||
<th>Term</th> <th>Thread</th> <th>Meaning</th> </tr> | |||
</th> <th | |||
</th> <th | |||
</th> </tr> | |||
<tr> <th rowspan="2"> | <tr> <th rowspan="2"> | ||
| Line 118: | Line 117: | ||
<p>Name of the subsystem into which service thread is logged, if any</p> | <p>Name of the subsystem into which service thread is logged, if any</p> | ||
</td> </tr> | </td> </tr> | ||
</table> | </table> | ||
<p>In addition to the list of regular user IDs, LOGWHO prints a list of terminal lines that have encountered severe I/O errors and have been shut down (dead users). Also printed is a list of users to be reactivated (hardwired terminals that have been temporarily shut down because of I/O errors and that can be reactivated with the REACTIVATE command).</p> | <p> | ||
<p>To execute the LOGWHO command, reply STATUS to the outstanding HALT message.</p> | In addition to the list of regular user IDs, LOGWHO prints a list of terminal lines that have encountered severe I/O errors and have been shut down (dead users). Also printed is a list of users to be reactivated (hardwired terminals that have been temporarily shut down because of I/O errors and that can be reactivated with the REACTIVATE command).</p> | ||
<p> | |||
To execute the LOGWHO command, reply STATUS to the outstanding HALT message.</p> | |||
====Sending LOGWHO output to the USE data set==== | ====Sending LOGWHO output to the USE data set==== | ||
<p>If there is an open USE data set, the LOGWHO command output is directed to it. See [[RESET COMMAND command|RESET COMMAND: Control USE data set support]] for a discussion of how to direct the output.</p> | <p> | ||
If there is an open USE data set, the LOGWHO command output is directed to it. See [[RESET COMMAND command|RESET COMMAND: Control USE data set support]] for a discussion of how to direct the output.</p> | |||
[[Category: System administrator commands]] | [[Category: System administrator commands]] | ||
[[Category:Commands]] | [[Category:Commands]] | ||
Revision as of 21:48, 24 June 2013
Summary
- Privileges
- System administrator
- Function
- Lists the user IDs of all users who are currently logged in to Model 204
Format
LOGWHO
Syntax notes
LOGWHO can be issued from within a procedure - this has been the case since V6R1, or perhaps longer.
Example
LOGWHO USER 0 SUPERKLUGE USER 1 CCA CENSUS CARS USER 3 DPH HEALTH
Usage notes
The LOGWHO command lists the user IDs of all users currently logged in to Model 204. LOGWHO also lists each SNA Communications Server (formerly VTAM) terminal that is in session with Model 204 even if no user is currently logged in through that thread; in this case, NO ACCOUNT appears in the user ID field of the output.
For each user ID listed, LOGWHO provides a terminal identification field if the SNA Communications Server or IUCV access method is being used by that thread. LOGWHO also displays the names of any files opened by each user ID.
LOGWHO also lists process and processgroup names.
LOGWHO for PQO
For Parallel Query Option/204 (PQO) users, the LOGWHO display depends on whether it is issued for a client or server. Issued at a client node, LOGWHO shows the remote files currently open. Issued at a server node for a service thread, the display includes identification of client users and any service thread subsystem.
The format of the PQO display follows. The fields are left-justified and blank-filled, except for nn, the user number, which is right-justified, blank-filled, and in a field of two digits for numbers 0 through 99 or of as many digits necessary for larger numbers. bb is two blanks.
USER nn useridbbtermidbbfile1bbfile2...bb [CLNT:bbmmmmmbbONbbclntname] [APSY: apsyname]
where:
| Term | Thread | Meaning |
|---|---|---|
|
nn |
Client |
User thread number |
|
Service |
User thread number of the service thread | |
|
userid |
Client |
User login ID |
|
Service |
Client user's login ID | |
|
termid |
Client |
User terminal ID or z/VM machine name |
|
Service |
Client's node name as specified on local DEFINE PROCESSGROUP command REMOTEID parameter | |
|
file1, file2,... |
Client |
Names of any open local files, and Names of open remote files, using the full remote file specification (filename AT location) |
|
Service |
Names of any open local files | |
|
mmmmm |
Service |
User number of the client thread currently using the service thread |
|
clntname |
Service |
Client User 0 LOCATION parameter value |
|
apsyname |
Service |
Name of the subsystem into which service thread is logged, if any |
In addition to the list of regular user IDs, LOGWHO prints a list of terminal lines that have encountered severe I/O errors and have been shut down (dead users). Also printed is a list of users to be reactivated (hardwired terminals that have been temporarily shut down because of I/O errors and that can be reactivated with the REACTIVATE command).
To execute the LOGWHO command, reply STATUS to the outstanding HALT message.
Sending LOGWHO output to the USE data set
If there is an open USE data set, the LOGWHO command output is directed to it. See RESET COMMAND: Control USE data set support for a discussion of how to direct the output.