LOGWHO command

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.