Google
 

Trailing-Edge - PDP-10 Archives - BB-FP64A-SB_1986 - 10,7/who/who.hlp
There are 6 other files named who.hlp in the archive. Click here to see a list.
WHO HELP FILE           version 4(157)                          May 1982



1.0  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:



2.0  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.

/ACCOUNT:"string"   selects jobs with given wildcarded accoutn string
/[no]ACTIVE         selects jobs that are [not] active
/[no]AUTODIALER     selects jobs on autodialer lines
/BADGE:nn           selects jobs with DEC badge number nn
/[no]BATCH          selects jobs that are [not] batch jobs
/[no]BBATCH         selects jobs that are [not] in the background batch class
/BEFORE:date:time   selects jobs logged in before date/time
/CAPABILITY:(key,key) selects jobs with the capabilities specified
/CATEGORY:oo        selects jobs in category oo
/CHARGE:ss          selects jobs with wildcarded change ss
/CID:ss             selects jobs with wildcarded charge ID ss
/CLASS:nn           selects job in scheduler class nn
/CORE:nn:mm         selects jobs with core size nn to mm pages
/CTLJOB:nn          selects jobs controlled by job nn
/CTLPRG:ss          selects jobs controlled by wildcarded program ss
/[no]CTY            selects the jobs [not] on the CTY
/[no]DIALUP         selects jobs that are [not] on dialup terminals
/DDB:filespec       selects jobs with a DDB for wildcarded filespec
/[no]DDT            selects jobs that do [not] have DDT in their address space
/[no]DETACH         selects jobs that are [not] detached
/DEVICE:ss          selects job using device ss
/DSKPRIORITY:n      selects jobs with dsk priority n
/FILE:filespec      selects jobs with a DDB for wildcarded filespec
/[no]GANDALF        selects jobs [not] on gandalf switched terminals
/GLXOPR:key         selects jobs with galaxy operator privileges
/[no]HARDWIRED      selects jobs [not] on hardwired terminals
/HPQ:n              selects jobs running in HPQ n
/JOB:n              selects job n
/JSTATUS:(key,key)  selects jobs with specified job status bits
/[no]LOCAL          selects jobs [not] on local terminals
/LOCATE:oo          selects jobs located to node oo
/LPPN:[p,pn]        selects jobs with logged in PPN specified
/MOUNT:ss           selects jobs with structure ss mounted
/NAME:"ss"          selects jobs with user name ss
/NODE:ss_ll         selects jobs on node ss line ll
/NOOPERATOR         selects jobs that are not operators
/OPERATOR:key       Selects jobs that are operator jobs
/[no]PFH            selects jobs that do [not] have PFH in their address space
/[no]PIVOTED        selects jobs that are [not] pivoted into another PPN
/PPN:[p,pn]         selects jobs with wildcarded PPN specified
/PRIVILEGE:(key,key) selects jobs with the specified privileges
/PRGRUN:ss          selects jobs with program to run set to ss
/PROGRAM:ss         selects jobs running wildcarded program ss
/[no]PTY            selects jobs [not] on PTYs
/RBEFORE:date:time  selects jobs who have RESET before date/time
/[no]REMOTE         selects jobs [not] on remote terminals
/RSINCE:date:time   selects jobs who have RESET since date/time
/SEGMENT:ss         selects jobs with wildcarded high segment name ss
/[no]SELF           selects jobs who are [not] logged in with your PPN
/SINCE:date:time    selects jobs logged in since date/time
/SLOT:nn            selects jobs with output distribution slot nn
/STATE:(key,key)    selects jobs with job state keys
/STREAM:n           selects jobs in batch stream n (Galaxy 4.1 only)
/SWAP:key           selects jobs with the swap key status
/[no]TSN            selects jobs [not] on TSN controlled lines
/[no]TTY            selects jobs [not] running on TTYs
/VCORE:nn:mm        selects jobs with virtual core size nn to mm pages
/[no]VM             selects jobs that are [not] virtual
/[no]WHEELED        selects jobs that are [not] wheeled into [1,2]
/WSCODE:ss          selects jobs with wait state code ss
/WTO:key            selects jobs with specified Write To Operator privileges



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.

/DDBS               display the DDBs for the selected jobs
/DPY:n:m            display in DPY video terminal mode m times every n seconds
/ERNONE             display error if no jobs match selection criterion
/FAST               display fast typeout information
/FILES              display DDBS for selected jobs
/FORMAT:(format-list) display specified format list for selected jobs
/INCLUDE:key        display addition information specified by key
/[no]INCREMENTAL    do [not] display incremental values when repeating
/INFORMATION:keys   display addition information as specified by key
/[no]MAP            do [not] display line mode information for selected jobs
/NORMAL             displays normal typeout information
/OKNONE             do not display error if no jobs match selection criterion
/[no]ORIGIN         do [not] display program low and high segment origin
/[no]PERFORMANCE    do [not] display various performance ratio figures
/[no]PRINT          do [not] print the job line information
/REPEAT:N:M         display information m times every n seconds
/SLOW               display slow typeout information
/SORT:key:x:n       sort n jobs with key "key" in order x
/[no]STAMP          do [not] display a date/time stamp at the start
/SUMMARY:key        display a summary of jobs by key
/[no]TOTALS         do [not] display "Total of n jobs" line
/VFAST              display very fast typeout information



3.0  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.

/[no]AUTODIALER     selects lines that are [not] autodialers
/[no]ASSIGN         selects lines that are [not] assigned by a job
/[no]CARRIER        selects lines that do [not] have carrier present
/[no]CTY            selects lines that are [not] the CTY line
/[no]DIALUP         selects lines that are [not] dialup lines
/[no]GANDALF        selects lines that are [not] gandalf switched lines
/[no]HARDWIRED      selects lines that are [not] hardwired lines
/[no]INITED         selects lines that are [not] inited by a job
/JOB:n              selects lines in use by job n
/[no]LOCAL          selects lines that are [not] local lines
/LOCATE:"string"    selects lines with specified wildcarded location string
/[no]MIC            selects lines that are [not] controlled by MIC
/NODE:ss_ll         selects line ll on node ss
/PHONE:"aa"         seelcts dialup lines with wildcarded phone string aa
/[no]PTY            selects lines that are [not] PTY liens
/RCVSPEED:n         selects lines with receive speed of n baud
/[no]REMOTE         seelcts lines that are [not] remote lines
/[no]SLAVE          selects lines that are [not] slaved
/SPEED:n            selects lines with transmit and receive speed of n baud
/[no]TSN            selects lines that are [not] TSN controlled lines
/[no]TTY            selects liens that are [not] TTY lines
/TYPE:ss            selects lines with wildcarded terminal type ss
/[no]USER           selects lines that are [not] controlling a job
/XMTSPEED:n         selects lines with transmit speed of n baud



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.

/DPY:n:m            display in DPY video terminal mode m times every n seconds
/ERNONE             display error of on lines match selection criterion
/FAST               display fast typeout information
/INCLUDE:key        include lines by specified key
/[no]INCREMENTAL    do [not] display incremental values when repeating
/INFORMATION:keys   display additional information as specified by key
/[no]MAP            do [not] display job mode information for specified lines
/NORMAL             display normal typeout information
/OKNONE             do not display error if no lines match selection criterion
/[no]PERFORMANCE    do [not] display various performance ratio figures
/[no]PRINT          do [not] print the line line information
/REPEAT:N:M         display information m times every n seconds
/SLOW               display slow typeout information
/SORT:key:x:n       sort n lines with key "key" in order x
/[no]STAMP          do [not] display a date/time stampe at the start
/SUMMARY:key        display a summary of lines by key
/[no]TOTALS         do [not] display "Total of n lines" line
/VFAST              display very fast typeout information



4.0  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.



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.

/FINAL:(format-list) output format-list once at end of output
/FOOTING:(format-list) output format-list at the end of each specification
/HEADING:(format-list) output format-list at the beginning of each specification
/INITIAL:(format-list) output format-list once at beginning of output
/FORMAT:(format-list) output format-list for each object selected



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.

/BLANK              suppress output of completely blank fields
/DEFAULT            use default format control
/FIX                force all output in fixed columns
/FLOAT              separate all fields with a single space only



5.0  ACTION SWITCHES

The following action switches may be used to force various things 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  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.



5.1  Input/Output Functions


/FORCE:command      use FRCUUO to force command on object
/INPUT:"string"     input string into objects input buffer
/OUTPUT:"string"    output string into objects output buffer
/SEND:"string"      simulate send command with string to terminal



5.2  Network Functions

/NETWORK:CONNECT    connect the specified terminals to the host system
/NETWORK:DISCONNECT sends a network disconnect message to object



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).

CPU:n This argument sets the CPU runability for the  selected  jobs  to  CPU  n.
                    (.SET RUN CPUn ONLY)
DEFAULT:BUFFERS:n This argument sets the default number of disk buffers for  the
                    job to N (.SET DEFAULT BUFFERS n).
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)
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).
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).
LIMIT:hh:mm:ss This argument sets the batch time limit for the selected jobs  to
                    hh:mm:ss.
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).
TIME:hh:mm:ss This argument sets the batch time limit for the selected  jobs  to
                    hh:mm:ss.
VIRTUAL:n This argument sets the virtual core limit to n pages for the  selected
                    jobs.  (.SET VIRTUAL n)
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.



6.0  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.

/[no]APPEND         do [not] append to the existing output file
/ERSUPERSEDE        generate error if superseding output file
/OKSUPERSEDE        dont generate error if superseding output file
/PROTECTION:n       set the protection of the output file to n
/VERSION:x          set the version of the output file to x