Trailing-Edge
-
PDP-10 Archives
-
bb-x130a-sb
-
who.man
There are 4 other files named who.man in the archive. Click here to see a list.
WHO MANUAL
Reflects version 4(155)
March 1982
William S. Meier
Digital Equipment Corporation
Internal Software Support Group
Table of contents for WHO.MAN
CHAPTER 1 COMMAND FORMAT
1.1 SPECIFICATIONS . . . . . . . . . . . . . . . . . . 1-1
1.2 LOGICAL OPERATORS . . . . . . . . . . . . . . . . 1-1
CHAPTER 2 JOB MODE
2.1 SELECTION SWITCHES . . . . . . . . . . . . . . . . 2-1
2.1.1 /ACCOUNT:"string" . . . . . . . . . . . . . . . 2-1
2.1.2 /ACTIVE and /NOACTIVE . . . . . . . . . . . . . 2-1
2.1.3 /AUTODIALER and /NOAUTODIALER . . . . . . . . . 2-1
2.1.4 /BADGE:nn . . . . . . . . . . . . . . . . . . . 2-1
2.1.5 /BATCH and /NOBATCH . . . . . . . . . . . . . . 2-2
2.1.6 /BBATCH and /NOBBATCH . . . . . . . . . . . . . 2-2
2.1.7 /BEFORE:date:time . . . . . . . . . . . . . . . 2-2
2.1.8 /CAPABILITY:(key,key) . . . . . . . . . . . . . 2-2
2.1.9 /CATEGORY:oo . . . . . . . . . . . . . . . . . . 2-3
2.1.10 /CHARGE:ss . . . . . . . . . . . . . . . . . . . 2-3
2.1.11 /CID:ss . . . . . . . . . . . . . . . . . . . . 2-3
2.1.12 /CLASS:nn . . . . . . . . . . . . . . . . . . . 2-3
2.1.13 /CORE:nn:mm . . . . . . . . . . . . . . . . . . 2-3
2.1.14 /CTLJOB:nn . . . . . . . . . . . . . . . . . . . 2-3
2.1.15 /CTLPRG:ss . . . . . . . . . . . . . . . . . . . 2-3
2.1.16 /CTY or /NOCTY . . . . . . . . . . . . . . . . . 2-4
2.1.17 /DIALUP and /NODIALUP . . . . . . . . . . . . . 2-4
2.1.18 /DDB:filespec . . . . . . . . . . . . . . . . . 2-4
2.1.19 /DDT or /NODDT . . . . . . . . . . . . . . . . . 2-4
2.1.20 /DETACH or /DETACH:oo or /NODETACH . . . . . . . 2-4
2.1.21 /DEVICE:ss . . . . . . . . . . . . . . . . . . . 2-4
2.1.22 /DSKPRIORITY:n or /DSKPRIORITY . . . . . . . . . 2-4
2.1.23 /FILE:filespec . . . . . . . . . . . . . . . . . 2-5
2.1.24 /GANDALF and /NOGANDALF . . . . . . . . . . . . 2-5
2.1.25 /GLXOPR:key or /GLXOPR . . . . . . . . . . . . . 2-5
2.1.26 /HARDWIRED and /NOHARDWIRED . . . . . . . . . . 2-5
2.1.27 /HPQ:n or /HPQ . . . . . . . . . . . . . . . . . 2-5
2.1.28 /JOB:n . . . . . . . . . . . . . . . . . . . . . 2-5
2.1.29 /JSTATUS:(key,key) . . . . . . . . . . . . . . . 2-6
2.1.30 /LOCAL and /NOLOCAL . . . . . . . . . . . . . . 2-6
2.1.31 /LOCATE:oo or /LOCATE . . . . . . . . . . . . . 2-6
2.1.32 /LPPN:[p,pn] . . . . . . . . . . . . . . . . . . 2-6
2.1.33 /MOUNT:ss . . . . . . . . . . . . . . . . . . . 2-7
2.1.34 /NAME:"ss" . . . . . . . . . . . . . . . . . . . 2-7
2.1.35 /NODE:ssll or /NODE:ss . . . . . . . . . . . . 2-7
2.1.36 /NOOPERATOR . . . . . . . . . . . . . . . . . . 2-7
2.1.37 /OPERATOR:key . . . . . . . . . . . . . . . . . 2-7
2.1.38 /PFH or /NOPFH . . . . . . . . . . . . . . . . . 2-7
2.1.39 /PIVOTED and /NOPIVOTED . . . . . . . . . . . . 2-8
2.1.40 /PPN:[p,pn] . . . . . . . . . . . . . . . . . . 2-8
2.1.41 /PRIVILEGE:(key,key) . . . . . . . . . . . . . . 2-8
2.1.42 /PRGRUN:ss . . . . . . . . . . . . . . . . . . . 2-8
Page ii
2.1.43 /PROGRAM:ss . . . . . . . . . . . . . . . . . . 2-9
2.1.44 /PTY:oo or /PTY or /NOPTY . . . . . . . . . . . 2-9
2.1.45 /RBEFORE:date:time . . . . . . . . . . . . . . . 2-9
2.1.46 /REMOTE and /NOREMOTE . . . . . . . . . . . . . 2-9
2.1.47 /RSINCE:date:time . . . . . . . . . . . . . . . 2-9
2.1.48 /SEGMENT:ss . . . . . . . . . . . . . . . . . . 2-9
2.1.49 /SELF and /NOSELF . . . . . . . . . . . . . . . 2-9
2.1.50 /SINCE:date:time . . . . . . . . . . . . . . . 2-10
2.1.51 /SLOT:nn . . . . . . . . . . . . . . . . . . . 2-10
2.1.52 /STATE:(key,key) . . . . . . . . . . . . . . . 2-10
2.1.53 /STREAM:n . . . . . . . . . . . . . . . . . . 2-10
2.1.54 /SWAP:key . . . . . . . . . . . . . . . . . . 2-10
2.1.55 /TSN and /NOTSN . . . . . . . . . . . . . . . 2-11
2.1.56 /TTY:oo or /TTY or /NOTTY . . . . . . . . . . 2-11
2.1.57 /VCORE:nn:mm . . . . . . . . . . . . . . . . . 2-11
2.1.58 /VM and /NOVM . . . . . . . . . . . . . . . . 2-11
2.1.59 /WHEELED and /NOWHEELED . . . . . . . . . . . 2-11
2.1.60 /WSCODE:ss . . . . . . . . . . . . . . . . . . 2-11
2.1.61 /WTO:key or /WTO . . . . . . . . . . . . . . . 2-12
2.2 TYPEOUT SWITCHES . . . . . . . . . . . . . . . . 2-12
2.2.1 /DDBS . . . . . . . . . . . . . . . . . . . . 2-12
2.2.2 /DPY:n:m . . . . . . . . . . . . . . . . . . . 2-12
2.2.3 /ERNONE . . . . . . . . . . . . . . . . . . . 2-12
2.2.4 /FAST . . . . . . . . . . . . . . . . . . . . 2-13
2.2.5 /FILES . . . . . . . . . . . . . . . . . . . . 2-13
2.2.6 /FORMAT:(format-list) . . . . . . . . . . . . 2-13
2.2.7 /INCLUDE:key . . . . . . . . . . . . . . . . . 2-13
2.2.8 /INCREMENTAL and /NOINCREMENTAL . . . . . . . 2-13
2.2.9 /INFORMATION:keys . . . . . . . . . . . . . . 2-14
2.2.10 /MAP . . . . . . . . . . . . . . . . . . . . . 2-14
2.2.11 /NORMAL . . . . . . . . . . . . . . . . . . . 2-14
2.2.12 /OKNONE . . . . . . . . . . . . . . . . . . . 2-15
2.2.13 /ORIGIN and /NOORIGIN . . . . . . . . . . . . 2-15
2.2.14 /PERFORMANCE and /NOPERFORMANCE . . . . . . . 2-15
2.2.15 /PRINT and /NOPRINT . . . . . . . . . . . . . 2-15
2.2.16 /REPEAT:N:M . . . . . . . . . . . . . . . . . 2-15
2.2.17 /SLOW . . . . . . . . . . . . . . . . . . . . 2-16
2.2.18 /SORT:key:x:n or /SORT:key . . . . . . . . . . 2-16
2.2.19 /STAMP and /NOSTAMP . . . . . . . . . . . . . 2-17
2.2.20 /SUMMARY:key . . . . . . . . . . . . . . . . . 2-18
2.2.21 /TOTALS and /NOTOTALS . . . . . . . . . . . . 2-19
2.2.22 /VFAST . . . . . . . . . . . . . . . . . . . . 2-19
CHAPTER 3 LINE MODE
3.1 SELECTION SWITCHES . . . . . . . . . . . . . . . . 3-1
3.1.1 /AUTODIALER and /NOAUTODIALER . . . . . . . . . 3-1
3.1.2 /ASSIGN and /NOASSIGN . . . . . . . . . . . . . 3-1
3.1.3 /CARRIER and /NOCARRIER . . . . . . . . . . . . 3-1
3.1.4 /CTY or /NOCTY . . . . . . . . . . . . . . . . . 3-1
3.1.5 /DIALUP and /NODIALUP . . . . . . . . . . . . . 3-2
3.1.6 /GANDALF and /NOGANDALF . . . . . . . . . . . . 3-2
3.1.7 /HARDWIRED and /NOHARDWIRED . . . . . . . . . . 3-2
3.1.8 /INITED and /NOINITED . . . . . . . . . . . . . 3-2
Page iii
3.1.9 /JOB:n . . . . . . . . . . . . . . . . . . . . . 3-2
3.1.10 /LOCAL and /NOLOCAL . . . . . . . . . . . . . . 3-2
3.1.11 /LOCATE:"string" . . . . . . . . . . . . . . . . 3-2
3.1.12 /MIC and /NOMIC . . . . . . . . . . . . . . . . 3-3
3.1.13 /NODE:ssll or /NODE:ss . . . . . . . . . . . . 3-3
3.1.14 /PHONE:"aa" . . . . . . . . . . . . . . . . . . 3-3
3.1.15 /PTY:oo or /PTY or /NOPTY . . . . . . . . . . . 3-3
3.1.16 /RCVSPEED:n . . . . . . . . . . . . . . . . . . 3-3
3.1.17 /REMOTE AND /NOREMOTE . . . . . . . . . . . . . 3-3
3.1.18 /SLAVE and /NOSLAVE . . . . . . . . . . . . . . 3-4
3.1.19 /SPEED:n . . . . . . . . . . . . . . . . . . . . 3-4
3.1.20 /TSN and /NOTSN . . . . . . . . . . . . . . . . 3-4
3.1.21 /TTY:oo or /TTY or /NOTTY . . . . . . . . . . . 3-4
3.1.22 /TYPE:ss . . . . . . . . . . . . . . . . . . . . 3-4
3.1.23 /USER and /NOUSER . . . . . . . . . . . . . . . 3-4
3.1.24 /XMTSPEED:n . . . . . . . . . . . . . . . . . . 3-4
3.2 TYPEOUT SWITCHES . . . . . . . . . . . . . . . . . 3-5
3.2.1 /DPY:n:m . . . . . . . . . . . . . . . . . . . . 3-5
3.2.2 /ERNONE . . . . . . . . . . . . . . . . . . . . 3-5
3.2.3 /FAST . . . . . . . . . . . . . . . . . . . . . 3-5
3.2.4 /INCLUDE:key . . . . . . . . . . . . . . . . . . 3-5
3.2.5 /INCREMENTAL and /NOINCREMENTAL . . . . . . . . 3-5
3.2.6 /INFORMATION:keys . . . . . . . . . . . . . . . 3-6
3.2.7 /MAP . . . . . . . . . . . . . . . . . . . . . . 3-6
3.2.8 /NORMAL . . . . . . . . . . . . . . . . . . . . 3-6
3.2.9 /OKNONE . . . . . . . . . . . . . . . . . . . . 3-6
3.2.10 /PERFORMANCE and /NOPERFORMANCE . . . . . . . . 3-6
3.2.11 /PRINT and /NOPRINT . . . . . . . . . . . . . . 3-7
3.2.12 /REPEAT:N:M . . . . . . . . . . . . . . . . . . 3-7
3.2.13 /SLOW . . . . . . . . . . . . . . . . . . . . . 3-7
3.2.14 /SORT:key:x:n or /SORT:key . . . . . . . . . . . 3-7
3.2.15 /STAMP and /NOSTAMP . . . . . . . . . . . . . . 3-8
3.2.16 /SUMMARY:key . . . . . . . . . . . . . . . . . . 3-8
3.2.17 /TOTALS and /NOTOTALS . . . . . . . . . . . . . 3-9
3.2.18 /VFAST . . . . . . . . . . . . . . . . . . . . . 3-9
CHAPTER 4 FORMATTING THE DISPLAY
4.1 FORMAT LIST . . . . . . . . . . . . . . . . . . . 4-1
4.2 FORMAT LIST SWITCHES . . . . . . . . . . . . . . . 4-1
4.2.1 /FINAL:(format-list) . . . . . . . . . . . . . . 4-1
4.2.2 /FOOTING:(format-list) . . . . . . . . . . . . . 4-2
4.2.3 /HEADING:(format-list) . . . . . . . . . . . . . 4-2
4.2.4 /INITIAL:(format-list) . . . . . . . . . . . . . 4-2
4.2.5 /FORMAT:(format-list) . . . . . . . . . . . . . 4-2
4.3 DEFAULT FORMAT CONTROL . . . . . . . . . . . . . . 4-2
4.3.1 /BLANK . . . . . . . . . . . . . . . . . . . . . 4-3
4.3.2 /DEFAULT . . . . . . . . . . . . . . . . . . . . 4-3
4.3.3 /FIX . . . . . . . . . . . . . . . . . . . . . . 4-3
4.3.4 /FLOAT . . . . . . . . . . . . . . . . . . . . . 4-3
Page iv
CHAPTER 5 ACTION SWITCHES
5.1 INPUT/OUTPUT FUNCTIONS . . . . . . . . . . . . . . 5-1
5.1.1 /FORCE:command . . . . . . . . . . . . . . . . . 5-1
5.1.2 /INPUT:"string" . . . . . . . . . . . . . . . . 5-2
5.1.3 /OUTPUT:"string" . . . . . . . . . . . . . . . . 5-2
5.1.4 /SEND:"string" . . . . . . . . . . . . . . . . . 5-2
5.2 NETWORK FUNCTIONS . . . . . . . . . . . . . . . . 5-2
5.2.1 /NETWORK:CONNECT . . . . . . . . . . . . . . . . 5-2
5.2.2 /NETWORK:DISCONNECT . . . . . . . . . . . . . . 5-2
5.3 SETUUO FUNCTIONS . . . . . . . . . . . . . . . . . 5-2
5.3.1 CPU:n . . . . . . . . . . . . . . . . . . . . . 5-3
5.3.2 DEFAULT:BUFFERS:n . . . . . . . . . . . . . . . 5-3
5.3.3 DEFAULT:PROTECTION:n . . . . . . . . . . . . . . 5-3
5.3.4 DEFER:key . . . . . . . . . . . . . . . . . . . 5-3
5.3.5 DSKFUL:key . . . . . . . . . . . . . . . . . . . 5-3
5.3.6 LIMIT:hh:mm:ss . . . . . . . . . . . . . . . . . 5-3
5.3.7 PHYSICAL:key:n . . . . . . . . . . . . . . . . . 5-3
5.3.8 TIME:hh:mm:ss . . . . . . . . . . . . . . . . . 5-4
5.3.9 VIRTUAL:n . . . . . . . . . . . . . . . . . . . 5-4
5.3.10 WATCH:(keys) . . . . . . . . . . . . . . . . . . 5-4
CHAPTER 6 OUTPUT FILE CONTROL
6.1 FILE SPECIFICATION DEFAULTS . . . . . . . . . . . 6-1
6.2 SWITCHES . . . . . . . . . . . . . . . . . . . . . 6-1
6.2.1 /APPEND and /NOAPPEND . . . . . . . . . . . . . 6-1
6.2.2 /ERSUPERSEDE . . . . . . . . . . . . . . . . . . 6-1
6.2.3 /OKSUPERSEDE . . . . . . . . . . . . . . . . . . 6-1
6.2.4 /PROTECTION:n . . . . . . . . . . . . . . . . . 6-2
6.2.5 /VERSION:x . . . . . . . . . . . . . . . . . . . 6-2
APPENDIX A JOB STATE CODES
APPENDIX B INFORMATION DISPLAYS
B.1 ACCOUNT . . . . . . . . . . . . . . . . . . . . . B-1
B.2 BATCH . . . . . . . . . . . . . . . . . . . . . . B-1
B.3 CAPABILITIES . . . . . . . . . . . . . . . . . . . B-1
B.4 CHANNEL . . . . . . . . . . . . . . . . . . . . . B-2
B.5 CORE . . . . . . . . . . . . . . . . . . . . . . . B-2
B.6 DDBS . . . . . . . . . . . . . . . . . . . . . . . B-2
B.6.1 DSK DDB information . . . . . . . . . . . . . . B-3
B.6.2 MTA DDB information . . . . . . . . . . . . . . B-3
B.6.3 NET DDB information . . . . . . . . . . . . . . B-3
B.6.4 TSK DDB information . . . . . . . . . . . . . . B-3
B.6.5 TTY DDB information . . . . . . . . . . . . . . B-4
B.7 DEFAULTS . . . . . . . . . . . . . . . . . . . . . B-4
B.8 IPCF . . . . . . . . . . . . . . . . . . . . . . . B-4
B.9 JSL . . . . . . . . . . . . . . . . . . . . . . . B-4
B.10 LOGICAL . . . . . . . . . . . . . . . . . . . . . B-5
B.11 MTA . . . . . . . . . . . . . . . . . . . . . . . B-5
Page v
B.12 ORIGIN . . . . . . . . . . . . . . . . . . . . . . B-5
B.13 PATH . . . . . . . . . . . . . . . . . . . . . . . B-6
B.14 PRIVILEGES . . . . . . . . . . . . . . . . . . . . B-6
B.15 SIZE . . . . . . . . . . . . . . . . . . . . . . . B-6
B.16 SPOOL . . . . . . . . . . . . . . . . . . . . . . B-6
B.17 TIME . . . . . . . . . . . . . . . . . . . . . . . B-7
B.18 TMPCOR . . . . . . . . . . . . . . . . . . . . . . B-7
CHAPTER 1
COMMAND FORMAT
.WHO file=spec !(default JOB mode)
.WHO:LINE file=spec !(LINE mode)
.WHO:JOB file=spec !(JOB mode)
A mode can also be selected by the use of the /MODE switch which takes arguments
WHO, JOB, or LINE. JOB mode primarily selects jobs, and lists attributes about
them, such as users PPN, name, program, runtime, etc. LINE mode primarily
selects lines, and lists attributes about them, such as node, line, speed and
terminal type.
1.1 SPECIFICATIONS
SPEC is a list of commands, each separated by commas, optionally followed by a
list of switches.
FILE is a standard file specification, to be used as the output specification.
The default is TTY:WHO.LST[-].
The following specifications have the following switch equivalents:
Command Switch Function
n /JOB:n Select job n
#n /TTY:n Select job on TTYn
[p,pn] /PPN:[p,pn] Select all ppns that match wildcarding
mmmm /NAME:mmmm Select jobs with user name MMMM
dev: /DEVICE:dev Select jobs using DEV:
1.2 LOGICAL OPERATORS
The following SCAN logical operators can be used by WHO to control the selection
of objects.
'OR' Select thing if matches spec A 'OR' spec B
'AND' Select thing if matches spec A 'AND' spec B
'NOT' Select thing if matches spec A 'NOT' spec B
CHAPTER 2
JOB MODE
2.1 SELECTION SWITCHES
The following switches can be included on the command line to select different
classes of jobs. None of these switches are global, they apply only to the
current specification. Multiple specifications are separated by commas.
2.1.1 /ACCOUNT:"string"
This switch selects jobs with the specified account string. The account string
can be up to 39 characters, optionally containing wildcards (? and *). If the
account string contains blanks or other non-alpha numeric characters, it must be
inclosed in quotations. The syntax /ACCOUNT:"" selects jobs with the null
account string.
2.1.2 /ACTIVE and /NOACTIVE
This switch selects active jobs. An active job is defined as currently using
system resources or the CPU, as opposed to waiting for terminal input, or
sleeping or hibernating. /NOACTIVE selects jobs which are not active.
2.1.3 /AUTODIALER and /NOAUTODIALER
This switch selects jobs that are on an autodialer line. /NOAUTODIALER selects
jobs that are not on autodialer lines.
2.1.4 /BADGE:nn
This switch selects jobs that are logged in with the DEC badge number nn.
JOB MODE Page 2-2
SELECTION SWITCHES
2.1.5 /BATCH and /NOBATCH
This switch selects batch jobs running under BATCON, or MIC. /NOBATCH selects
jobs that are not batch jobs.
2.1.6 /BBATCH and /NOBBATCH
This switch selects jobs that are running in the background batch scheduler
class (if one has been defined). This does not imply nor select batch jobs
implicitly. /NOBBATCH selects jobs that are not running in the background batch
scheduler class.
2.1.7 /BEFORE:date:time
This switch selects jobs that have logged in before the specified date and time.
Date and time can be any one of the standard formats.
2.1.8 /CAPABILITY:(key,key)
This switch selects jobs with the specified capability bits. Multiple
capability bits can be specified by including a list of keys inclosed in
parentheses, and separated by commas. An optional NO can precedes any
capability bit to mean not the specified capability. For example
/CAPABILITY:(POKE,NORTTRP) selects jobs who have POKE capability and do not have
RTTRP capability. A complete list of the CAPABILITY keys follows:
CHGPPN Change PPN (projects .GT. 10) privilege
CPU Ability to change CPU specifications
DISK Ability to set disk priority greater than 0
ENQ Ability to do privileged ENQ/DEQ functions
HPQ Ability to set high priority queue greater than 0
IPCF Ability to do IPCF privileged functions
LOCK Ability to LOCK in core
METER Ability to use METER UUO
NETEXAM Ability to do network examines (for NTRACK)
POKE Ability to use POKE UUO
RTTRP Ability to use RTTRP UUO
SPYALL Ability to SPY on all of core
SPYMON Ability to SPY on monitor low segment
TRPSET Ability to use TRPSET UUO
UNSPOOL Ability to unspool spooled devices
JOB MODE Page 2-3
SELECTION SWITCHES
2.1.9 /CATEGORY:oo
This switch selects jobs that are in job category oo. OO is an octal category
from 0 to 777.
2.1.10 /CHARGE:ss
This switch selects jobs that are logged in with the specified charge number ss.
SS is a sixbit word with optional ? and * wildcarding.
2.1.11 /CID:ss
This switch selects jobs that are logged in with the specified charge ID ss. SS
is a sixbit word with optional ? and * wildcarding.
2.1.12 /CLASS:nn
This switch selects jobs that are in scheduler class nn. NN is a decimal number
from 0 to 31.
2.1.13 /CORE:nn:mm
This switch selects jobs whose core size (sum of the low and high segments in
pages) is in the range specified by nn and mm. NN and MM are decimal numbers
from 0 to 511. If :mm is omitted (eg /CORE:nn), jobs whose core size is nn or
larger are selected. If nn is omitted, and mm is specified (eg /CORE::mm) jobs
whose core size is less than or equal to mm are selected.
2.1.14 /CTLJOB:nn
This switch selects jobs who are being controlled by job number nn. NN is a
decimal number. Typically, these are jobs on a PTY controlled by BATCON, MIC,
or OPSER.
2.1.15 /CTLPRG:ss
This switch selects jobs who are being controlled by program ss. SS is a sixbit
word with optional ? and * wildcarding. Typically, these are jobs on a PTY
controlled by BATCON, MIC, or OPSER.
JOB MODE Page 2-4
SELECTION SWITCHES
2.1.16 /CTY or /NOCTY
This switch selects the job (if any) on the CTY, the console terminal. /NOCTY
selects jobs that are not on the CTY (ie jobs on PTYs, TTYs, and detached).
2.1.17 /DIALUP and /NODIALUP
This switch selects jobs that are on dialup terminals. /NODIALUP selects jobs
that are not on dialup terminals.
2.1.18 /DDB:filespec
This switch selects jobs that have a DDB (device data block) for the specified
file specification. The file specification can include device, file, extension,
and PPN. File, extension, and PPN can be optionally wildcarded with ? and *
characters. If any part of the specification is omitted, it is considered to
match. If the device name is exactly three characters long, it will match any
device starting with those three characters.
2.1.19 /DDT or /NODDT
This switch selects jobs that have DDT in their address space (.JBDDT non-zero).
/NODDT selects jobs that do not have DDT in their address space.
2.1.20 /DETACH or /DETACH:oo or /NODETACH
This switch selects jobs that are detached, ie not attached to any controlling
terminal. If oo is specified, jobs who detached from terminal line oo are
selected. /NODETACH selects jobs that are not detached (ie jobs on PTYs, TTYs,
and CTY).
2.1.21 /DEVICE:ss
This switch selects the job (if any) that has device ss assigned or inited
(opened).
2.1.22 /DSKPRIORITY:n or /DSKPRIORITY
This switch selects jobs with disk priority n. N is a decimal number from -3 to
3. If :n is omitted any job with a disk priority greater than 0 is selected.
JOB MODE Page 2-5
SELECTION SWITCHES
2.1.23 /FILE:filespec
This switch selects jobs that have a DDB (device data block) for the specified
file specification. The file specification can include device, file, extension,
and PPN. File, extension, and PPN can be optionally wildcarded with ? and *
characters. If any part of the specification is omitted, it is considered to
match. If the device name is exactly three characters long, it will match any
device starting with those three characters.
2.1.24 /GANDALF and /NOGANDALF
This switch selects jobs that are on gandalf switched lines. /NOGANDALF selects
jobs that are not on gandalf switched lines.
2.1.25 /GLXOPR:key or /GLXOPR
This switch selects jobs that have Galaxy operator privileges. Legal keys can
be one of:
HOST Host operator privileges
NONE No operator privileges
REMOTE Remote operator privileges
SYSTEM System operator privileges
If no keyword is present, all jobs with any operator privileges are selected.
2.1.26 /HARDWIRED and /NOHARDWIRED
This switch selects jobs that are on hardwired lines. /NOHARDWIRED selects jobs
that are not on hardwired lines.
2.1.27 /HPQ:n or /HPQ
This switch selects jobs running in high priority queue n. N is a decimal
number from 0 to 15. If :n is omitted any job in a high priority queue greater
than 0 is selected.
2.1.28 /JOB:n
This switch selects job n. N is a decimal number greater than 0.
JOB MODE Page 2-6
SELECTION SWITCHES
2.1.29 /JSTATUS:(key,key)
This switch selects jobs with the specified job status attributes. Multiple job
status attributes can be specified by including a list of keys inclosed in
parentheses, and separated by commas. An optional NO can precedes any attribute
to mean not the specified attribute. For example /JSTATUS:(JACCT,NOXONLY)
selects jobs who are JACCTed and that are not execute only. A complete list of
the job status attributes follows:
CMDWAIT Jobs waiting to have a command processed
DCORE Jobs doing a DCORE command
DSKFUL Jobs with DSKFUL PAUSE set
JACCT Jobs with JACCT set
LOCK Jobs locked in core
MONERR Jobs with a monitor detected error
OPRWAIT Jobs waiting for operator action
RUN Jobs with the run bit set
SWAP Jobs swapped out
XONLY Jobs that are execute only
2.1.30 /LOCAL and /NOLOCAL
This switch selects jobs running on local terminals. Local terminals implies
the "TTY NO REMOTE" setting rather than non-network terminals. /NOLOCAL selects
jobs not running on local terminals (eg remote terminals).
2.1.31 /LOCATE:oo or /LOCATE
This switch selects jobs who are logically located to node oo. OO is an octal
number from 0 to 77. The special case of 0 selects jobs who are located to the
central site, and if :oo is omitted, jobs who are logically located to where
their terminal is physically connected to are selected.
2.1.32 /LPPN:[p,pn]
This switch selects jobs with the specified logged-in PPN. The logged-in PPN is
the PPN the job logged in under, and remains the same if the job WHEELs or
PIVOTs into another PPN. PPN may be wildcarded with ? and * characters. The
constructions [,pn], [p,], and [,] can be also be used. However, [-] is
illegal.
JOB MODE Page 2-7
SELECTION SWITCHES
2.1.33 /MOUNT:ss
This switch selects jobs with file structure ss mounted (eg in their search
list). SS must be a legal structure name. This does not imply that these jobs
have open files on the structure (see /FILE or /DDB for that function).
2.1.34 /NAME:"ss"
This switch selects jobs logged in in the specified name ss. If ss contains n
characters, the jobs with user names who start with the first n characters of
the users switch are selected. Blanks are treated as matching any character,
and if ss contains blanks or more than 6 characters it must be inclosed in
quotations.
2.1.35 /NODE:ss_ll or /NODE:ss
This switch selects jobs whose terminals are physically connected to the
specified node ss and line ll. ss is a node name with optional ? and *
wildcarding, and ll is an octal line number. If only a node name is specified
any jobs whose terminals are physically connected to node ss are selected
regardless of their line number.
2.1.36 /NOOPERATOR
This switch selects jobs which are not operator jobs. Operator jobs are defined
as jobs with PPN [1,2] or [1nn,2] where nn is the node number for the remote
operator.
2.1.37 /OPERATOR:key
This switch selects jobs as specified by the key. KEY may be one of
LOCAL to select only [1,2] operator jobs
NO to select jobs that are neither local or remote operators
REMOTE to select only [1nn,2] operator jobs
YES to select either local or remote operator jobs
2.1.38 /PFH or /NOPFH
This switch selects jobs that have a page fault handler in their address space
(.JBPFH non zero). /NOPFH selects jobs that do not have page fault handler in
their address space.
JOB MODE Page 2-8
SELECTION SWITCHES
2.1.39 /PIVOTED and /NOPIVOTED
This switch selects jobs that are pivoted into another PPN. PIVOTed is defined
as the logged in PPN not equal to the current PPN. /NOPIVOTED selects jobs that
are not pivoted.
2.1.40 /PPN:[p,pn]
This switch selects jobs with the specified PPN. PPN may be wildcarded with ?
and * characters. The constructions [,pn], [p,], and [,] can be also be used.
However, [-] is illegal.
2.1.41 /PRIVILEGE:(key,key)
This switch selects jobs with the specified privilege bits. Multiple privilege
bits can be specified by including a list of keys inclosed in parentheses, and
separated by commas. An optional NO can precedes any privilege bit to mean not
the specified privilege. For example /PRIVILEGE:(POKE,NORTTRP) selects jobs who
have POKE privileges and do not have RTTRP privileges. A complete list of the
privilege keys follows:
CHGPPN Change PPN (projects .GT. 10) privilege
CPU Ability to change CPU specifications
DISK Ability to set disk priority greater than 0
ENQ Ability to do privileged ENQ/DEQ functions
HPQ Ability to set high priority queue greater than 0
IPCF Ability to do IPCF privileged functions
LOCK Ability to LOCK in core
METER Ability to use METER UUO
NETEXAM Ability to do network examines (for NTRACK)
POKE Ability to use POKE UUO
RTTRP Ability to use RTTRP UUO
SPYALL Ability to SPY on all of core
SPYMON Ability to SPY on monitor low segment
TRPSET Ability to use TRPSET UUO
UNSPOOL Ability to unspool spooled devices
2.1.42 /PRGRUN:ss
This switch selects jobs with program to run set to be ss. SS is a sixbit word
with optional ? and * wildcarding.
JOB MODE Page 2-9
SELECTION SWITCHES
2.1.43 /PROGRAM:ss
This switch selects jobs whose program name is ss. SS is a sixbit name with
optional ? and * wildcarding.
2.1.44 /PTY:oo or /PTY or /NOPTY
This switch selects the job (if any) running on pseudo-terminal (PTY) line oo.
OO is an octal terminal number from 0 to the number of legal PTYs minus 1. If
:oo is omitted, jobs running on any PTY are selected. /NOPTY selects jobs that
are not on a PTY ie jobs on TTYs, CTY and detached).
2.1.45 /RBEFORE:date:time
This switch selects jobs that have done a RESET UUO before the specified date
and time. Typically programs do a RESET as soon as they are started. Date and
time can be in any of the standard formats.
2.1.46 /REMOTE and /NOREMOTE
This switch selects jobs running on remote terminals. Remote terminals implies
the "TTY REMOTE" setting rather than network terminals. /NOREMOTE selects jobs
not running on remote terminals (eg local terminals).
2.1.47 /RSINCE:date:time
This switch selects jobs who have done a RESET UUO since the specified date and
time. Typically jobs do a RESET when they first start running. Date and time
can be in any of the standard formats.
2.1.48 /SEGMENT:ss
This switch selects jobs with high segment name ss. SS is a sixbit word with
optional ? and * wildcarding. The special names (OLD) for old/superseded high
segments, and (PRIV), for private non-sharable high segments can also be used.
2.1.49 /SELF and /NOSELF
This switch selects jobs who are logged in with the same PPN as the current job.
/NOSELF selects all jobs not logged in with the current jobs PPN.
JOB MODE Page 2-10
SELECTION SWITCHES
2.1.50 /SINCE:date:time
This switch selects jobs who have logged in since the specified date and time.
Date and time may be in any of the standard formats.
2.1.51 /SLOT:nn
This switch selects jobs with an output distribution slot number nn. NN is a
decimal number from 0 to 511.
2.1.52 /STATE:(key,key)
This switch selects jobs with the specified state classes. Multiple state
classes can be specified by including a list of keys inclosed in parentheses,
and separated by commas. An optional NO can precedes any state class to mean
not the specified state class. For example /STATE:(EVENTWAIT,NOSWAP) selects
jobs that are in an wait state and are not swapped out. A complete list of the
state class keys follows:
ACTIVE Select active (running, or otherwise active) jobs
CODES Selects jobs in state codes (see S.MAC)
EVENTWAIT Select jobs in one of the event wait states
IOWAIT Select jobs in an I/O wait state
LOCK Select jobs locked in core
QUEUES Selects jobs in queues (see S.MAC)
RWAITS Selects jobs in resource wait (see S.MAC)
RUN Select jobs in a processor run queue
SLEEP Select jobs hibernating, sleeping, or napping
STOP Select jobs that are stopped
SWAP Select jobs that are swapped out
2.1.53 /STREAM:n
This switch selects the job that is in batch stream number "n", where "n" is a
decimal number greater than or equal to zero. (Valid only under Galaxy version
4.1 and later)
2.1.54 /SWAP:key
This switch selects the job that the swapper is currently dealing with. KEY can
be one of the following:
FIT to select the job trying to be fit into core
FORCE to select the job trying to be forced out
IN to select the job currently being swapped in
OUT to select the job currently being swapped out
JOB MODE Page 2-11
SELECTION SWITCHES
2.1.55 /TSN and /NOTSN
This switch selects jobs on TSN controlled lines. /NOTSN selects jobs that are
not on TSN controlled lines.
2.1.56 /TTY:oo or /TTY or /NOTTY
This switch selects the job (if any) running on terminal (TTY) line oo. OO is
an octal terminal number from 0 to the number of legal terminals (including
PTYs) minus 1. If :oo is omitted, jobs running on any TTY (not CTY or PTY) are
selected. /NOTTY selects jobs that are not on TTYs (ie jobs on PTYS, CTY or
detached).
2.1.57 /VCORE:nn:mm
This switch selects jobs whose virtual core size (sum of the low and high
segments in pages) is in the range specified by nn and mm. NN and MM are
decimal numbers from 0 to 511. If :mm is omitted (eg /VCORE:nn), jobs whose
core size is nn or larger are selected. If nn is omitted, and mm is specified
(eg /VCORE::mm) jobs whose core size is less than or equal to mm are selected.
2.1.58 /VM and /NOVM
This switch selects jobs that are running virtual. Virtual is defined as any
job whose physical core core does not equal its virtual core size. /NOVM
selects jobs that are not virtual.
2.1.59 /WHEELED and /NOWHEELED
This switch selects jobs that are WHEELed into [1,2]. WHEELed is defined as the
logged in PPN not equal to [1,2], but with the current PPN equal to [1,2].
/NOWHEELED selects jobs that are not wheeled.
2.1.60 /WSCODE:ss
This switch selects jobs with wait state code ss. SS can be a two letter code
(TO, R2, HB, etc), or a quoted string such as "TO SW" which requires an exact
match for swapped out jobs in terminal output wait. For a complete list of wait
state codes see Appendix A.
JOB MODE Page 2-12
SELECTION SWITCHES
2.1.61 /WTO:key or /WTO
This switch selects jobs with the specified WTO (Write To Operator) privileges.
The legal keys are
ALL All privileges (WTO and WTOR)
NONE No WTO privileges
WTO Only WTO privileges
If no key is specified, jobs with any WTO or WTOR privileges are selected.
2.2 TYPEOUT SWITCHES
The following switches can be included on the command line to control the format
of the job mode output. In all cases, these switches are global, and can be
specified anywhere in the command line and have the same effect.
2.2.1 /DDBS
This switch displays the DDBs for the selected jobs. A DDB is a device data
block, and one exists for every open file, or assigned device that the job
controls. For more information on the format of the output from the /DDBS refer
to Appendix B under /INFORMATION:DDBS.
2.2.2 /DPY:n:m
This switch displays the selected jobs on a video terminal in DPY mode with
cursor update of the data. If :n is specified, n is treated as a sleep scan
between display updates. The default is 10 seconds. If :n is 0, DPY mode will
not be selected. If :M is specified, m in the number of times to repeat the
display. The default is to repeat forever. While in DPY mode, the following
single characters can be typed to control the output on the display: more
2.2.3 /ERNONE
This switch generates a fatal error when no jobs match the selection criterion.
Either "?WHONTM Job number not assigned" or "?WHOARC All jobs rejected by
constraints" message is generated as appropriate. The default is to issue the
standard message "No one".
JOB MODE Page 2-13
TYPEOUT SWITCHES
2.2.4 /FAST
This switch displays fast information about the selected jobs. This information
is in the format:
17 MEIER,BILL TTY43 WHO R1
The information displayed is the job number (17), user name (MEIER,BILL),
terminal name (TTY43), program name (WHO), and job state (R1).
2.2.5 /FILES
This switch displays the DDBs for the selected jobs. A DDB is a device data
block, and one exists for every open file, or assigned device that the job
controls. For more information on the format of the output from the /FILES
refer to Appendix B under /INFORMATION:DDBS.
2.2.6 /FORMAT:(format-list)
This switch can be used to completely control the information displayed about
each job in the format desired. For more information, see the chapter
"FORMATTING THE DISPLAY".
2.2.7 /INCLUDE:key
This switch selects the inclusion of additional information in the job format
display. The current keys are FUNNY, to include pages of funny space allocated
to the job.
2.2.8 /INCREMENTAL and /NOINCREMENTAL
This switch selects the display of incremental job information for the fields
that are incremental in nature. /NOINCREMENTAL displays the total fields.
Fields that are incremental are batch time limit, IPCF messages received, IPCF
messages sent, uuos executed, CPU runtime, kilo-core-seconds, virtual
kilo-core-seconds, disk blocks read, disk blocks written, time since last RESET
UUO, and jobs logged in time. If /REPEAT or /DPY are specified, it should be
noted that the first display will have zeros for all the incremental fields, as
no previous values are available to compute them.
JOB MODE Page 2-14
TYPEOUT SWITCHES
2.2.9 /INFORMATION:keys
This switch displays addition information about the selects jobs as specified by
the keys. Typically this information is one or more additional line per key.
Legal keys are:
ACCOUNT Display jobs account string
BATCH Display jobs batch and operator information
CAPABILITY Display the jobs DEC and local capability bits
CORE Display virtual and physical core limits for the job.
CHANNELS Display information about each open channel for the job
DDBS Display the DDBS for the job
DEFAULTS Display the jobs SET DEFAULT parameters
IPCF Display IPCF message statistics and quotas
JSL Display the jobs search list and switch settings
LOGICAL Display the jobs pathological names
MTA Display information about each MTA the job has in use
ORIGIN Display the low and high segment origin and version
PATH Display the jobs current path
PRIVILEGES Display the jobs DEC and local privilege bits
SIZE Display information about open file sizes and dates
SPOOL Display the spooled devices and spooling status
TIME Displays the jobs logged in and reset time and date.
TMPCOR Display a directory of the jobs TMPCOR files
For more information about the format of each detailed display, see Appendix B.
2.2.10 /MAP
This switch displays the line mode information about the job that was selected.
The line mode information is for the terminal that is controlling the job. If
it is detached, no additional information is printed.
2.2.11 /NORMAL
This switch displays normal information about the selected jobs. This
information is in the format:
17 MEIER,BILL 10,3146 TTY43 WIZARD 1 WHO 26+33 R2 0:05:08
The information displayed is the job number (17), user name (MEIER,BILL),
project programmer number (10,3146), terminal name (TTY43), node name and line
number (WIZARD_1), program name (WHO), low+high segment core size (26+33), job
state (R2), and cpu runtime (0:05:08).
JOB MODE Page 2-15
TYPEOUT SWITCHES
2.2.12 /OKNONE
This switch requests that no message be printed when no jobs match the selection
criterion. The default is to issue the standard message "No one".
2.2.13 /ORIGIN and /NOORIGIN
This switch displays the complete file specification of the origin of the high
and low segment of the jobs program. The low and high version numbers are also
displayed.
2.2.14 /PERFORMANCE and /NOPERFORMANCE
This switch displays performance ratios with various fields related to the job.
The current ratios are:
DSK/C disk blocks read and written per CPU second of runtime
DSK/E disk blocks read and written per elapsed second
UUOS/C UUOS executed per CPU second of runtime
UUOS/E UUOs executed per elapsed second
CPU/E CPU to elapsed time percentage ratio
If /INCREMENTAL is also specified, the performance statistics reflect the
previous incremental interval only, rather than since the job has been logged
in.
2.2.15 /PRINT and /NOPRINT
This switch controls the output of the job line when used in conjunction with
the /MAP or /SUMMARY switch. If /MAP and /PRINT (default) is given, both the
job and line mode information is printed, and if /NOPRINT is given, only the
line mode information is printed. If /SUMMARY and /PRINT is given, the selected
jobs will be output, as well as the summary at the end, and if /NOPRINT
(default) is given, only the summary information will be displayed.
2.2.16 /REPEAT:N:M
This switch repeats the display of the selected jobs at the selected time
interval. If :n is specified, n is treated as a sleep scan between display
updates. The default is 10 seconds. If :n is 0, repeat mode will not be
selected. If :M is specified, m in the number of times to repeat the display.
The default is to repeat forever.
JOB MODE Page 2-16
TYPEOUT SWITCHES
2.2.17 /SLOW
This switch displays slow information about the selected jobs. This information
is in the format:
17 MEIER,BILL 10,3146 TTY43 WIZARD 1 WHO 26+33 R2 0:05:08
RD:6452 WR:2441 UUOS:32535 JLT:2:19:18 PC:422017
The information displayed is the job number (17), user name (MEIER,BILL),
project programmer number (10,3146), terminal name (TTY43), node name and line
number (WIZARD_1), program name (WHO), low+high segment core size (26+33), job
state (R2), cpu runtime (0:05:08), disk blocks read (RD:6452), disk blocks
written (WR:2441), uuos executed (UUOS:32535), job logged in time (JLT:2:19:18),
program counter (PC:422017). Other information (if non-zero) may be also
displayed, which can be disk priority (DPR:2), high priority queue (HPQ:1),
paging rate (PGR:4.23), and batch time limit (LIM:0:3:20).
2.2.18 /SORT:key:x:n or /SORT:key
This switch displays jobs in sorted order as specified by the switch arguments.
KEY is the field to sort on. If :x is specified, x can be either ASCENDING or
DESCENDING to control the sort, and if :n is present, only the first (last) N
jobs will be output. The legal sort keys are:
ACCOUNT Sort by the first five characters of the account string
APC Sort by the jobs asynchronous port characteristics
BADGE Sort by jobs DEC badge number
BATCH Sort by batch job flag (no/yes)
BATCORE Sort by jobs batch core maximum
CATEGORY Sort by jobs login category
CHARGE Sort by jobs charge number
CID Sort by jobs charge ID.
CLASS Sort by jobs scheduler class
CORE Sort by jobs core size (sum low+high segment)
CTLJOB Sort by controlling job number
CTLPRG Sort by controlling jobs program name
DEFATTACH Sort by jobs default attach setting (yes/no)
DEFBUFFER Sort by jobs default number of buffers setting
DEFPROTECT Sort by the jobs default protection setting
DSKPRIORITY Sort by jobs dsk priority
FUNNY Sort by jobs funny page allocation
GLXOPR Sort by the jobs galaxy operator privilege
HPQ Sort by jobs high priority queue setting
IPCFOREC Sort by number of outstanding IPCF receives
IPCFOSEND Sort by number of outstanding IPCF sends
IPCFQREC Sort by IPCF receive quotas
IPCFQSEND Sort by IPCF send quotas
IPCFREC Sort by IPCF messages received
IPCFSEND Sort by IPCF messages sent
JLT Sort by jobs logged in time
KCS Sort by jobs kilo-core-seconds
LIMIT Sort by jobs batch time limit
JOB MODE Page 2-17
TYPEOUT SWITCHES
LINE Sort by jobs terminal line number
LOCATION Sort by jobs logically located node
LPPN Sort by jobs logged-in PPN (project-programmer number)
LPRGNUM Sort by jobs logged-in programmer number
LPRJNUM Sort by jobs logged-in project number
NAME Sort by the first six characters of the user name
NODE Sort by node name where jobs terminal is physically
connected
NODENAME Sort by node name where jobs terminal is physically
connected
NODENUMBER Sort by node number where jobs terminal is physically
connected
PAGERATE Sort by jobs paging rate
PC Sort by jobs PC (program counter)
PHYHIGH Sort by jobs physical high segment size.
PHYLOW Sort by jobs physical low segment size.
PPN Sort by jobs PPN (project-programmer number)
PRGNUMBER Sort by jobs programmer number only
PRGRUN Sort by program to run
PRJNUMBER Sort by jobs project number only
PROGRAM Sort by jobs program name
PROSET Sort by jobs default protection set (yes/no)
READS Sort by number of disk blocks read
REMOTE Sort by jobs remote flag (no/yes)
RESET Sort by jobs RESET time
RUNTIME Sort by jobs CPU runtime
SEGMENT Sort by jobs high segment name
SLOT Sort by jobs distribution slot
TTY Sort by jobs terminal name
UUOS Sort by jobs executed UUO count
VCORE Sort by jobs virtual core size (sum low+high segments)
VIRHIGH Sort by jobs virtual high segment size.
VIRLOW Sort by jobs virtual low segment size.
VKCS Sort by jobs virtual kilo-core-seconds
WRITES Sort by number of disk blocks written
WSCODE Sort by jobs wait state code
WTO Sort by jobs WTO privileges
If /INCREMENTAL is also specified, and the key is an incremental field, the
sorted order will reflect the intervals incremental values.
2.2.19 /STAMP and /NOSTAMP
This switch displays a date/time stamp at the top of the display of the selected
jobs.
JOB MODE Page 2-18
TYPEOUT SWITCHES
2.2.20 /SUMMARY:key
This switch displays a summary of jobs by the selected key. The specified field
and the number of jobs matching that field is displayed, one line for each
different value of the field. If the field can be a large numeric value, it is
rounded off, and grouped into various buckets and displayed.
ACCOUNT Summarize by the first five characters of the account string
APC Summarize by the jobs asynchronous port characteristics
BADGE Summarize by jobs DEC badge number
BATCH Summarize by batch job flag (no/yes)
BATCORE Summarize by jobs batch core maximum
CATEGORY Summarize by jobs login category
CHARGE Summarize by jobs charge number
CID Summarize by jobs charge ID.
CLASS Summarize by jobs scheduler class
CORE Summarize by jobs core size (sum low+high segment)
CTLJOB Summarize by controlling job number
CTLPRG Summarize by controlling jobs program name
DEFATTACH Summarize by jobs default attach setting (yes/no)
DEFBUFFER Summarize by jobs default number of buffers setting
DEFPROTECT Summarize by the jobs default protection setting
DSKPRIORITY Summarize by jobs dsk priority
FUNNY Summarize by jobs funny page allocation
GLXOPR Summarize by the jobs galaxy operator privilege
HPQ Summarize by jobs high priority queue setting
IPCFOREC Summarize by number of outstanding IPCF receives
IPCFOSEND Summarize by number of outstanding IPCF sends
IPCFQREC Summarize by IPCF receive quotas
IPCFQSEND Summarize by IPCF send quotas
IPCFREC Summarize by IPCF messages received
IPCFSEND Summarize by IPCF messages sent
JLT Summarize by jobs logged in time
KCS Summarize by jobs kilo-core-seconds
LIMIT Summarize by jobs batch time limit
LINE Summarize by jobs terminal line number
LOCATION Summarize by jobs logically located node
LPPN Summarize by jobs logged-in PPN (project-programmer number)
LPRGNUM Summarize by jobs logged-in programmer number
LPRJNUM Summarize by jobs logged-in project number
NAME Summarize by the first six characters of the user name
NODE Summarize by node name where jobs terminal is physically
connected
NODENAME Summarize by node name where jobs terminal is physically
connected
NODENUMBER Summarize by node number where jobs terminal is physically
connected
PAGERATE Summarize by jobs paging rate
PC Summarize by jobs PC (program counter)
PHYHIGH Summarize by jobs physical high segment size.
PHYLOW Summarize by jobs physical low segment size.
PPN Summarize by jobs PPN (project-programmer number)
PRGNUMBER Summarize by jobs programmer number only
PRGRUN Summarize by program to run
JOB MODE Page 2-19
TYPEOUT SWITCHES
PRJNUMBER Summarize by jobs project number only
PROGRAM Summarize by jobs program name
PROSET Summarize by jobs default protection set (yes/no)
READS Summarize by number of disk blocks read
REMOTE Summarize by jobs remote flag (no/yes)
RESET Summarize by jobs RESET time
RUNTIME Summarize by jobs CPU runtime
SEGMENT Summarize by jobs high segment name
SLOT Summarize by jobs distribution slot
TTY Summarize by jobs terminal name
UUOS Summarize by jobs executed UUO count
VCORE Summarize by jobs virtual core size (sum low+high segments)
VIRHIGH Summarize by jobs virtual high segment size.
VIRLOW Summarize by jobs virtual low segment size.
VKCS Summarize by jobs virtual kilo-core-seconds
WRITES Summarize by number of disk blocks written
WSCODE Summarize by jobs wait state code
WTO Summarize by jobs WTO privileges
If /INCREMENTAL is also specified, and the key is an incremental field, the
summary display will reflect the intervals incremental values.
2.2.21 /TOTALS and /NOTOTALS
This switch selects whether or not a total line will be generated. The total
line is of the format "Total of n jobs" where n is the number of jobs that match
the selection criterion.
2.2.22 /VFAST
This switch displays very fast information about the selected jobs. This
information is in the format:
MEIER,BILL TTY43
The information displayed is user name (MEIER,BILL) and terminal name (TTY43).
CHAPTER 3
LINE MODE
3.1 SELECTION SWITCHES
The following switches can be included on the command line to select different
classes of lines. None of these switches are global, they apply only to the
current specification. Multiple specifications are separated by commas.
3.1.1 /AUTODIALER and /NOAUTODIALER
This switch selects lines that have autodialers. /NOAUTODIALER selects lines
that don't have autodialers.
3.1.2 /ASSIGN and /NOASSIGN
This switch selects lines that are assigned by a job with the monitor assign
command. /NOASSIGN selects lines that are not assigned by a job.
3.1.3 /CARRIER and /NOCARRIER
This switch selects lines that are dialup lines with carrier present.
/NOCARRIER selects lines that are dialup but without carrier present.
3.1.4 /CTY or /NOCTY
This switch selects the line of the CTY, the console terminal. /NOCTY selects
all lines except the CTY (ie TTYs and PTYs).
LINE MODE Page 3-2
SELECTION SWITCHES
3.1.5 /DIALUP and /NODIALUP
This switch selects lines that are dialup lines. /NODIALUP selects lines that
are not dialup lines.
3.1.6 /GANDALF and /NOGANDALF
This switch selects gandalf switched lines. /NOGANDALF selects jobs that are
not gandalf switched lines.
3.1.7 /HARDWIRED and /NOHARDWIRED
This switch selects hardwired lines. /NOHARDWIRED selects lines that are not
hardwired.
3.1.8 /INITED and /NOINITED
This switch selects lines that are inited (opened) by a job with the OPEN, INIT,
or FILOP. UUO. /NOINITED selects lines that are not inited by a job.
3.1.9 /JOB:n
This switch selects lines that are in use by job n. The lines may be assigned,
inited, or otherwise in use by job n.
3.1.10 /LOCAL and /NOLOCAL
This switch selects local terminals. Local terminals implies the "TTY NO
REMOTE" setting rather than non-network terminals. /NOLOCAL selects non-local
terminals (eg remote terminals).
3.1.11 /LOCATE:"string"
This switch selects lines with the specified location string. The location
string can be up to 19 characters, optionally containing wildcards (? and *).
If the location string contains blanks or other non-alpha numeric characters, it
must be inclosed in quotations. The lines location string is defined by the
system administrator in the binary file STD:LINES.INI which relates node name
and line number to a location string, which generally describes the location of
the terminal drop.
LINE MODE Page 3-3
SELECTION SWITCHES
3.1.12 /MIC and /NOMIC
This switch selects lines by are being controlled by MIC, ie MIC is typing or
otherwise controlling the input or output to the terminal. /NOMIC selects lines
not controlled by MIC.
3.1.13 /NODE:ss_ll or /NODE:ss
This switch selects lines who are physically connected to the specified node ss
and line ll. ss is a node name with optional ? and * wildcarding, and ll is an
octal line number. If only a node name is specified any lines who are
physically connected to node ss are selected regardless of their line number.
3.1.14 /PHONE:"aa"
This switch selects dialup phone lines with the specified phone number string.
The phone number string can be up to 19 characters, optionally containing
wildcards (? and *). If the phone number string contains blanks or other
non-alpha numeric characters, it must be inclosed in quotations. The lines
phone number string is defined by the system administrator in the binary file
STD:LINES.INI which relates node name and line number to a phone number string,
which generally describes the phone number of the terminal line.
3.1.15 /PTY:oo or /PTY or /NOPTY
This switch selects pseudo-terminal (PTY) line oo. OO is an octal line number
from 0 to the number of legal PTYs minus 1. If :oo is omitted, all PTY lines
are selected. /NOPTY selects lines that arent PTYs (ie TTYs and the CTY).
3.1.16 /RCVSPEED:n
This switch selects lines that have a receive speed of n baud.
3.1.17 /REMOTE AND /NOREMOTE
This switch selects remote terminals. Remote terminals implies the "TTY REMOTE"
setting rather than non-network terminals. /NOREMOTE selects non-remote
terminals (eg local terminals).
LINE MODE Page 3-4
SELECTION SWITCHES
3.1.18 /SLAVE and /NOSLAVE
This switch selects lines that are slaved and cannot type commands to the
monitor. /NOSLAVE selects lines that are not slaved.
3.1.19 /SPEED:n
This switch selects lines whose transmit and receive speed are both equal to n
baud.
3.1.20 /TSN and /NOTSN
This switch selects TSN controlled lines. /NOTSN selects lines that are not TSN
controlled.
3.1.21 /TTY:oo or /TTY or /NOTTY
This switch selects the line (TTY) oo. OO is an octal number from 0 to the
number of legal terminals (including PTYs) minus 1. If :oo is omitted, all TTY
lines (but not CTY and PTY lines) are selected. /NOTTY selects lines that arent
TTYs (ie PTYs and the CTY).
3.1.22 /TYPE:ss
This switch selects lines whose terminal type is ss. SS is a sixbit word with
optional ? and * wildcarding.
3.1.23 /USER and /NOUSER
This switch selects lines that are controlling a job (user). /NOUSER selects
lines that are not controlling a job.
3.1.24 /XMTSPEED:n
This switch selects lines that have a transmit speed of n baud.
LINE MODE Page 3-5
TYPEOUT SWITCHES
3.2 TYPEOUT SWITCHES
The following switches can be included on the command line to control the format
of the line mode output. In all cases, these switches are global, and can be
specified anywhere in the command line and have the same effect.
3.2.1 /DPY:n:m
This switch displays the selected lines on a video terminal in DPY mode with
cursor update of the data. If :n is specified, n is treated as a sleep scan
between display updates. The default is 10 seconds. If :n is 0, DPY mode will
not be selected. If :M is specified, m in the number of times to repeat the
display. The default is to repeat forever. While in DPY mode, the following
single characters can be typed to control the output on the display: more
3.2.2 /ERNONE
This switch generates a fatal error when no lines match the selection criterion.
Either "?WHONTM Line not connected" or "?WHOARC All lines rejected by
constraints" message is generated as appropriate. This is the default.
3.2.3 /FAST
This switch displays fast information about the selected lines. This
information is in the format:
TTY43 WIZARD 1 RDC A U job 17
The information displayed is terminal name (TTY43), node name (WIZARD), line
number (1), flags (RDC), and job control information (A U job 17).
3.2.4 /INCLUDE:key
This switch selects the inclusion of additional information in the line format
display. The current keys are PTY, to include PTY lines in the display.
3.2.5 /INCREMENTAL and /NOINCREMENTAL
This switch selects the display of incremental line information for the fields
that are incremental in nature. /NOINCREMENTAL displays the total fields.
Fields that are incremental are input character count, output character count,
break character count, and command count. If /REPEAT or /DPY are specified, it
should be noted that the first display will have zeros for all the incremental
fields, as no previous values are available to compute them.
LINE MODE Page 3-6
TYPEOUT SWITCHES
3.2.6 /INFORMATION:keys
This switch displays addition information about the selects lines as specified
by the keys. Typically this information is one or more additional line per key.
Legal keys are:
TTY Display all terminal parameters like INITIA TTY command
3.2.7 /MAP
This switch displays the job mode information about the line that was selected.
The job mode information is for the job that that has the terminal assigned,
inited, or logged in. If there is no related job, no additional information is
printed.
3.2.8 /NORMAL
This switch displays normal information about the selected lines. This
information is in the format:
TTY43 WIZARD 1 Dataset - 1281 RDC VT52 600 300 A U job 17
The information displayed is terminal name (TTY43), node name (WIZARD), line
number (1), location or phone string descriptor (Dataset - 1281), flags (RDC),
terminal type (VT52), receive speed (600), transmit speed (300), and job control
information (A U job 17).
3.2.9 /OKNONE
This switch requests that no message be printed when no lines match the
selection criterion. The default is /ERNONE which will generate a fatal error
when no lines match the selection criterion.
3.2.10 /PERFORMANCE and /NOPERFORMANCE
This switch displays performance ratios with various fields related to the line.
The current ratios are:
O/I Output to input character count ratio
ICC/E Input characters typed per elapsed second
OCC/E Output characters displayed per elapsed second
BRK/EM Break characters typed per elapsed minute
CMD/EM Commands typed per elapsed minute
If /INCREMENTAL is also specified, the performance statistics reflect the
previous incremental interval only, rather than since the line has connected.
LINE MODE Page 3-7
TYPEOUT SWITCHES
3.2.11 /PRINT and /NOPRINT
This switch controls the output of the line line when used in conjunction with
the /MAP or /SUMMARY switch. If /MAP and /PRINT (default) is given, both the
line and job mode information is printed, and if /NOPRINT is given, only the job
mode information is printed. If /SUMMARY and /PRINT is given, the selected
lines will be output, as well as the summary at the end, and if /NOPRINT
(default) is given, only the summary information will be displayed.
3.2.12 /REPEAT:N:M
This switch repeats the display of the selected lines at the selected time
interval. If :n is specified, n is treated as a sleep scan between display
updates. The default is 10 seconds. If :n is 0, repeat mode will not be
selected. If :M is specified, m in the number of times to repeat the display.
The default is to repeat forever.
3.2.13 /SLOW
This switch displays slow information about the selected lines. This
information is in the format:
TTY43 WIZARD 1 Dataset - 1281 RDC VT52 600 300 A U job 17
ICC:44234 OCC:737227 BRK:4166 CMD:1211
The information displayed is terminal name (TTY43), node name (WIZARD), line
number (1), location or phone string descriptor (Dataset - 1281), flags (RDC),
terminal type (VT52), receive speed (600), transmit speed (300), job control
information (A U job 17), count of characters input (ICC:44234), count of
characters output (OCC:737227), break characters typed (BRK:4166), and count of
commands typed (CMD:1211).
3.2.14 /SORT:key:x:n or /SORT:key
This switch displays lines in sorted order as specified by the switch arguments.
KEY is the field to sort on. If :x is specified, x can be either ASCENDING or
DESCENDING to control the sort, and if :n is present, only the first (last) N
lines will be output. The legal sort keys are:
APC Sort by asynchronous port characteristics
ASSIGN Sort by assigned flag (no/yes)
BREAK Sort by break character count
CARRIER Sort by carrier flag (no/yes)
COMMANDS Sort by commands typed
DIALUP Sort by dialup flag (no/yes)
INITED Sort by inited flag (no/yes)
INPUT Sort by input character count
JOB Sort by job using line
LINE MODE Page 3-8
TYPEOUT SWITCHES
LINE Sort by line
NODE Sort by node name
NODENAME Sort by node name
NODENUMBER Sort by node number
OUTPUT Sort by output character count
RCVSPEED Sort by receive speed
REMOTE Sort by remote flag (no/yes)
SLAVE Sort by slave flag (no/yes)
TYPE Sort by terminal type
USER Sort by user flag (no/yes)
XMTSPEED Sort by terminal transmit speed
If /INCREMENTAL is also specified, and the key is an incremental field, the
sorted order will reflect the intervals incremental values.
3.2.15 /STAMP and /NOSTAMP
This switch displays a date/time stamp at the top of the display of the selected
lines.
3.2.16 /SUMMARY:key
This switch displays a summary of lines by the selected key. The specified
field and the number of lines matching that field is displayed, one line for
each different value of the field. If the field can be a large numeric value,
it is rounded off, and grouped into various buckets and displayed.
APC Summarize by asynchronous port characteristics
ASSIGN Summarize by assigned flag (no/yes)
BREAK Summarize by break character count
CARRIER Summarize by carrier flag (no/yes)
COMMANDS Summarize by commands typed
DIALUP Summarize by dialup flag (no/yes)
INITED Summarize by inited flag (no/yes)
INPUT Summarize by input character count
JOB Summarize by job using line
LINE Summarize by line
NODE Summarize by node name
NODENAME Summarize by node name
NODENUMBER Summarize by node number
OUTPUT Summarize by output character count
RCVSPEED Summarize by receive speed
REMOTE Summarize by remote flag (no/yes)
SLAVE Summarize by slave flag (no/yes)
TYPE Summarize by terminal type
USER Summarize by user flag (no/yes)
XMTSPEED Summarize by terminal transmit speed
If /INCREMENTAL is also specified, and the key is an incremental field, the
summary display order will reflect the intervals incremental values.
LINE MODE Page 3-9
TYPEOUT SWITCHES
3.2.17 /TOTALS and /NOTOTALS
This switch selects whether or not a total line will be generated. The total
line is of the format "Total of n lines" where n is the number of lines that
match the selection criterion.
3.2.18 /VFAST
This switch displays very fast information about the selected lines. This
information is in the format:
TTY43 WIZARD 1
The information displayed is terminal name (TTY43), node name (WIZARD), and line
number (1).
CHAPTER 4
FORMATTING THE DISPLAY
WHO provides the sophisticated used with complete control of the output display.
The exact formats of the display line, as well as optional headings and footings
can be specified.
4.1 FORMAT LIST
A number of format control switches take a "format-list" as an argument. A
"format-list" is a list of parameters separated by commas and inclosed in
parentheses. Each parameter is either a text string or a switch specific
keyword. Text string parameters are simply ascii strings enclosed in double
quotations ("). Keywords must be from the legal set of keywords, and can
include several arguments of the form keyword:arg1:arg2:arg3. All arguments are
optional, and can be omitted. ARG1 is the default fieldwidth of for the
specified keyword. ARG2 is a keyword to control the justification of the field.
It can be either LEFT (for left justification in the specified field width),
CENTER (for centering in the specified field width), or RRIGHT (for right
justification in the specified field width). ARG3 is the number of spaces to
follow the field (only valid when the fieldwidth is zero). If any argument is
omitted, a default depending on the nature of the keyword field destined to be
output is used.
4.2 FORMAT LIST SWITCHES
The following switches take a format-list an an argument. For a list of the
keywords that each format-list can be composed of, refer to the following
section.
4.2.1 /FINAL:(format-list)
This format switch provides a format-controlled line to be output once at the
end of all selected jobs or lines. It is useful for including trailer
information. For example, [10,]/FINAL:list1,/PROGRAM:WHO (equivalent to
[10,],/PROGRAM:WHO/FINAL:list1 since FINAL is a global switch) would output
format-list 1 after listing all project 10 jobs, and all jobs running program
FORMATTING THE DISPLAY Page 4-2
FORMAT LIST SWITCHES
WHO.
4.2.2 /FOOTING:(format-list)
This format switch provides a format-controlled line to be output at the end of
each list of job/line specifications, and thus, is a "file" specific switch.
For example, [10,]/FOOTING:list1,/PROGRAM:WHO/FOOTING:list2 would output
format-list 1 after listing all project 10 jobs, and format list 2 after listing
all jobs running program WHO.
4.2.3 /HEADING:(format-list)
This format switch provides a format-controlled line to be output before each
list of job/line specifications, and thus, si also a "file" specific switch.
For example, [10,]/HEADING:list1,/PROGRAM:WHO/HEADING:list2 would output
format-list 1 before listing all project 10 jobs, and format list 2 before
listings all jobs running program WHO.
4.2.4 /INITIAL:(format-list)
This format switch provides a format-controlled line to be output once before
the start of all the selected jobs or lines. It is useful for including titles,
or other information. For example, [10,]/INITIAL:list1,/PROGRAM:WHO (equivalent
to [10,],/PROGRAM:WHO/INITIAL:list1 since INITIAL is a global switch) would
output format-list 1 before listing all project 10 jobs, and all jobs running
program WHO.
4.2.5 /FORMAT:(format-list)
This format switch controls the detailed listing for each job. It is a global
switch, and can be used to taylor the output to display exactly the desired
fields for each job. The switches /VFAST, /FAST, /NORMAL and /SLOW select
several common detail line formats.
4.3 DEFAULT FORMAT CONTROL
The following switches can be used to control the default global justifications.
However, any specified as ARG2 to any of the above switches, will override the
defaults.
FORMATTING THE DISPLAY Page 4-3
DEFAULT FORMAT CONTROL
4.3.1 /BLANK
This default format control switch suppresses the output of any field that
normally would be blank. Thus, this can destroy the neat, columnized output.
4.3.2 /DEFAULT
This default format control switch selects that the default justification be
used for each field.
4.3.3 /FIX
This default format control switch forces all fields to be output in strict,
fixed length columnized areas.
4.3.4 /FLOAT
This default format control switch allows all fields to be output in completely
free floating format. Generally, by default, each field will be separated from
the previous field by exactly one space.
CHAPTER 5
ACTION SWITCHES
The following action switches may be used to force various actions on the target
job or line. Some switches require a target job, and use the job (if in JOB
mode), or the job owning the terminal (if in LINE mode), others require a target
line, and use the line number of the selected job (if in JOB mode), or the line
number (if in LINE mode).
All of these functions can be done to any job with the same programmer number as
the commanding job, or to any terminal owned by the commanding job. If the
target job/line does not meet one of those criterion, POKE or WHEEL privileges
are required.
In all cases except for /NETWORK:CONNECT the action is preformed after the
jobs/lines are selected, and the information displayed. In the case of
/NETWORK:CONNECT, the lines are selected, and information displayed after the
lines are connected.
5.1 INPUT/OUTPUT FUNCTIONS
5.1.1 /FORCE:command
This switch uses the FRCUUO monitor call to force a command on the selected
jobs. If the job is detached, the switch is ignored. Legal forced commands
are:
.HALT Force a ^C (stop the stop with control-C trapping)
.BYE Detach the job
.HELLO Run the INITIA program
.RESTA Type the system restart greeting
KJOB Log the job out
INITIA Run the INITIA program
.FCONT Force a CONTINUE
.TYPE Retype the line (control-R)
USESTA Type statistics (control-T)
.NETLDR Force run the NETLDR program
HALT HALT the job regardless of control-C trapping
CTEST Force a CTEST command (for patching)
ACTION SWITCHES Page 5-2
INPUT/OUTPUT FUNCTIONS
5.1.2 /INPUT:"string"
This switch inputs the "string" into the terminal buffer, as though it was typed
on the terminal. Control characters can be imbedded by inserting them in
up-arrow form.
5.1.3 /OUTPUT:"string"
This switch outputs the "string" on the terminal. Control characters can be
imbedded by inserting them in up-arrow form.
5.1.4 /SEND:"string"
This switch outputs the "string" on the terminal, prefixed with the standard
"<bell>;;TTYnnn - " leader.
5.2 NETWORK FUNCTIONS
5.2.1 /NETWORK:CONNECT
This switch connects all the specified terminals to the host system. The /NODE
switch must be given, and the node name cannot be wildcarded. If a specific
line is given (/NODE:name_line) only that terminal is connected, if no line is
given (/NODE:name) all terminals on that node will be connected.
5.2.2 /NETWORK:DISCONNECT
This switch sends a disconnect message to the node to which each selected
terminal is connected to. If a job is on the line, it is detached.
5.3 SETUUO FUNCTIONS
The following arguments can be specified to the /SETUUO switch. Multiple
/SETUUO switches with different arguments can be specified. Each argument to
the /SETUUO switch is a keyword followed by another argument (such as
/SETUUO:DSKFUL:PAUSE to set disk-full pause for the job).
ACTION SWITCHES Page 5-3
SETUUO FUNCTIONS
5.3.1 CPU:n
This argument sets the CPU runability for the selected jobs to CPU n. (.SET RUN
CPUn ONLY)
5.3.2 DEFAULT:BUFFERS:n
This argument sets the default number of disk buffers for the job to N (.SET
DEFAULT BUFFERS n).
5.3.3 DEFAULT:PROTECTION:n
This argument sets the default file protection for the selected jobs to n. N is
an octal number between 0 and 777. (.SET DEFAULT PROTECTION n)
5.3.4 DEFER:key
This argument sets or clears defered spooling for the selected jobs. Key may be
either YES to set defered spooling (.SET DEFER), or NO to clear defered spooling
(.SET NODEFER).
5.3.5 DSKFUL:key
This argument sets or clears the disk-full action for the selected jobs. Key
may be either PAUSE to enable disk-full pause (.SET DSKFUL PAUSE), or ERROR to
disable disk-full pause (.SET DSKFUL ERROR).
5.3.6 LIMIT:hh:mm:ss
This argument sets the batch time limit for the selected jobs to hh:mm:ss.
5.3.7 PHYSICAL:key:n
This argument sets the physical core parameter to n pages for the selected jobs.
Key may be either LIMIT to set physical limit (.SET PHYSICAL LIMIT n), or
GUIDELINE to set physical guideline (.SET PHYSICAL GUIDELINE n).
ACTION SWITCHES Page 5-4
SETUUO FUNCTIONS
5.3.8 TIME:hh:mm:ss
This argument sets the batch time limit for the selected jobs to hh:mm:ss.
5.3.9 VIRTUAL:n
This argument sets the virtual core limit to n pages for the selected jobs.
(.SET VIRTUAL n)
5.3.10 WATCH:(keys)
This argument sets watch parameters for the selected jobs. Any of the keywords
to the monitor .SET WATCH command may be specified. Multiple keys can be
specified, inclosed in parentheses, and separated by commas.
CHAPTER 6
OUTPUT FILE CONTROL
6.1 FILE SPECIFICATION DEFAULTS
The default output specification is TTY:WHO.LST. However, if any part of a file
specification is typed, the defaults are filled in from DSK:WHO.LST[-].
6.2 SWITCHES
The following switches may be placed on the output file specification to control
it.
6.2.1 /APPEND and /NOAPPEND
This switch controls whether or not the output file is appended to. The default
(/NOAPPEND) is to supersede the output file for the first command, and append to
it each time if /REPEAT is specified. /APPEND will always append to the output
file.
6.2.2 /ERSUPERSEDE
This switch will cause a fatal error to be generated if the output file exists,
and would be superseded. The default is not to generate an error, and supersede
the file.
6.2.3 /OKSUPERSEDE
This switch allows the output file to be superseded, if it exists. This also is
the default action.
OUTPUT FILE CONTROL Page 6-2
SWITCHES
6.2.4 /PROTECTION:n
This switch sets the output file protection to n. N is an octal number between
1 and 777. A value of 0 uses the system default.
6.2.5 /VERSION:x
This switch sets the output file version. X is a standard version word
consisting of major minor(edit)-who. The default is to use the version of the
program.
APPENDIX A
JOB STATE CODES
The following wait state codes may be output for the jobs wait state. The
format of the output is XXYY where XX is the one of the wait states listed
below, XX indicates the job is currently running on a CPU, YY is the swapping
state (SW=swapped out, SF=swapped out and fragmented, LK=locked in core), and YY
indicates the job is actively being swapped. A list of wait state codes
follows:
State Explanation
AU Alter disk UFD queue
B1 Running background batch in PQ1
B2 Running background batch in PQ2
CA Semi-permanent core allocation wait
CB Disk core-block scan wait
D1 Dectape control wait (up to 8 drives)
D2 Second DECtape controler wait
DA Disk storage allocation wait
DC Data control (DC) wait - magtape and dectape
DI Disk input wait
DO Disk output wait
DS Disk I/O wait satisfied
DW Disk I/O wait
E6 Event wait (DN60)
EF Event wait (front ends)
EI Event wait (IPCF)
EK Event wait (tape kontroller)
EL Event wait (tape labeling)
EN Event wait (networks)
EQ ENQ/DEQ wait
ER Event wait (tape rewinding)
ES Event wait satisfied
EV Exec virtual memory wait
EW General event wait
EW Job in event wait
GU GETSEG UUO in progress
HB Hibernate (no sleep time)
HS Hibernate with sleep time
Hd Running in HPQ d
IO IO wait
JD Waiting for DAEMON to be run
JOB STATE CODES Page A-2
LK Locked in core
MM Memory management wait
NA Job napping (.lt. 1 sec sleep)
NU Job number not assigned
OW Operator wait
PI Paging I/O wait
PS Paging I/O wait satisfied
R1 Running in PQ1
R2 Running in PQ2
RN Running
RU Run UUO in progress
SF Swapped and fragmented
SL Sleeping
SW Swapped out
TI TTY input wait
TO TTY output wait
TS TTY I/O wait satisfied
TW TTY I/O wait
WI General input wait
WO General output wait
WS I/O wait satisfied
^C Job stopped
^D Job in DAEMON DCORE wait
^W Job in command wait
APPENDIX B
INFORMATION DISPLAYS
The following is a detailed description of all the output for the /INFORMATION
switch. For a description of the switch, refer to "selection switches" in the
previous sections.
B.1 ACCOUNT
This keyword displays the account string for the selected jobs. This
information is in the format:
Account: 6PFS.C684422
The information displayed is the account string (6PFS.C684422).
B.2 BATCH
This keyword displays batch and operator information for the selected jobs.
This information is in the format:
WTO privs:all OPR privs:system Batch stream:no Limit:0:09:45 Core:511
The information displayed is the write to operator privileges (all) [can be one
of ALL, WTO, NONE], operator privileges (system) [can be one of NONE, REMOTE,
HOST, SYSTEM], batch stream number (no) [a stream number or "no" if none set],
batch CPU time limit (0:9:45), and batch core limit (511).
B.3 CAPABILITIES
This keyword displays the enabled capabilities of the selected jobs. This
information is in the format:
Capabilities: 777777,1
DEC: IPCF DPR:3 METER POKE CPU HPQ:15 USPL ENQ RTTRP LOCK TRPSET SPY MSPY
Local: CHGPPN
INFORMATION DISPLAYS Page B-2
CAPABILITIES
The information displayed is the octal capability bits (left half=DEC, right
half=local) (777777,1), and a breakdown of each of the DEC and local
capabilities by name.
B.4 CHANNEL
This keyword displays information about all open channels for the selected jobs.
This information is in the format:
2 DSK 14 OO OB E O IC
The information displayed is the channel number (2), device inited (DSK), I/O
mode (14) and various channel status flags from USRJDA (OO OB E O IC). The
channel status flags are:
OI Opened with input buffer specified
OO Opened with output buffer specified
IB Input buffers have been setup
OB Output buffers have been setup
L LOOKUP has been done
E ENTER has been done
I INPUT has been done
O OUTPUT has been done
IC Input close has been done (or not needed)
OC Output close has been done (or not needed)
B.5 CORE
This keyword displays the current and maximum physical and virtual core limits
for the selected jobs. This information is in the format:
Core limits: Current: Virt:200 Phys:120 Maximum: Virt:512 Phys:300
The information displayed is the jobs current virtual limit (200), current
physical limit (120), maximum virtual limit (512), and maximum physical limit
(300), all expressed in pages of core.
B.6 DDBS
This keyword displays information about all open devices for the selected jobs.
This information is in the format:
* TTY104 A node WIZARD(123) line 45 R
LPT773 I node SOFDCP(77) unit 3 W
MTA710 A MTA0 reelid:COBOL file 11 record 45 WE/W
DSK I DSKE0:PROJCT.SYS[10,7,GALAXY,ACT] 1 U/R
ACT I DEVIN DSKE0:SYSDEV.BIN[1,7] R
TSK71 I I: *::FTSFAL[1,2] P: TWINKY::NETSPL[1,2] R
INFORMATION DISPLAYS Page B-3
DDBS
The information displayed is the flag ('=device is spooled, *=I/O active for
this DDB), the device name the program opened (DEVNAM), the status (A=assigned
by console command, I=inited by program), and the logical name assignment (if
any). The rest of the information is device specific, and is discussed below.
The final character is the last I/O direction, which is either R (reading last),
or W (writing last).
B.6.1 DSK DDB information
If the DDB is for a disk, the following device specific information is
displayed. The logical unit name (if a file is open), the file and extension,
and the files complete path including five levels of SFD. Following the file
specification information, is the current block number to be read or written
next. If the file is open, the reader count followed by the access table status
is displayed. The access table status is C=file being created, S=file being
superseded, R=file being read, U=file being updated (single user), and M=file
being updated (multi user). If the file is marked for deletion, the separating
"/" will turn into a "!".
B.6.2 MTA DDB information
If the DDB is for a magtape, the following device specific information is
displayed. The tapes reelid (reelid:COBOL), the current file number (file 11),
the current record number (record 45) [??? means the record number is not
known], various flags [BOT=tape at beginning of tape, EOT=tape at logical end of
tape, REW=tape is in the process and being rewound], and the write enable status
(WE) [WE=tape is write enabled, WL=tape is write locked].
B.6.3 NET DDB information
If the DDB is for a network device, with the exception of TTYs and TSKs, the
following network device specific information is displayed. The node name, node
number, and unit number of the device is output.
B.6.4 TSK DDB information
If the DDB is for a task, the following device specific information is
displayed. The network process descriptor (NPD) for both the input (I:) and
passive (P:) tasks are displayed. Each NPD includes the node name (*=any node)
and the ascii connect string, with \ substituted for nulls.
INFORMATION DISPLAYS Page B-4
DDBS
B.6.5 TTY DDB information
If the DDB is for a terminal, the following device specific information is
displayed. The node name, node number, and line number of the terminal is
output.
B.7 DEFAULTS
This keyword displays the various SET DEFAULT parameters for the selected jobs.
This information is in the format:
Defaults: Buffers:10 Protection:<077>On Attach:Ask
The information displayed is the default number of disk buffers (from SET
DEFAULT BUFFER n command) (10), the jobs default file protection (from SET
DEFAULT PROTECTION nnn command) (<077>), if the default file protection is set
(On), and the ATTACH: status (from LOGIN/ATTACH:[IGNORE,ASK]) (Attach:Ask).
B.8 IPCF
This keyword displays IPCF statistics for the selected jobs. This information
is in the format:
IPCF messages: S:12 R:7 outstanding: S:1 R:0 quotas: S:100 R:50
The information displayed is the send and receive message counts (messages S:12
R:7), the outstanding send and receive message counts (outstanding: S:1 R:0),
and the send and receive quotas (quotas: S:100 R:50).
B.9 JSL
This keyword displays the job search list and switches for the selected jobs.
The information displayed is in the format:
Job search list: TSG0:/NOWRITE, SOFT:, FENCE, DSKE:/NOCREATE
The information displayed is the structures in the jobs active search list to
the left of the FENCE (TSG0:, SOFT:), the FENCE itself (FENCE), and the
structures in the jobs passive search list to the right of the FENCE (DSKQ:).
If applicable, the switches /NOWRITE (do not write on this structure), and
/NOCREATE (do not create on this structure if generic DSK is specified) may be
present.
INFORMATION DISPLAYS Page B-5
LOGICAL
B.10 LOGICAL
This keyword displays the pathological names defined for the selected jobs.
This information is in the format:
Logical name definitions:
SYS: = DSKQ:[10,3146,SYS],SSL:[1,5],SSL:[1,4]
LIB:/SEARCH = DSKQ:[10,3146,LIB]
WSM: = DSKQ:[10,3146]
The information displayed is the pathological name (SYS:), the search attribute
(/SEARCH), and the list of structures and paths that compose the logical name
(DSKQ:[10,3146,SYS],SSL:[1,5],SSL:[1,4]).
B.11 MTA
This keyword displays information about the parameters of any magtapes in use by
the job. This keyword also implies DDBS (see above for a description of the DDB
format). The information displayed is in the format:
Density:1600 Track:9 Mode:DEC core dump Labels:ANSI
The information displayed is the tape density (1600) [can be one of 200, 556,
800, 1600, 6250], the track (9) [can be either 7 or 9], the mode (DEC core dump)
[can be one of none, DEC core dump, Industry core dump, SIXBIT, ASCII, DEC core
dump], and the label type (ANSI) [can be of No MDA, Bypass, ANSI, ANSI(user),
IBM, IBM(user), leading tape mark, nonstandard, none, COBOL ASCII, COBOL SIXBIT,
user EOT].
B.12 ORIGIN
This keyword displays the program origin and version for both the high segment
and low segment. The information displayed is in the format:
Origin: DSKQ:QUASAR[1,4,QSR] 4(761)/1(5) + DSKE:GLXLIB[1,4] 1(763)
The information displayed is the low segment origin (DSKQ:QUASAR[1,4,QSR]), the
low segment Digital version (loc .JBVER==137) [4(761)], the low segment customer
version (loc .JBCST==136) [1(5)], the high segment origin (DSKE:GLXLIB[1,4]),
and the high segment Digital version [1(763)]. If all the attributes of the
high segment are the same as the low segment, only the low segment information
and a plus (+) are displayed. If the program has no high segment, only the low
segment information excluding the plus is displayed, and if the program has a
spy segment, it is indicated by + SPY (117P), where 117P is the highest address
spied upon. If DDT and/or PFH (page fault handler) are present, that is
indicated by DDT: 12345-45671, or PFH: 776000-777777. The range of numbers
indicates the core occupied by DDT or PFH.
INFORMATION DISPLAYS Page B-6
PATH
B.13 PATH
This keyword displays information about the jobs default path and path switches.
The information displayed is in the format:
Path: [10,3146,WHO]/SCAN/NEW
The information displayed is the default path ([10,3146,WHO]) and any path
switches, such as /SCAN (scan higher level SFDs and the UFD), /NOSCAN (do not
scan higher level SFDs and the UFDs), /NEW (include NEW when running programs
from SYS), and /SYS (include SYS when running programs from DSK).
B.14 PRIVILEGES
This keyword displays the privileges of the selected jobs. This information is
in the format:
Privileges: 777777,1
DEC: IPCF DPR:3 METER POKE CPU HPQ:15 USPL ENQ RTTRP LOCK TRPSET SPY MSPY
Local: CHGPPN
The information displayed is the octal privilege bits (left half=DEC, right
half=local) (777777,1), and a breakdown of each of the DEC and local privileges
by name.
B.15 SIZE
This keyword displays information about the file size of the opened files for
the selected jobs. This keyword also implies DDBS (see above for a description
of the DDB format). The information displayed is in the format:
Size written: 5 allocated: 30 Created: 3-Mar-81 20:36
The information displayed for each open file is the written size in blocks (size
written: 5), the allocated size in blocks (allocated: 30), and the creation
date and time (Created: 3-Mar-81 20:36).
B.16 SPOOL
This keyword displays information about the spooling status of the selected
jobs. The information displayed is in the format:
Defered spooling: CDR:XYZ, CDP:, LPT: (unspooling allowed)
The information displayed is the spooling mode ("Defered spooling" or just
"Spooling"), the spooled devices (CDR:, CDP:, LPT:), the spooled card reader
name if CDR: is spooled (CDR:XYZ), and the unspooling privilege (unspooling
allowed) if applicable.
INFORMATION DISPLAYS Page B-7
TIME
B.17 TIME
This keyword displays information about the login duration, and date/time and
the RESET UUO duration and date/time. The information displayed is in the
format:
Login for 1:08:29 at Fri 19-Mar-82: 8:25:57
Reset for 0:04:07 at Fri 19-Mar-82: 9:30:19
The information displayed is the time since LOGIN (1:08:29) and the date/time of
LOGIN (Fri 19-Mar-82: 9:30:19) , and the time since last RESET UUO (0:04:07) and
the date/time of the RESET UUO (Fri 19-Mar-82: 9:30:19) .
B.18 TMPCOR
This keyword displays information about the selected jobs TMPCOR file usage.
The information displayed is in the format:
TMPCOR directory:
SVC 6
EDS 3
Total of 9 words in 2 files
The information displayed is the TMPCOR file name (SVC), and the TMPCOR file
size in words (6). A summary line including the total number of words allocated
to TMPCOR files, and the total number of files is also displayed.