Trailing-Edge
-
PDP-10 Archives
-
bb-x130a-sb
-
who.rnm
There is 1 other file named who.rnm in the archive. Click here to see a list.
.LM0;.RM 80;.F
.NNM;.EBB
.FLAG BOLD
##
.SKIP 16
.C;^*WHO MANUAL\*
.SKIP 2
.C;Reflects version 4(162)
.C;June 1982
.SKIP 4
.C;William S. Meier
.C;Digital Equipment Corporation
.C;Internal Software Support Group
.PG
.PAGE
.DISPLAY NUMBER RL
.C;Table of contents for WHO.MAN
.NM 2
.B
.REQUIRE "WHO.RNT"
.FLAG BOLD
.LM 0;.RM 80
.DISPLAY NUMBER D
.STYLE HEADERS 3,1,0
.SUBTITLE JUNK
.AUTOSUBTITLE
.SEND TOC ^*
.CH ^*COMMAND FORMAT\*
_.WHO file=spec !(default JOB mode)
.br;_.WHO:LINE file=spec !(LINE mode)
.br;_.WHO:JOB file=spec !(JOB mode)
.bl 1;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.
.SEND TOC ^*
.HL 1 ^*Specifications\*
SPEC is a list of commands, each separated by commas, optionally
followed by a list of switches.
.br
FILE is a standard file specification, to be used as the output
specification. The default is TTY:WHO.LST[-].
.bl 1
The following specifications have the following switch equivalents:
.ts 8,20;.nf;.nj
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:
.HL 1 ^*Logical operators^\
The following SCAN logical operators can be used by WHO to control
the selection of objects.
.LM+20;.B
.I-12;'OR' Select thing if matches spec A 'OR' spec B
.I-12;'AND' Select thing if matches spec A 'AND' spec B
.I-12;'NOT' Select thing if matches spec A 'NOT' spec B
.LM-20;.B
.SEND TOC ^*
.CH ^*JOB MODE\*
.SEND TOC ^*
.HL 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.
.IF FTCLASS
.HL 2 /ACADEMIC
This switch selects academic jobs. This requires that academic
jobs are defined to be in a scheduler class by themselves.
.ENDIF FTCLASS
.HL 2 /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.
.HL 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.
.IF FTCLASS
.HL 2 /ADMINISTRATION
This switch selects administration jobs. This requires that
administration jobs are defined to be a scheduler class by themselves.
.ENDIF FTCLASS
.IF FTIPC
.HL 2 /AUTODIALER and /NOAUTODIALER
This switch selects jobs that are on an autodialer line. /NOAUTODIALER
selects jobs that are not on autodialer lines.
.ENDIF FTIPC
.IF FTIPC
.HL 2 /BADGE:nn
This switch selects jobs that are logged in with the DEC badge number nn.
.ENDIF FTIPC
.HL 2 /BATCH and /NOBATCH
This switch selects batch jobs running under BATCON, or MIC. /NOBATCH
selects jobs that are not batch jobs.
.HL 2 /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.
.HL 2 /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.
.HL 2 /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:
.B;.LM+20
.IF FTIPC
.I-12;CHGPPN Change PPN (projects .GT. 10) privilege
.ENDIF FTIPC
.IF FTTUFTS
.I-12;COMBO Ability to inquire the combination of the user area
.ENDIF FTTUFTS
.I-12;CPU Ability to change CPU specifications
.I-12;DISK Ability to set disk priority greater than 0
.I-12;ENQ Ability to do privileged ENQ/DEQ functions
.I-12;HPQ Ability to set high priority queue greater than 0
.I-12;IPCF Ability to do IPCF privileged functions
.I-12;LOCK Ability to LOCK in core
.IF FTTUFTS
.I-12;MAGTAPE Ability to acquire magtapes from the loaner pool
.I-12;MAIL Ability to do mail project sends
.ENDIF FTTUFTS
.I-12;METER Ability to use METER UUO
.IF FTTUFTS
.I-12;NAME Ability to change name with /NAME switch to LOGIN
.ENDIF FTTUFTS
.IF FTIPC
.I-12;NETEXAM Ability to do network examines (for NTRACK)
.ENDIF FTIPC
.I-12;POKE Ability to use POKE UUO
.IF FTTUFTS
.I-12;PPASSWORD Ability to change primary password
.ENDIF FTTUFTS
.IF FTMDC
.I-12;PRGRUN Ability to set program to run even if not from SYS:
.ENDIF FTMDC
.I-12;RTTRP Ability to use RTTRP UUO
.IF FTMDC
.I-12;SETP Ability to set "SET P" privilege
.ENDIF FTMDC
.IF FTTUFTS
.I-12;SFD Ability to create SFDS one greater than system limit
.I-12;SPASSWORD Ability to change secondary password
.ENDIF FTTUFTS
.I-12;SPYALL Ability to SPY on all of core
.I-12;SPYMON Ability to SPY on monitor low segment
.I-12;TRPSET Ability to use TRPSET UUO
.I-12;UNSPOOL Ability to unspool spooled devices
.LM-20
.IF FTIPC
.HL 2 /CATEGORY:oo
This switch selects jobs that are in job category oo. OO is an octal
category from 0 to 777.
.ENDIF FTIPC
.IF FTCHARGE
.HL 2 /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.
.ENDIF FTCHARGE
.IF FTIPC
.HL 2 /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.
.ENDIF FTIPC
.HL 2 /CLASS:nn
This switch selects jobs that are in scheduler class nn. NN is a decimal
number from 0 to 31.
.HL 2 /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.
.HL 2 /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.
.HL 2 /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.
.HL 2 /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).
.HL 2 /DIALUP and /NODIALUP
This switch selects jobs that are on dialup terminals. /NODIALUP
selects jobs that are not on dialup terminals.
.HL 2 /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.
.HL 2 /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.
.HL 2 /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).
.HL 2 /DEVICE:ss
This switch selects the job (if any) that has device ss assigned
or inited (opened).
.HL 2 /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.
.HL 2 /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.
.IF FTIPC
.HL 2 /GANDALF and /NOGANDALF
This switch selects jobs that are on gandalf switched lines. /NOGANDALF
selects jobs that are not on gandalf switched lines.
.ENDIF FTIPC
.HL 2 /GLXOPR:key or /GLXOPR
This switch selects jobs that have Galaxy operator privileges. Legal
keys can be one of:
.B;.LM+20
.I-12;HOST Host operator privileges
.I-12;NONE No operator privileges
.I-12;REMOTE Remote operator privileges
.I-12;SYSTEM System operator privileges
.LM-20;.B
If no keyword is present, all jobs with any operator privileges are
selected.
.HL 2 /HARDWIRED and /NOHARDWIRED
This switch selects jobs that are on hardwired lines. /NOHARDWIRED
selects jobs that are not on hardwired lines.
.HL 2 /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.
.HL 2 /JOB:n
This switch selects job n. N is a decimal number greater than 0.
.HL 2 /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:
.B;.LM+20
.I-12;CMDWAIT Jobs waiting to have a command processed
.I-12;DCORE Jobs doing a DCORE command
.I-12;DSKFUL Jobs with DSKFUL PAUSE set
.I-12;JACCT Jobs with JACCT set
.I-12;LOCK Jobs locked in core
.I-12;MONERR Jobs with a monitor detected error
.I-12;OPRWAIT Jobs waiting for operator action
.I-12;RUN Jobs with the run bit set
.I-12;SWAP Jobs swapped out
.I-12;XONLY Jobs that are execute only
.LM-20
.HL 2 /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).
.HL 2 /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.
.IF FTIPC
.HL 2 /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.
.ENDIF FTIPC
.HL 2 /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).
.HL 2 /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.
.HL 2 /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.
.HL 2 /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.
.HL 2 /OPERATOR:key
This switch selects jobs as specified by the key. KEY may be one of
.B;.LM+20
.I-12;LOCAL to select only [1,2] operator jobs
.I-12;NO to select jobs that are neither local or remote operators
.I-12;REMOTE to select only [1nn,2] operator jobs
.I-12;YES to select either local or remote operator jobs
.LM-20
.HL 2 /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.
.IF FTIPC
.HL 2 /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.
.ENDIF FTIPC
.HL 2 /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.
.HL 2 /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:
.B;.LM+20
.IF FTIPC
.I-12;CHGPPN Change PPN (projects .GT. 10) privilege
.ENDIF FTIPC
.IF FTTUFTS
.I-12;COMBO Ability to inquire the combination of the user area
.ENDIF FTTUFTS
.I-12;CPU Ability to change CPU specifications
.I-12;DISK Ability to set disk priority greater than 0
.I-12;ENQ Ability to do privileged ENQ/DEQ functions
.I-12;HPQ Ability to set high priority queue greater than 0
.I-12;IPCF Ability to do IPCF privileged functions
.I-12;LOCK Ability to LOCK in core
.IF FTTUFTS
.I-12;MAGTAPE Ability to acquire magtapes from the loaner pool
.I-12;MAIL Ability to do mail project sends
.ENDIF FTTUFTS
.I-12;METER Ability to use METER UUO
.IF FTTUFTS
.I-12;NAME Ability to change name with /NAME switch to LOGIN
.ENDIF FTTUFTS
.IF FTIPC
.I-12;NETEXAM Ability to do network examines (for NTRACK)
.ENDIF FTIPC
.I-12;POKE Ability to use POKE UUO
.IF FTTUFTS
.I-12;PPASSWORD Ability to change primary password
.ENDIF FTTUFTS
.IF FTMDC
.I-12;PRGRUN Ability to set program to run even if not from SYS:
.ENDIF FTMDC
.I-12;RTTRP Ability to use RTTRP UUO
.IF FTMDC
.I-12;SETP Ability to set "SET P" privilege
.ENDIF FTMDC
.IF FTTUFTS
.I-12;SFD Ability to create SFDS one greater than system limit
.I-12;SPASSWORD Ability to change secondary password
.ENDIF FTTUFTS
.I-12;SPYALL Ability to SPY on all of core
.I-12;SPYMON Ability to SPY on monitor low segment
.I-12;TRPSET Ability to use TRPSET UUO
.I-12;UNSPOOL Ability to unspool spooled devices
.LM-20
.IF FT702
.HL 2 /PRGRUN:ss
This switch selects jobs with program to run set to be ss. SS is a
sixbit word with optional ? and _* wildcarding.
.ENDIF FT702
.HL 2 /PROGRAM:ss
This switch selects jobs whose program name is ss. SS is a sixbit
name with optional ? and _* wildcarding.
.HL 2 /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).
.IF FT702
.HL 2 /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.
.ENDIF FT702
.HL 2 /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).
.IF FT702
.HL 2 /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.
.ENDIF FT702
.HL 2 /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.
.HL 2 /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.
.IF FTMDC
.HL 2 /SETP and /NOSETP
This switch selects jobs who are enabled with ".SET P". /NOSETP selects
jobs that are not enabled with ".SET P"
.ENDIF FTMDC
.HL 2 /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.
.IF FTIPC
.HL 2 /SLOT:nn
This switch selects jobs with an output distribution slot number
nn. NN is a decimal number from 0 to 511.
.ENDIF FTIPC
.HL 2 /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:
.B;.LM+20
.I-12;ACTIVE Select active (running, or otherwise active) jobs
.I-12;CODES Selects jobs in state codes (see S.MAC)
.I-12;EVENTWAIT Select jobs in one of the event wait states
.I-12;IOWAIT Select jobs in an I/O wait state
.I-12;LOCK Select jobs locked in core
.I-12;QUEUES Selects jobs in queues (see S.MAC)
.I-12;RWAITS Selects jobs in resource wait (see S.MAC)
.I-12;RUN Select jobs in a processor run queue
.I-12;SLEEP Select jobs hibernating, sleeping, or napping
.I-12;STOP Select jobs that are stopped
.I-12;SWAP Select jobs that are swapped out
.LM-20
.HL 2 /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)
.HL 2 /SWAP:key
This switch selects the job that the swapper is currently
dealing with. KEY can be one of the following:
.LM+20;.B
.I-12;FIT to select the job trying to be fit into core
.I-12;FORCE to select the job trying to be forced out
.I-12;IN to select the job currently being swapped in
.I-12;OUT to select the job currently being swapped out
.LM-20;.B
.IF FTCLASS
.HL 2 /SYSTEM
This switch selects system jobs. This requires that system
jobs are defined to be in a scheduler class by themselves.
.ENDIF FTCLASS
.IF FTIPC
.HL 2 /TSN and /NOTSN
This switch selects jobs on TSN controlled lines. /NOTSN selects jobs that
are not on TSN controlled lines.
.ENDIF FTIPC
.HL 2 /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).
.HL 2 /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.
.HL 2 /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.
.IF FTIPC
.HL 2 /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.
.ENDIF FTIPC
.HL 2 /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.
.HL 2 /WTO:key or /WTO
This switch selects jobs with the specified WTO (Write To Operator)
privileges. The legal keys are
.B;.LM+20
.I-12;ALL All privileges (WTO and WTOR)
.I-12;NONE No WTO privileges
.I-12;WTO Only WTO privileges
.B;.LM-20
If no key is specified, jobs with any WTO or WTOR privileges are selected.
.SEND TOC ^*
.HL 1 ^*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.
.HL 2 /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.
.HL 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**
.HL 2 /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".
.HL 2 /FAST
This switch displays fast information about the selected jobs. This
information is in the format:
.B
17#MEIER,BILL###TTY43##WHO####R1*
.B
The information displayed is the job number (17), user name (MEIER,BILL),
terminal name (TTY43), program name (WHO), and job state (R1*).
.HL 2 /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.
.HL 2 /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".
.HL 2 /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.
.HL 2 /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,
.IF FT702
time since last RESET UUO,
.ENDIF FT702
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.
.HL 2 /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:
.B;.LM+20
.I-12;ACCOUNT Display jobs account string
.I-12;BATCH Display jobs batch and operator information
.I-12;CAPABILITY Display the jobs DEC and local capability bits
.I-12;CORE Display virtual and physical core limits for the job.
.I-12;CHANNELS Display information about each open channel for the job
.I-12;DDBS Display the DDBS for the job
.I-12;DEFAULTS Display the jobs SET DEFAULT parameters
.I-12;IPCF Display IPCF message statistics and quotas
.I-12;JSL Display the jobs search list and switch settings
.I-12;LOGICAL Display the jobs pathological names
.I-12;MTA Display information about each MTA the job has in use
.I-12;ORIGIN Display the low and high segment origin and version
.I-12;PATH Display the jobs current path
.I-12;PRIVILEGES Display the jobs DEC and local privilege bits
.I-12;SIZE Display information about open file sizes and dates
.I-12;SPOOL Display the spooled devices and spooling status
.IF FT702
.I-12;TIME Displays the jobs logged in and reset time and date.
.ELSE FT702
.I-12;TIME Displays the jobs logged time and date.
.ENDIF FT702
.I-12;TMPCOR Display a directory of the jobs TMPCOR files
.LM-20;.B
For more information about the format of each detailed display, see
Appendix B.
.HL 2 /MAP and /NOMAP
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.
/NOMAP is the default, and doesnt display the line mode information.
.HL 2 /NORMAL
This switch displays normal information about the selected jobs. This
information is in the format:
.B
17#MEIER,BILL#######10,3146##TTY43##WIZARD__1####WHO####26+33#####R2*####0:05:08
.B
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).
.HL 2 /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".
.HL 2 /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.
.HL 2 /PERFORMANCE and /NOPERFORMANCE
This switch displays performance ratios with various fields related
to the job. The current ratios are:
.B;.LM+20
.I-12;DSK/C disk blocks read and written per CPU second of runtime
.I-12;DSK/E disk blocks read and written per elapsed second
.I-12;UUOS/C UUOS executed per CPU second of runtime
.I-12;UUOS/E UUOs executed per elapsed second
.I-12;CPU/E CPU to elapsed time percentage ratio
.LM-20;.B
If /INCREMENTAL is also specified, the performance statistics reflect
the previous incremental interval only, rather than since the job
has been logged in.
.HL 2 /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.
.HL 2 /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.
.HL 2 /SLOW
This switch displays slow information about the selected jobs. This
information is in the format:
.B
17#MEIER,BILL#######10,3146##TTY43##WIZARD__1####WHO####26+33#####R2*####0:05:08
.BR
#####RD:6452###WR:2441###UUOS:32535###JLT:2:19:18###PC:422017#
.B
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).
.HL 2 /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:
.B;.LM+20
.I-12;ACCOUNT Sort by the first five characters of the account string
.I-12;APC Sort by the jobs asynchronous port characteristics
.IF FTIPC
.I-12;BADGE Sort by jobs DEC badge number
.ENDIF FTIPC
.I-12;BATCH Sort by batch job flag (no/yes)
.I-12;BATCORE Sort by jobs batch core maximum
.IF FTIPC
.I-12;CATEGORY Sort by jobs login category
.ENDIF FTIPC
.IF FTCHARGE
.I-12;CHARGE Sort by jobs charge number
.ENDIF FTCHARGE
.IF FTIPC
.I-12;CID Sort by jobs charge ID.
.ENDIF FTIPC
.I-12;CLASS Sort by jobs scheduler class
.I-12;CORE Sort by jobs core size (sum low+high segment)
.I-12;CTLJOB Sort by controlling job number
.I-12;CTLPRG Sort by controlling jobs program name
.I-12;DEFATTACH Sort by jobs default attach setting (yes/no)
.I-12;DEFBUFFER Sort by jobs default number of buffers setting
.I-12;DEFPROTECT Sort by the jobs default protection setting
.I-12;DSKPRIORITY Sort by jobs dsk priority
.I-12;FUNNY Sort by jobs funny page allocation
.I-12;GLXOPR Sort by the jobs galaxy operator privilege
.I-12;HPQ Sort by jobs high priority queue setting
.I-12;IPCFOREC Sort by number of outstanding IPCF receives
.I-12;IPCFOSEND Sort by number of outstanding IPCF sends
.I-12;IPCFQREC Sort by IPCF receive quotas
.I-12;IPCFQSEND Sort by IPCF send quotas
.I-12;IPCFREC Sort by IPCF messages received
.I-12;IPCFSEND Sort by IPCF messages sent
.I-12;JLT Sort by jobs logged in time
.I-12;KCS Sort by jobs kilo-core-seconds
.I-12;LIMIT Sort by jobs batch time limit
.I-12;LINE Sort by jobs terminal line number
.I-12;LOCATION Sort by jobs logically located node
.IF FTIPC
.I-12;LPPN Sort by jobs logged-in PPN (project-programmer number)
.I-12;LPRGNUM Sort by jobs logged-in programmer number
.I-12;LPRJNUM Sort by jobs logged-in project number
.ENDIF FTIPC
.I-12;NAME Sort by the first six characters of the user name
.I-12;NODE Sort by node name where jobs terminal is physically connected
.I-12;NODENAME Sort by node name where jobs terminal is physically connected
.I-12;NODENUMBER Sort by node number where jobs terminal is physically connected
.I-12;PAGERATE Sort by jobs paging rate
.I-12;PC Sort by jobs PC (program counter)
.I-12;PHYHIGH Sort by jobs physical high segment size.
.I-12;PHYLOW Sort by jobs physical low segment size.
.I-12;PPN Sort by jobs PPN (project-programmer number)
.I-12;PRGNUMBER Sort by jobs programmer number only
.IF FT702
.I-12;PRGRUN Sort by program to run
.ENDIF FT702
.I-12;PRJNUMBER Sort by jobs project number only
.I-12;PROGRAM Sort by jobs program name
.I-12;PROSET Sort by jobs default protection set (yes/no)
.I-12;READS Sort by number of disk blocks read
.I-12;REMOTE Sort by jobs remote flag (no/yes)
.IF FT702
.I-12;RESET Sort by jobs RESET time
.ENDIF FT702
.I-12;RUNTIME Sort by jobs CPU runtime
.I-12;SEGMENT Sort by jobs high segment name
.IF FTIPC
.I-12;SLOT Sort by jobs distribution slot
.ENDIF FTIPC
.I-12;TTY Sort by jobs terminal name
.I-12;UUOS Sort by jobs executed UUO count
.I-12;VCORE Sort by jobs virtual core size (sum low+high segments)
.I-12;VIRHIGH Sort by jobs virtual high segment size.
.I-12;VIRLOW Sort by jobs virtual low segment size.
.I-12;VKCS Sort by jobs virtual kilo-core-seconds
.I-12;WRITES Sort by number of disk blocks written
.I-12;WSCODE Sort by jobs wait state code
.I-12;WTO Sort by jobs WTO privileges
.LM-20;.B
If /INCREMENTAL is also specified, and the key is an incremental field,
the sorted order will reflect the intervals incremental values.
.HL 2 /STAMP and /NOSTAMP
This switch displays a date/time stamp at the top of the display of
the selected jobs.
.HL 2 /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.
.B;.LM+20
.I-12;ACCOUNT Summarize by the first five characters of the account string
.I-12;APC Summarize by the jobs asynchronous port characteristics
.IF FTIPC
.I-12;BADGE Summarize by jobs DEC badge number
.ENDIF FTIPC
.I-12;BATCH Summarize by batch job flag (no/yes)
.I-12;BATCORE Summarize by jobs batch core maximum
.IF FTIPC
.I-12;CATEGORY Summarize by jobs login category
.ENDIF FTIPC
.IF FTCHARGE
.I-12;CHARGE Summarize by jobs charge number
.ENDIF FTCHARGE
.IF FTIPC
.I-12;CID Summarize by jobs charge ID.
.ENDIF FTIPC
.I-12;CLASS Summarize by jobs scheduler class
.I-12;CORE Summarize by jobs core size (sum low+high segment)
.I-12;CTLJOB Summarize by controlling job number
.I-12;CTLPRG Summarize by controlling jobs program name
.I-12;DEFATTACH Summarize by jobs default attach setting (yes/no)
.I-12;DEFBUFFER Summarize by jobs default number of buffers setting
.I-12;DEFPROTECT Summarize by the jobs default protection setting
.I-12;DSKPRIORITY Summarize by jobs dsk priority
.I-12;FUNNY Summarize by jobs funny page allocation
.I-12;GLXOPR Summarize by the jobs galaxy operator privilege
.I-12;HPQ Summarize by jobs high priority queue setting
.I-12;IPCFOREC Summarize by number of outstanding IPCF receives
.I-12;IPCFOSEND Summarize by number of outstanding IPCF sends
.I-12;IPCFQREC Summarize by IPCF receive quotas
.I-12;IPCFQSEND Summarize by IPCF send quotas
.I-12;IPCFREC Summarize by IPCF messages received
.I-12;IPCFSEND Summarize by IPCF messages sent
.I-12;JLT Summarize by jobs logged in time
.I-12;KCS Summarize by jobs kilo-core-seconds
.I-12;LIMIT Summarize by jobs batch time limit
.I-12;LINE Summarize by jobs terminal line number
.I-12;LOCATION Summarize by jobs logically located node
.IF FTIPC
.I-12;LPPN Summarize by jobs logged-in PPN (project-programmer number)
.I-12;LPRGNUM Summarize by jobs logged-in programmer number
.I-12;LPRJNUM Summarize by jobs logged-in project number
.ENDIF FTIPC
.I-12;NAME Summarize by the first six characters of the user name
.I-12;NODE Summarize by node name where jobs terminal is physically connected
.I-12;NODENAME Summarize by node name where jobs terminal is physically connected
.I-12;NODENUMBER Summarize by node number where jobs terminal is physically connected
.I-12;PAGERATE Summarize by jobs paging rate
.I-12;PC Summarize by jobs PC (program counter)
.I-12;PHYHIGH Summarize by jobs physical high segment size.
.I-12;PHYLOW Summarize by jobs physical low segment size.
.I-12;PPN Summarize by jobs PPN (project-programmer number)
.I-12;PRGNUMBER Summarize by jobs programmer number only
.IF FT702
.I-12;PRGRUN Summarize by program to run
.ENDIF FT702
.I-12;PRJNUMBER Summarize by jobs project number only
.I-12;PROGRAM Summarize by jobs program name
.I-12;PROSET Summarize by jobs default protection set (yes/no)
.I-12;READS Summarize by number of disk blocks read
.I-12;REMOTE Summarize by jobs remote flag (no/yes)
.IF FT702
.I-12;RESET Summarize by jobs RESET time
.ENDIF FT702
.I-12;RUNTIME Summarize by jobs CPU runtime
.I-12;SEGMENT Summarize by jobs high segment name
.IF FTIPC
.I-12;SLOT Summarize by jobs distribution slot
.ENDIF FTIPC
.I-12;TTY Summarize by jobs terminal name
.I-12;UUOS Summarize by jobs executed UUO count
.I-12;VCORE Summarize by jobs virtual core size (sum low+high segments)
.I-12;VIRHIGH Summarize by jobs virtual high segment size.
.I-12;VIRLOW Summarize by jobs virtual low segment size.
.I-12;VKCS Summarize by jobs virtual kilo-core-seconds
.I-12;WRITES Summarize by number of disk blocks written
.I-12;WSCODE Summarize by jobs wait state code
.I-12;WTO Summarize by jobs WTO privileges
.LM-20;.B
If /INCREMENTAL is also specified, and the key is an incremental field,
the summary display will reflect the intervals incremental values.
.HL 2 /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.
.HL 2 /VFAST
This switch displays very fast information about the selected jobs.
This information is in the format:
.B
MEIER,BILL###TTY43
.B
The information displayed is user name (MEIER,BILL) and terminal
name (TTY43).
.SEND TOC ^*
.CH ^*LINE MODE\*
.SEND TOC ^*
.HL 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.
.IF FTIPC
.HL 2 /AUTODIALER and /NOAUTODIALER
This switch selects lines that have autodialers. /NOAUTODIALER
selects lines that don't have autodialers.
.ENDIF FTIPC
.HL 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.
.HL 2 /CARRIER and /NOCARRIER
This switch selects lines that are dialup lines with carrier
present. /NOCARRIER selects lines that are dialup but without
carrier present.
.HL 2 /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).
.HL 2 /DIALUP and /NODIALUP
This switch selects lines that are dialup lines. /NODIALUP selects
lines that are not dialup lines.
.IF FTIPC
.HL 2 /GANDALF and /NOGANDALF
This switch selects gandalf switched lines. /NOGANDALF
selects jobs that are not gandalf switched lines.
.ENDIF FTIPC
.HL 2 /HARDWIRED and /NOHARDWIRED
This switch selects hardwired lines. /NOHARDWIRED
selects lines that are not hardwired.
.HL 2 /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.
.HL 2 /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.
.HL 2 /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).
.HL 2 /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.
.IF FTLGNQ
.HL 2 /LOGINQ and /NOLOGINQ
This switch selects lines that are waiting in the login queue.
/NOLOGINQ selects lines that are not in the waiting to login queue.
.ENDIF FTLGNQ
.HL 2 /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.
.HL 2 /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.
.HL 2 /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.
.IF FTPOWER
.HL 2 /POWER and /NOPOWER
This switch selects non-dialup lines that are connected to terminals that
are powered on. /NOPOWER selects non-dialup lines connected to
terminals that are not powered on.
.ENDIF FTPOWER
.HL 2 /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).
.HL 2 /RCVSPEED:n
This switch selects lines that have a receive speed of n baud.
.HL 2 /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).
.HL 2 /SLAVE and /NOSLAVE
This switch selects lines that are slaved and cannot type commands
to the monitor. /NOSLAVE selects lines that are not slaved.
.HL 2 /SPEED:n
This switch selects lines whose transmit and receive speed are both
equal to n baud.
.IF FTIPC
.HL 2 /TSN and /NOTSN
This switch selects TSN controlled lines. /NOTSN selects lines that
are not TSN controlled.
.ENDIF FTIPC
.HL 2 /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).
.HL 2 /TYPE:ss
This switch selects lines whose terminal type is ss. SS is a sixbit
word with optional ? and _* wildcarding.
.HL 2 /USER and /NOUSER
This switch selects lines that are controlling a job (user). /NOUSER
selects lines that are not controlling a job.
.HL 2 /XMTSPEED:n
This switch selects lines that have a transmit speed of n baud.
.SEND TOC ^*
.HL 1 ^*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.
.HL 2 /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**
.HL 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.
.HL 2 /FAST
This switch displays fast information about the selected lines. This
information is in the format:
.B
TTY43##WIZARD###1#RDC#####A#U#job#17
.B
The information displayed is terminal name (TTY43), node name (WIZARD),
line number (1), flags (RDC), and job control information (A U job 17).
.HL 2 /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.
.HL 2 /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.
.HL 2 /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:
.B;.LM+20
.I-12;TTY Display all terminal parameters like INITIA TTY command
.LM-20
.HL 2 /MAP and /NOMAP
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.
/NOMAP is the default, and doesnt display the job mode information.
.HL 2 /NORMAL
This switch displays normal information about the selected lines. This
information is in the format:
.B
TTY43##WIZARD###1#Dataset#-#1281#####RDC###VT52#####600##300##A#U#job#17
.B
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).
.HL 2 /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.
.HL 2 /PERFORMANCE and /NOPERFORMANCE
This switch displays performance ratios with various fields related
to the line. The current ratios are:
.B;.LM+20
.I-12;O/I Output to input character count ratio
.I-12;ICC/E Input characters typed per elapsed second
.I-12;OCC/E Output characters displayed per elapsed second
.I-12;BRK/EM Break characters typed per elapsed minute
.I-12;CMD/EM Commands typed per elapsed minute
.LM-20;.B
If /INCREMENTAL is also specified, the performance statistics reflect
the previous incremental interval only, rather than since the line
has connected.
.HL 2 /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.
.HL 2 /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.
.HL 2 /SLOW
This switch displays slow information about the selected lines. This
information is in the format:
.B
TTY43##WIZARD###1#Dataset#-#1281#####RDC###VT52#####600##300##A#U#job#17
.BR
#####ICC:44234##OCC:737227##BRK:4166##CMD:1211
.B
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).
.HL 2 /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:
.B;.LM+20
.I-12;APC Sort by asynchronous port characteristics
.I-12;ASSIGN Sort by assigned flag (no/yes)
.I-12;BREAK Sort by break character count
.I-12;CARRIER Sort by carrier flag (no/yes)
.I-12;COMMANDS Sort by commands typed
.I-12;DIALUP Sort by dialup flag (no/yes)
.I-12;INITED Sort by inited flag (no/yes)
.I-12;INPUT Sort by input character count
.I-12;JOB Sort by job using line
.I-12;LINE Sort by line
.IF FTLGNQ
.I-12;LOGINQ Sort by login queue position
.ENDIF FTLGNQ
.I-12;NODE Sort by node name
.i-12;NODENAME Sort by node name
.I-12;NODENUMBER Sort by node number
.I-12;OUTPUT Sort by output character count
.I-12;RCVSPEED Sort by receive speed
.I-12;REMOTE Sort by remote flag (no/yes)
.I-12;SLAVE Sort by slave flag (no/yes)
.I-12;TYPE Sort by terminal type
.I-12;USER Sort by user flag (no/yes)
.I-12;XMTSPEED Sort by terminal transmit speed
.LM-20;.B
If /INCREMENTAL is also specified, and the key is an incremental field,
the sorted order will reflect the intervals incremental values.
.HL 2 /STAMP and /NOSTAMP
This switch displays a date/time stamp at the top of the display of
the selected lines.
.HL 2 /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.
.B;.LM+20
.I-12;APC Summarize by asynchronous port characteristics
.I-12;ASSIGN Summarize by assigned flag (no/yes)
.I-12;BREAK Summarize by break character count
.I-12;CARRIER Summarize by carrier flag (no/yes)
.I-12;COMMANDS Summarize by commands typed
.I-12;DIALUP Summarize by dialup flag (no/yes)
.I-12;INITED Summarize by inited flag (no/yes)
.I-12;INPUT Summarize by input character count
.I-12;JOB Summarize by job using line
.I-12;LINE Summarize by line
.IF FTLGNQ
.I-12;LOGINQ Summarize by login queue position
.ENDIF FTLGNQ
.I-12;NODE Summarize by node name
.i-12;NODENAME Summarize by node name
.I-12;NODENUMBER Summarize by node number
.I-12;OUTPUT Summarize by output character count
.I-12;RCVSPEED Summarize by receive speed
.I-12;REMOTE Summarize by remote flag (no/yes)
.I-12;SLAVE Summarize by slave flag (no/yes)
.I-12;TYPE Summarize by terminal type
.I-12;USER Summarize by user flag (no/yes)
.I-12;XMTSPEED Summarize by terminal transmit speed
.LM-20;.B
If /INCREMENTAL is also specified, and the key is an incremental field,
the summary display order will reflect the intervals incremental values.
.HL 2 /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.
.HL 2 /VFAST
This switch displays very fast information about the selected lines.
This information is in the format:
.br
TTY43##WIZARD###1
.br
The information displayed is terminal name (TTY43), node name (WIZARD),
and line number (1).
.SEND TOC ^*
.CH ^*FORMATTING THE DISPLAY^\
WHO provides the sophisticated user with complete control of the
output display. The exact formats of the display line, as well as
optional headings and footings can be specified.
.HL 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.
.HL 1 ^*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.
.HL 2 /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 WHO.
.HL 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.
.HL 2 /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.
.HL 2 /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.
.HL 2 /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.
.HL 1 ^* 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.
.HL 2 /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.
.HL 2 /DEFAULT
This default format control switch selects that the default justification
be used for each field.
.HL 2 /FIX
This default format control switch forces all fields to be output in
strict, fixed length columnized areas.
.hl 2 /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.
.SEND TOC ^*
.CH ^*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).
.B
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.
.B
In all cases except for /NETWORK:CONNECT the action is performed
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.
.hl 1 ^*Input/Output functions\*
.HL 2 /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:
.B;.LM+20
.I-12;_.HALT Force a _^C (stop the stop with control-C trapping)
.I-12;_.BYE Detach the job
.I-12;_.HELLO Run the INITIA program
.I-12;_.RESTA Type the system restart greeting
.I-12;_KJOB Log the job out
.I-12;_INITIA Run the INITIA program
.I-12;_.FCONT Force a CONTINUE
.I-12;_.TYPE Retype the line (control-R)
.I-12;_USESTA Type statistics (control-T)
.I-12;_.NETLDR Force run the NETLDR program
.I-12;_HALT HALT the job regardless of control-C trapping
.I-12;_CTEST Force a CTEST command (for patching)
.LM-20;
.HL 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.
.HL 2 /OUTPUT:"string"
This switch outputs the "string" on the terminal. Control characters
can be imbedded by inserting them in up-arrow form.
.HL 2 /SEND:"string"
This switch outputs the "string" on the terminal, prefixed with
the standard "<bell>;;TTYnnn - " leader.
.hl 1 ^*Network functions\*
.HL 2 /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.
.HL 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.
.HL 1 ^*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).
.HL 2 CPU:n
This argument sets the CPU runability for the selected jobs to CPU n.
(.SET RUN CPUn ONLY)
.HL 2 DEFAULT:BUFFERS:n
This argument sets the default number of disk buffers for the job
to N (.SET DEFAULT BUFFERS n).
.IF FTTUFTS
.HL 2 DEFAULT:EDITOR:key
This argument sets the default editor for the selected jobs. Key may
be either DEC to run the standard editors (SOS or TECO), or EXPERIMENTAL
to run the new editors (XSOS or XTECO). (.SET DEFAULT EDITOR key)
.HL 2 DEFAULT:DESTINATION:n
This argument sets the default output delivery destination to location
n. (.SET DEFAULT DESTINATION n)
.ENDIF FTTUFTS
.HL 2 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)
.HL 2 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).
.HL 2 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).
.HL 2 LIMIT:hh:mm:ss
This argument sets the batch time limit for the selected jobs to
hh:mm:ss.
.HL 2 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).
.HL 2 TIME:hh:mm:ss
This argument sets the batch time limit for the selected jobs to
hh:mm:ss.
.HL 2 VIRTUAL:n
This argument sets the virtual core limit to n pages for the selected
jobs. (.SET VIRTUAL n)
.HL 2 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.
.SEND TOC ^*
.CH ^*OUTPUT FILE CONTROL^\
.HL 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[-].
.HL 1 ^*Switches^\
The following switches may be placed on the output file specification
to control it.
.HL 2 /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.
.HL 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.
.hl 2 /OKSUPERSEDE
This switch allows the output file to be superseded, if it exists.
This also is the default action.
.HL 2 /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.
.HL 2 /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.
.SEND TOC ^*
.AX ^*JOB STATE CODES\*
The following wait state codes may be output for the jobs wait
state. The format of the output is XX*YY* 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:
.BL 1;State Explanation
.BL 1
.BR;AU Alter disk UFD queue
.BR;B1 Running background batch in PQ1
.BR;B2 Running background batch in PQ2
.BR;CA Semi-permanent core allocation wait
.BR;CB Disk core-block scan wait
.BR;D1 Dectape control wait (up to 8 drives)
.BR;D2 Second DECtape controler wait
.BR;DA Disk storage allocation wait
.BR;DC Data control (DC) wait - magtape and dectape
.BR;DI Disk input wait
.BR;DO Disk output wait
.BR;DS Disk I/O wait satisfied
.BR;DW Disk I/O wait
.BR;E6 Event wait (DN60)
.BR;EF Event wait (front ends)
.BR;EI Event wait (IPCF)
.BR;EK Event wait (tape kontroller)
.BR;EL Event wait (tape labeling)
.BR;EN Event wait (networks)
.BR;EQ ENQ/DEQ wait
.BR;ER Event wait (tape rewinding)
.BR;ES Event wait satisfied
.BR;EV Exec virtual memory wait
.BR;EW General event wait
.BR;EW Job in event wait
.BR;GU GETSEG UUO in progress
.BR;HB Hibernate (no sleep time)
.BR;HS Hibernate with sleep time
.BR;Hd Running in HPQ d
.BR;IO IO wait
.BR;JD Waiting for DAEMON to be run
.BR;LK Locked in core
.BR;MM Memory management wait
.BR;NA Job napping (.lt. 1 sec sleep)
.BR;NU Job number not assigned
.BR;OW Operator wait
.BR;PI Paging I/O wait
.BR;PS Paging I/O wait satisfied
.BR;R1 Running in PQ1
.BR;R2 Running in PQ2
.BR;RN Running
.BR;RU Run UUO in progress
.BR;SF Swapped and fragmented
.BR;SL Sleeping
.BR;SW Swapped out
.BR;TI TTY input wait
.BR;TO TTY output wait
.BR;TS TTY I/O wait satisfied
.BR;TW TTY I/O wait
.BR;WI General input wait
.BR;WO General output wait
.BR;WS I/O wait satisfied
.BR;_^C Job stopped
.BR;_^D Job in DAEMON DCORE wait
.BR;_^S Job in TO and output stopped with control-S or page limit exceeded
.BR;_^W Job in command wait
.AX ^*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.
.HL 1 ACCOUNT
This keyword displays the account string for the selected jobs. This
information is in the format:
.B
#####Account:#6PFS.C684422
.B
The information displayed is the account string (6PFS.C684422).
.HL 1 BATCH
This keyword displays batch and operator information for the selected jobs.
This information is in the format:
.b
####WTO#privs:all##OPR#privs:system##Batch#stream:no##Limit:0:09:45#Core:511
.b
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).
.HL 1 CAPABILITIES
This keyword displays the enabled capabilities of the selected jobs. This
information is in the format:
.B1
#####Capabilities:#777777,1
######DEC:#IPCF#DPR:3#METER#POKE#CPU#HPQ:15#USPL#ENQ#RTTRP#LOCK#TRPSET#SPY#MSPY#
######Local:#CHGPPN#
.B1
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.
.HL 1 CHANNEL
This keyword displays information about all open channels for the
selected jobs. This information is in the format:
.B
###2##DSK#########14######OO######OB######E#######O###IC######
.B
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:
.LM+20;.B
.I-12;OI Opened with input buffer specified
.I-12;OO Opened with output buffer specified
.I-12;IB Input buffers have been setup
.I-12;OB Output buffers have been setup
.I-12;L LOOKUP has been done
.I-12;E ENTER has been done
.I-12;I INPUT has been done
.I-12;O OUTPUT has been done
.I-12;IC Input close has been done (or not needed)
.I-12;OC Output close has been done (or not needed)
.LM-20
.HL 1 CORE
This keyword displays the current and maximum physical and virtual core
limits for the selected jobs. This information is in the format:
.b
.br;#####Core#limits:##Current:#Virt:200#Phys:120##Maximum:#Virt:512#Phys:300
.b
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.
.HL 1 DDBS
This keyword displays information about all open devices for the
selected jobs. This information is in the format:
.b
.br;_*#TTY104##A######node#WIZARD(123)#line#45#####################################R
.BR;##LPT773##I######node#SOFDCP(77)#unit#3#######################################W
.br;##MTA710##A###MTA0####reelid:COBOL#file#11#record#45#######################WE/W
.br;##DSK#####I###########DSKE0:PROJCT.SYS[10,7,GALAXY,ACT]#################1###U/R
.br;##ACT#####I###DEVIN###DSKE0:SYSDEV.BIN[1,7]###################################R
.br;##TSK71###I###########I:#_*::FTSFAL[1,2]#P:#TWINKY::NETSPL[1,2]################R
.B
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).
.HL 2 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 "!".
.HL 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].
.HL 2 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.
.hl 2 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.
.HL 2 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.
.HL 1 DEFAULTS
This keyword displays the various SET DEFAULT parameters for the selected
jobs. This information is in the format:
.B1
#####Defaults:#Buffers:10###Protection:_<077_>On##Attach:Ask
.B1
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).
.HL 1 IPCF
This keyword displays IPCF statistics for the selected jobs. This
information is in the format:
.B
##IPCF#messages:#S:12##R:7##outstanding:#S:1##R:0##quotas:#S:100#R:50
.b
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).
.hl 1 JSL
This keyword displays the job search list and switches for the selected jobs.
The information displayed is in the format:
.B
#####Job#search#list:##TSG0:/NOWRITE,#SOFT:,#FENCE,#DSKE:/NOCREATE
.B
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.
.HL 1 LOGICAL
This keyword displays the pathological names defined for the selected
jobs. This information is in the format:
.b
.BR;#####Logical#name#definitions:
.BR;######SYS:#=#DSKQ:[10,3146,SYS],SSL:[1,5],SSL:[1,4]
.BR;######LIB:/SEARCH#=#DSKQ:[10,3146,LIB]
.BR;######WSM:#=#DSKQ:[10,3146]
.B
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]).
.HL 1 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:
.B 1
#####Density:1600##Track:9##Mode:DEC core dump##Labels:ANSI
.B1
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].
.HL 1 ORIGIN
This keyword displays the program origin and version for both the
high segment and low segment. The information displayed is in the
format:
.b
###Origin:#DSKQ:QUASAR[1,4,QSR]#4(761)/1(5)#+#DSKE:GLXLIB[1,4]#1(763)
.B
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.
.HL 1 PATH
This keyword displays information about the jobs default path and
path switches. The information displayed is in the format:
.B
#####Path: [10,3146,WHO]/SCAN/NEW
.B
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).
.HL 1 PRIVILEGES
This keyword displays the privileges of the selected jobs. This
information is in the format:
.B1
#####Privileges:#777777,1
######DEC:#IPCF#DPR:3#METER#POKE#CPU#HPQ:15#USPL#ENQ#RTTRP#LOCK#TRPSET#SPY#MSPY#
######Local:#CHGPPN#
.B1
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.
.hl 1 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:
.b
#####Size#written:#5#allocated:#30#Created:##3-Mar-81#20:36
.B
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).
.HL 1 SPOOL
This keyword displays information about the spooling status of
the selected jobs. The information displayed is in the format:
.b
#####Defered#spooling:#CDR:XYZ,#CDP:,#LPT:#(unspooling#allowed)
.b
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.
.HL 1 TIME
This keyword displays information about the login duration, and
.IF FT702
date/time and the RESET UUO duration and date/time.
.ELSE FT702
date/time.
.ENDIF FT702
The information displayed is in the format:
.b
.br;#####Login#for#1:08:29#at#Fri#19-Mar-82:#8:25:57
.IF FT702
.BR;#####Reset#for#0:04:07#at#Fri#19-Mar-82:#9:30:19
.ENDIF FT702
.B
The information displayed is the time since LOGIN (1:08:29) and the
date/time of LOGIN (Fri#19-Mar-82:#9:30:19)
.IF FT702
, 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)
.ENDIF FT702
_.
.HL 1 TMPCOR
This keyword displays information about the selected jobs TMPCOR file
usage. The information displayed is in the format:
.B
.BR;#####TMPCOR#directory:
.BR;########SVC####6
.BR;########EDS####3
.BR;#####Total#of#9#words#in#2#files
.b
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.