ESU is a utility which builds a list of processes on the system, optionally sorts & sifts the list, formats the list for output, and displays the list on the terminal device.

Commandline Syntax:

$ ESU [/opt[/opt]] [user-prefix [user-prefix]][/opt[/opt]]

Options are prefixed with a slash and may appear anywhere on the command line. User-prefixes must be preceded by space character and also may appear anywhere on the command line. The following examples are all equivelent commands:

• $ esu/w nen rw cb /c
• $ esu /w nen rw cb/c
• $ esu nen /w rw cb/c

In the examples above, notice that two options "/w" and "/c" have been selected, and three user-prefixes "nen" "rw" and "cb" have been defined. The above examples are requesting ESU to list all users whose usernames' begin with either NEN, RW, or CB.

OPTIONS:

ESU recognizes four types of options to perform its job:

1. Selection options - to describe WHICH processes to pick
2. Sort options - to describe HOW to arrange the selection
3. Output options - to describe WHAT fields to display
4. Display options - to describe HOW to display the results

Although ESU does not require any options to provide a list of users, using the option commands gives the user control of the "who/what, where, and when" of listing system processes.

Options which have parameters are additive, and you may use the VMS listing method at your discression, i.e. $ esu/g=(4,10,12) is equivelent to using $ esu/g=4,10,12

Every process on the system has the following list of items associated with it. ESU uses a single character to represent each item:

Option	Item	Definition
A	Alias	Process Name
B	Buffer & Direct I/O	Summed I/O count
D	PID	Process identification number (HEX)
E	Elapsed Time	How long the process has been logged on
F	Account Field	Internal administrative code
G	Group	Group number of the process's UIC (Octal)
I	Image	Image file name
J	Job Type	Execution mode at the root of the job tree
K	State	State of the process
L	Location	Location of the owner's terminal
M	Mode	Mode of the process
N	Node	VMScluster node on which the process is running
P	Port Name	Access port name for the terminal
Q	CPU Time (Quantum)	Accumulated CPU time in 10-millisecond ticks
T	Terminal	process's login terminal
U	UserName	Owner of the process

Below, arranged by category, are each of the options and examples of how to use them. Each example will show both a single and multiple use of an option, if a multiple use is available.

SELECTION OPTIONS:

Selection is carried out by using each of the above option letters, a comparison token, and a selection field. The selection field is a string which defines the criterion for the selection, and the comparison token is a single character from the table below:

Token	Operation	Definition
=	EQUAL	Test for equivelence
-	NOT	Test for difference
>	GREATER	Test for succession
<	LESS THAN	Test for antecedence

                                    +----token
                       option------+|  +----selection field
               command---------+   ||  |
                               |   ||  |
                               v   vv  v
                              esu /i=mail
                                    

For example:

$ esu /g=12 to select all processes in group 12
$ esu /g-12 to select all processes not in group 12
$ esu /g>12 to select all processes with a group greater than 12
$ esu /g<12 to select all processes with a group less than 12

The comparison tokens work on all items, not just group. The selection field is composed of any characters except for the "!" exclamation point, which DCL will not pass to the program. The selection field may contain the wildcard characters "%" or "*", for single or multiple expansion.

For example:

$ esu /n=t* to select all nodes beginning with "T"
$ esu /n=%%l* to select all nodes with "L" as the third character
$ esu /i=*i* to select all images containing an "I" character

Selection options are additive. The equivelence tests use a logical OR operation, while the remaining tests use a logical AND function.

For example:

$ esu/n=t*/g<12 to select all processes on nodes beginning with "T" AND with groups less than 12.
$ esu/g>5/g<100 to select all processes with groups lying between 5 and 100.
$ esu/g=4,10,12 to select all processes with a group of either 4,10, OR 12.

Usernames may be specified as prefixes on the commandline. When used in this fashion a parameter is equivelent to /u=*.

For example:

$ esu ne r cb is equivelent to esu /u=ne*,r*,cb*

this would be a command to select all usernames beginning with "NE", "R", or "CB".

Default selections:

Most of the selection options have defaults in place for quick selection. By entering a selection option without any parameters or tokens, the following table shows what to expect.

Option	Default	Purpose
E	>0-1	To select all "old" processes, older than 10 hours
G	=12	To select all Student Assistants
I	=MAIL	To select all processes running mail
J	=N*	To select all Network processes
K	=*M*	To select all processes in a COM or MWAIT state
M	=B*	To select all Batch processes
P	=*]*	To select all processes with unamed internet addresses
T	=F*	To select all FTAXXX terminals
U	>@	To select all usernames (without )

For example:

$ esu/m to select all batch jobs
$ esu/m/g to select all batch jobs submitted by Student Assistants
$ esu/g/i to select all Student Assistants running MAIL

Using the above methods for selection, it should be possible to select any possible subset of processes that one desires. If NO selection options are specified, ESU sets the default selections to /m=INTER (all interactive processes on the system).

The /BR option is used to deselect any records which would cause a multiple listing of a username. In other words, if you wish only to see a single username for each process, when some users are running multiple processes, the /BR switch will cancel the extra listings.

For example:

$ esu/br to show all interactive sessions without multiple instances of usernames.

SORTING OPTIONS:

Use the /S= option to sort the selected processes in preparation for output. Multiple, compound sorting is allowed. The sorting parameters should be arranged in the order of priority "/S" without a value defaults to "GF" which sorts first by group and then by account field. Using the NOT token will cause a reverse sort.

For example:

$ esu /s=niua will sort by node, by image, by username, then alias.
$ esu /s-u will reverse sort by username.
$ esu /u/s=u will sort by username, deselecting 's
$ esu /br/u/s=u will sort by username, deselecting 's, and remove any multiple instances of username.

If no sorting options are specified, ESU does not perform a sort.

OUTPUT OPTIONS:

Use the /O= to define output fields. Output fields are arranged in the order given by field parameters. If output is beyond the width of the screen it is truncated to fit.

For example:

$ esu /o=ieptuknd will display image, elapsed time, port, terminal, username, state, node, and PID.

There are four output options which are used for quick display setups. Each has its own

Alternative Setups:

For example:

• $ esu /l shows all interactive users without multiple listings, listing their username, node, location, portname, terminal, image, and acct field, and sorting on username, node, alias, port, acct field, and terminal name.

If no output options are specified, ESU uses /o=DNKUTPEI as a default.

DISPLAY OPTIONS:

/C	CONTIN	Display is paged continuously. Use the Up and Down arrow keys to scroll. Use the Lft and Rht arrow keys to scroll. The "Prev" key goes to the previous page of the list. The "Next" key goes to the next page of the list. Use the gold-key PF1 and arrow keys to go far left far right, to the top, or the bottom of the list. Press RETURN or SPACEBAR to quit continuous mode.
/P	PAGE	Displays output without page breaks.
/SB	SBANNER	Suppresses the display of the Banner.
/ST	STITLE	Suppresses the display Titles.
/H or /?	HELP	Displays this help.

If no display options are specified, ESU defaults to page mode, with banners and titles, and does not show this help.

If no options are specified at all, ESU defaults to:

$ esu /m=INTR/o=DNKUTPEI

APPENDIX:

Option-J POSSIBLE JOB TYPES:

     DETP   -   DETACHED 
     NETW   -   NETWORK  
     BATJ   -   BATCH    
     LOCL   -   LOCAL    
     DIAL   -   DIALUP   
     RMOT   -   REMOTE   
     n/a    -   ERROR  

Option-M POSSIBLE PROCESS MODES:

    OTHR   -   OTHER
    NETW   -   NETWORK
    BATJ   -   BATCH
    INTR   -   INTERACTIVE
    n/a    -   ERROR

Option-K POSSIBLE STATES:

    COLP   -   Collided page wait
    MWAI   -   Mutex and miscellaneous resource wait
    CEF    -   Common event flag wait
    PFW    -   Page fault wait
    LEF    -   Local event flag wait
    LEFO   -   Local event flag wait, out of balance set
    HIB    -   Hibernate wait
    HIBO   -   Hibernate wait, out of balance set
    SUSP   -   Suspended
    SSPO   -   Suspended, out of balance set
    FPG    -   Free page wait
    COM    -   Computable
    COMO   -   Computable, out of balance set
    CUR    -   Current process
    ERR    -   ERROR

Information Services, Central Computing
University of Missouri Kansas City