WUSE - list who's on the system and what they're doing.

Syntax:

wuse [userid]* [#lineid]* [key=keyword]* [+c] [+b] [-h]
             keys: k=nn   -- core
                   f=flag -- ust flag
                   s=subs -- subsystem name
                   c=nn   -- callss stack level
                   l=nnnn -- line id

Examples:

wuse
wuse user1 f=mwt s=cmdu
wuse #2020 user1 s=mast
wuse ebelldon fbaggins +c

Description:

WUSE provides information about the status of TSS users. Specifically, the users are listed by userid with their line-id, the name of their current subsystem (and optionally the contents of their callss stack), the number of minutes since the user signed on, the number of seconds of CPU used since sign-on, the current memory size being used, and the status flags set in the User Status Table (UST).

If options are given, WUSE will only display a user who satisfies all the options ANDed together. For instance, "wuse k=38 f=mwt" will show only those users whose programs are running at 38k and whose mail waiting bit is set on.

Options:

Userid
lists only users signed on to the userid given.
#Lineid
 
L=Lineid
lists only the user signed on to the given line.
k=N
lists users with a current core size of Nk (where N is some decimal integer). For example, "wuse user1 k=13" will list users signed on to userid user1 who are currently 13k in size.
f=flag
lists users with the given UST flags set (flags and explanations thereof are explained below). For example, "wuse f=mwt" will list users who have the mail waiting flag on.
s=subsys
lists the people using the given subsystem. For example, "wuse s=fred" will list users who are currently in the FRED subsystem.
c=N
lists the callss stack to a maximum depth of N. Values larger than five are meaningless. "c=N" automatically sets the "+c" option.
+C
will cause the listed user's entire callss stack to printed.
+B
prints the privilege flags also.
+/-H
may be used to force the heading line to be printed or suppressed.

Notes:

Any of the keyword options may be repeated to achieve the desired effect, e.g. "wuse f=mwt f=fsy" will list users in file system activity with the mail waiting flag on.

The output is in the format:

 UST USERID      CHNL  SUBSYS ONLINE CPU TIME SIZE   STATUS FLAGS
 NN  uuuuuu      llll  sbsy(D) HH:mm HH:MM:SS ##k    flags

where:

NN     position in UST chain
uuuuuu userid
llll   GRTS station code (octal) or the job id of
       a deferred user
sbsy   subsystem in execution
d      depth in program stack
hh:mm  online time (hours, minutes)
mm:ss  CPU time (minutes, seconds)
##k    memory usage in K words
flags  status flags

A little more explanation of the line id field is needed. If the user is a regular TSS user, then the GRTS station code is given as 4 octal digits. If the user is disconnected, and his original line id has been reused, then his original line id is displayed as 4 digits followed by "*". The "true" line id for such a user is 7777. If the user is a deferred user (drun), then instead of the line id the drunid is displayed as 4 digits followed by "d". The "true" line id for deferred users is 2020. When the "L=" or "#" option is used to select a particular line id, the "true" line id is used.

Valid status flags are:

dio - user roadblocked for disc I/O (.lflag,19)
swo - user being swapped out (.lflag,21)
cor - user in core (.lflag,22)
swi - user being swapped in  (.lflag,23)
tsk - user has non-TSS process executing (.lflag,25)
ids - an ids user (.lflg2,16)
dac - line switched to batch job (.lflg2,21)
hex - hex capability enabled (.lflg2,22)
ppt - paper tape input in progress (.lflg2,32)
mon - user being monitored by master user (.lflg2,33)
      (this will never appear, so you will never know)
hld - user in hold (.lswth,11)
wak - user asleep (.ldrl lower == 066)
fsy - user in file system activity
lti - time waiting for terminal input (if any)
bld - user in build mode
mwt - user has **mail waiting message pending
apb - user hasn't seen the broadcast message yet
spc - user has a special message from operator pending
ded - user is either dedicated (waiting for a DRL
      TASK to come back from batch, or dead.
dis - user has disconnected -- UST will be terminated
      after time shown expires
prt - a line is to be printed when the user uses
      CONNECT to reconnect
crn - user is in command file mode
brk - user hit break but no action has been taken yet
      (may mean entry is dead in logon)

The following five flags are only given if the "+b" option is specified. They may also be used for the "f=flag" option.

lds - user has LODS privilege
tlk - user has TALK privilege
crd - user has CARDIN privilege
ldx - user has LODX privilege
mas - user is master user

Copyright © 1996, Thinkage Ltd.