.NF
.RM 64
.NONUMBER
.NOPAGING
! Help file for NAMES.MAR, a utility to find out useful
! information about logged in processes.
!
!            Kevin Carosso
!         Harvey Mudd College
!           December 4, 1981
!
.F
1 NAMES
.BR
The NAMES utility is a system program to print out useful
information about current processes. The program may be run
with the following command:
.SK 1
.I 10
_$ RUN TOOLS:NAMES.EXE
.SK 1
In order to specify alternate qualifiers and parameters within
the command line, however, you must create a symbol of the
form:
.SK 1
.I 10
_$ NAMES :== $TOOLS:NAMES.EXE
.SK 1
The full command specification for the NAMES utility is then
.SK 1
.I 10
_$ NAMES [name[,name...]]
.BR
!
.BR
2 Defaults
.BR
The NAMES utility contains a set of default parameters that
determine what information is to be presented if no user-specified
options are supplied. These defaults may be turned off and on
with the /DEFAULT and /NODEFAULT qualifiers. The equivalent set
of qualifiers is:
.SK 1
_$ NAMES/NODEFAULTS/HEADER/ALL/JOB:INTER/PID/TERM/UIC-
.BR
_$__/STATE/BASE/CURRENT/PROCESS__NAME/IMAGE__NAME
.BR
!
.BR
2 Parameters
.BR
.I 10
[name[,name...]]
.SK 1
You may optionally supply zero or more parameters to the
NAMES command. These may be either terminal names, abbreviated
terminal names, or usernames. For example:
.SK 1
.LM +29
.I -24
_$ NAMES TTD7############Returns information for any process
currently logged in on the terminal TTD7.
.I -24
_$ NAMES SYSTEM,TTA######Returns information for any process
with the username of SYSTEM or logged in on any TTAn terminal.
.LM -29
.BR
!
.BR
2 Qualifiers
.BR
!
.BR
/ALL (D)
.BR
/SYSTEM
.BR
/NOSYSTEM
.LM +2
.SK 1
Specifies whether or not system jobs are to be displayed.
System jobs are any that have a UIC with a group number
less than [10,*]. If ALL is specified, then both system and
non-system jobs will be displayed.
.LM -2
.SK 2
!
.BR
/BASE__PRIORITY (D)
.BR
/NOBASE__PRIORITY
.LM +2
.SK 1
Display process base priority.
.LM -2
.SK 2
!
.BR
/CURRENT__PRIORITY (D)
.BR
/NOCURRENT__PRIORITY
.LM +2
.SK 1
Display process current priority.
.LM -2
.SK 2
!
.BR
!
.BR
/DEFAULTS (D)
.BR
/NODEFAULTS
.LM +2
.SK 1
This restores the options list to the initial default list.
The NODEFAULTS option will turn off all default options in the
current item list.
.LM -2
.SK 2
!
.BR
/HEADER (D)
.BR
/NOHEADER
.LM +2
.SK 1
Display an information header. This includes a count of the
number of interactive jobs, total processes on the system, and
the current date and time. In addition, column headers are supplied
to delineate information in the display list.
.LM -2
.SK 2
!
.BR
/IMAGE__NAME (D)
.BR
/NOIMAGE__NAME
.LM +2
.SK 1
Display the current image being executed by a process. An asterisk,
"*", in front of the name indicates an installed image.
.SK 1
.LM +6
.I -6
Note: In order to obtain a process' image name, NAMES must issue
a kernel mode AST to the process in question. On a loaded system this
may take some time, as NAMES must wait for the process to get some
runtime. If the IMAGE__NAME option is not specified, the program will not
need to wait for this.
.LM -6
.LM -2
.SK 2
!
.BR
/JOB__TYPE=(type [,...]) (D = INTERACTIVE)
.LM +2
.SK 1
Specifies what type of job is to be displayed. If more than one
type of job is to be specified, separate the type names by
commas, ",", and surround them with parentheses, "()". The job types
available are:
.SK 1
.NF
.LM +5
ALL#############Display all jobs.
BATCH###########Display batch jobs.
DETACHED########Display detached jobs.
INTERACTIVE#####Display interactive (terminal) jobs.
SUBPROCESS######Display subprocesses.
.F
.BR
.LM -5
.LM -2
.SK 2
!
.BR
/OWNER__PID
.BR
/NOOWNER__PID
.LM +2
.SK 1
Display the PID of the owner process of a subprocess. This will
be blank if we are not looking at a subprocess.
.LM -2
.SK 2
!
.BR
/PID (D)
.BR
/NOPID
.LM +2
.SK 1
Display the process identification of the job.
.LM -2
.SK 2
!
.BR
/PROCESS__NAME (D)
.BR
/NOPROCESS__NAME
.LM +2
.SK 1
Display the process name for the job.
.LM -2
.SK 2
!
.BR
/SORT=item (D=TERMINAL)
.LM +2
.SK 1
Specify which item field to sort on before output.
The following items may be specified:
.SK 1
.LM +10
.NF
BASE__PRIORITY
CURRENT__PRIORITY
PID
PROCESS__NAME
STATE
TERMINAL
UIC
USERNAME
.LM -10
.F
.LM -2
.SK 2
!
.BR
/STATE (D)
.BR
/NOSTATE
.LM +2
.SK 1
Display the current state of the process.
The various states are:
.SK 1
.LM +5
.NF
COL
PG
MWAIT
CEF
PFW
LEF
LEFO
HIB
HIBO
SUSP
SUSPO
FPG
COM
COMO
CUR
.LM -5
.F
.LM -2
.SK 2
!
.BR
/TERMINAL (D)
.BR
/NOTERMINAL
.LM +2
.SK 1
Display the terminal name of interactive jobs. Subprocesses and
batch jobs will be marked as such. Detached jobs will be blank.
.LM -2
.SK 2
!
.BR
/UIC (D)
.BR
/NOUIC
.LM +2
.SK 1
Display the User Identification Code of the process.
.LM -2
.SK 2
!
.BR
/USERNAME
.BR
/NOUSERNAME (D)
.LM +2
.SK 1
Display the Username of the process.
.LM -2
.SK 2