LOGWHO command

From m204wiki
Jump to navigation Jump to search

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, zero-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.