SYSMON
                                A SYSTEM MONITOR

Abstract:

     SYSMON is a multiple process monitor utility, with DCL CLI interface.  It
allows process selection by PID, USERNAME, PROCESSNAME, or MODE for initial
display.  Updates to the display (redisplay) may optionally be selected for
processes that experience changes in certain process counts.  These may
optionally be for number of FAULTS, Global page CouNT, Page CouNT, MEMORY (sum
of Global page CouNT and Page CouNT), BUFIO count, and/or DIRIO count.
Redisplay can occur at fixed intervals or on demand.  Its 132 character line
output may be directed to a VT-100 or compatible CRT terminal, to a LA-120 or
compatible hardcopy terminal, or to a file.  System information includes node,
date, time, total memory, free memory, in-use memory, modified memory, VMS
permanent memory, number of process in the balance set, number of interactive
processes, and number of batch processes.  Optional system information includes
the SYSGEN dynamic parameters related to paging, working set adjustment, and
time management.  Process information includes username, processname, processid,
current priority, base priority, wsdefault, wsquota, wssize, wspeak, memory,
page count, global page count, imagename, imagecount, faults, bufio count, dirio
count, and cputime.

Purpose:

     SYSMON was written to watch, on a process level basis, the paging and page
trimming behavior of the system.  Its 132 character wide display line presents
more information than most other multiple process monitors.

Features:

     1.  A command language interface allows use of familiar qualifier
         constructs.

     2.  Process selection can be performed based on any of the following:

         a.  Process ID (up to ten Process IDs) may be specified, or

         b.  USERname (up to ten usernames (full or partial)) may be specified,
             and/or

         c.  PROCESS names (up to ten process names (full or partial)) may be
             specified, and/or

         d.  MODE (up to 4 items from the list OTHER, NETWORK, BATCH,
             INTERACTIVE) may be selected.

     3.  An optional INTERVAL in seconds qualifier may be specified to cause
         repeated displays for the changed selected processes.  If this
         qualifier is omitted, the redisplay occurs on demand (i.e. when the
         user presses <RETURN>).

     4.  An optional changed state SELECTion list qualifier may be specified
         which will redisplay a process for any of the following reasons:
                                                                Page 2


         a.  FAULTS - A change in the number of FAULTS for a process is
             detected, and/or

         b.  GCNT - A change in the Global page CouNT for a process is detected,
             and/or

         c.  PCNT - A change in the Page CouNT for a process is detected, and/or

         d.  MEMORY - A change in the sum of Page CouNT and Global Page CouNT
             for a process is detected, and/or

         e.  BUFIO - A change in the BUFfered IO CouNT for a process is
             detected, and/or

         f.  DIRIO - A change in the DIRect IO CouNT for a process is detected.

     5.  An optional negatable OLD qualifier to enable or disable the display of
         the previous state of a process after a change is detected.

     6.  An optional OUTPUT qualifier to direct output to a file or other
         device.

     7.  An optional BEGINNING qualifier to indicate a time for starting the
         active monitoring.

     8.  An optional ENDING qualifier to indicate the ending time for active
         monitoring.

     9.  An optional negatable DLB qualifier to display certain system dynamic
         parameters related to memory management and time management.

    10.  A HELP interface for the SYStem MONitor.

    11.  A SPAWN interface to allow changes to the system without leaving the
         image.

Documentation:

     A SYSMON.RND file is supplied for user documentation.  This has been
processed by RUNOFF to generate formatted user documentation in SYSMON.DOC.
SYSMON.RND has also been processed by RUNOFF/VARIANT=HELP/OUTPUT=SYSMON.HLP to
produce the SYSMON.HLP help file.  This file has been placed in the library
SYSMON.HLB for use interactively within SYSMON.  Procedures for revising the
documentation are included in SYSMON.RND and SYSMON.DOC.

Acknowledgements:

     An earlier DECUS submittal by Rand P. Hall of Northeastern University was
used as the starting point.  This may therefore be considered a revision to that
program.

     Another DECUS submittal, the FTP package by Mark R. Vevle of the University
of Alabama at Birmingham, provided the SPAWN interface.

Release level:
                                                                Page 3


     This program has been tested in VMS 4.6.  It is expected that at least one
of the subroutines, GETSYSINFO, will need significant rework for VMS 5.n.  These
changes are associated with changes in the SYS.STB table which GETSYSINFO uses
to obtain information which was not available from the $GETSYI system service.

Submitted by:

William A. Flatt
Intercompany Pool
P.O. Box 3727
Spokane, WA 99220

509-482-4162