


! Help file for NAMES.MAR, a utility to find out useful
! information about logged in processes.
!
!            Kevin Carosso
!         Harvey Mudd College
!           December 4, 1981
!
1 NAMES
The NAMES utility is  a  system  program  to  print  out  useful
information  about  current  processes.   The program may be run
with the following command:

          $ RUN TOOLS:NAMES.EXE

In order to specify alternate qualifiers and  parameters  within
the command line, however, you must create a symbol of the form:

          $ NAMES :== $TOOLS:NAMES.EXE

The full command specification for the NAMES utility is then

          $ NAMES [name[,name...]]
!
2 Defaults
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:

$ NAMES/NODEFAULTS/HEADER/ALL/JOB:INTER/PID/TERM/UIC-
$_/STATE/BASE/CURRENT/PROCESS_NAME/IMAGE_NAME
!
2 Parameters
          [name[,name...]]

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:

     $ NAMES TTD7            Returns information for any process
                             currently logged in on the terminal
                             TTD7.
     $ NAMES SYSTEM,TTA      Returns information for any process
                             with  the  username  of  SYSTEM  or
                             logged in on any TTAn terminal.
!
2 Qualifiers
!
/ALL (D)
/SYSTEM
/NOSYSTEM

  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.


!
/BASE_PRIORITY (D)
/NOBASE_PRIORITY

  Display process base priority.


!
/CURRENT_PRIORITY (D)
/NOCURRENT_PRIORITY

  Display process current priority.


!
!
/DEFAULTS (D)
/NODEFAULTS

  This restores the options list to the  initial  default  list.
  The NODEFAULTS option will turn off all default options in the
  current item list.


!
/HEADER (D)
/NOHEADER

  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.


!
/IMAGE_NAME (D)
/NOIMAGE_NAME

  Display the current image being executed  by  a  process.   An
  asterisk,  "*",  in  front  of the name indicates an installed
  image.

  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.


!
/JOB_TYPE=(type [,...]) (D = INTERACTIVE)

  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:

       ALL             Display all jobs.
       BATCH           Display batch jobs.
       DETACHED        Display detached jobs.
       INTERACTIVE     Display interactive (terminal) jobs.
       SUBPROCESS      Display subprocesses.


!
/OWNER_PID
/NOOWNER_PID

  Display the PID of the owner process of  a  subprocess.   This
  will be blank if we are not looking at a subprocess.


!
/PID (D)
/NOPID

  Display the process identification of the job.


!
/PROCESS_NAME (D)
/NOPROCESS_NAME

  Display the process name for the job.


!
/SORT=item (D=TERMINAL)

  Specify which item  field  to  sort  on  before  output.   The
  following items may be specified:

            BASE_PRIORITY
            CURRENT_PRIORITY
            PID
            PROCESS_NAME
            STATE
            TERMINAL
            UIC
            USERNAME


!
/STATE (D)
/NOSTATE

  Display the current state of the process.  The various  states
  are:

       COL
       PG
       MWAIT
       CEF
       PFW
       LEF
       LEFO
       HIB
       HIBO
       SUSP
       SUSPO
       FPG
       COM
       COMO
       CUR


!
/TERMINAL (D)
/NOTERMINAL

  Display the terminal name of interactive  jobs.   Subprocesses
  and  batch jobs will be marked as such.  Detached jobs will be
  blank.


!
/UIC (D)
/NOUIC

  Display the User Identification Code of the process.


!
/USERNAME
/NOUSERNAME (D)

  Display the Username of the process.


