


1 SYSMON

       This is an ICP developed SYStem MONitor utility program which can
  be used to monitor changes in processes on the computer system.  The
  information presented will define the alternatives available for
  SYSMON.

       It may be used on any VT-100 or compatible terminal, a LA-120 or
  compatible printer terminal, or its output may be written to a file.
  It produces output lines that are up to 132 characters long.  When
  used on a CRT which is in 80 character mode, it will set it to 132
  character mode for its output and reset it to 80 character mode on
  exiting.  For other devices, it will write its output as if it were a
  132 characters per line hard copy device.

       Several qualifiers allow selection of processes to be shown.
  When multiple selection qualifiers are used, a process must meet the
  requirements shown for each qualifier in order to appear.

       Other qualifiers control the timing of the display and the
  selection of an output device or file.

       To use this Help feature, simply respond with the desired topic
  or subtopic at the prompts.  To re-display the menu of (sub) topics
  press the <?> key.

       To Exit press a series of <RETURN>s.

2 /MODE

  /MODE=(INTERACTIVE,BATCH,NETWORK,OTHER)

  /MODE=ALL     (default)

       This allows the user to select processes based on their modes.
  The two qualifier strings shown above are equivalent.  Any subset of
  the four modes (INTERACTIVE, BATCH, NETWORK, or OTHER) may be
  specified.

2 /USER

  /USER=XX...X

  /USER=(FRED,CHARLIE,JANE)

       This allows the user to select process based on their usernames.
  Up to ten usernames may be specified.  The program compares the
  characters given with the same number of characters of the username
  for the process.  Thus for the example shown, any process by the user
  JANET would also be shown.  The default is that the selection does not
  occur and processes for all users are shown.

2 /PROCESS

  /PROCESS=XX...X

  /PROCESS=(JOBCONTROL,ACCOUNTING001,JANET,SYMB)

       This allows the user to select processes based on their
  processnames.  Up to ten processnames may be specified.  The program
  compares the characters given with the same number of characters of
  the processname for the process.  Thus for the example shown, all
  print SYMBIONT process would be shown.  The default is that the
  selection does not occur and all processes are shown.

  /NOPROCESS

       This allows the user to suppress all process displays and
  therefore display only the system related data including the /DLB data
  if requested.  Since it prevents the display of any processes, it is
  mutually exclusive of the /MODE, /USER, and /ID qualifiers.

2 /ID

  /ID=PID

  /ID=(PID1,PID2...PIDn)

       This allows the user to select processes based on their process
  identification numbers (PIDs).  Up to ten PIDs may be specified.
  Since process identification numbers are unique for a given boot of
  the computer system and are neither predictable nor repeatable for a
  new process being created, SYSMON will determine which processes exist
  as it checks the existing processes.  If any process PIDs are or
  become unused, the system will delete those from its list.  Should
  that list become empty it will prompt for further instructions.

       This qualifer, since it identifies specific processes, is
  mutually exclusive of the /MODE, /USER, and /PROCESS qualifiers.

2 /SELECT

  /SELECT=XX...X

  /SELECT=(FAULTS,GCNT,PCNT,MEMORY,BUFIO,DIRIO)

       This allows the user to control the selection reasons for
  updating the display for processes.  The user may list any set of the
  following reasons:

  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.

  /NOSELECT

       This allows the user to suppress the selection reasons for
  updating the display.  No process changes are required for an update
  of the display for a process to occur.  Since it causes all processes
  meeting the other qualifer requirements to appear on each update, it
  is mutually exclusive of the /NOPROCESS qualifier which prevents the
  display of process data.

2 /INTERVAL

  /INTERVAL=n

       This allows the user to specify the period (in seconds) between
  successive displays.  If /INTERVAL is 0 or not present, then the
  system will produce a single display and then display the SYSMON>
  prompt.  Pressing the <RETURN> key at that prompt will produce an
  updated display.  (i.e., When no interval is specified SYSMON will
  produce an updated display on demand.)  Typing "exit", or Ctrl/Z will
  cause the program to terminate.  Typing Ctrl/Y, or Ctrl/C will
  interupt the program.  A new command string may also be entered after
  the SYSMON> prompt as is the case for DEC's MONITOR after a CTRL/C.

2 /BEGINNING

  /BEGINNING=delta time

       This allows the user to schedule the starting of the display or
  recording process for a predetermined time.  If specified, SYSMON will
  hibernate until the specified time.

2 /ENDING

  /ENDING=delta time

       This allows the user to schedule a stopping time for SYSMON.  If
  specified, then SYSMON will exit after the specified time passes.  If
  /ENDING is specified and /INTERVAL is omitted, then /INTERVAL=60 is
  implied.

2 /OUTPUT

  /OUTPUT=FILEname or device

  /OUTPUT=SYS$OUTPUT    (default)

       This allows the user to define an output device or file for
  SYSMON results.  All display output will be directed to that file or
  device.  If omitted, then SYS$OUTPUT is implied.  This qualifier may
  be useful in creating a file of process activities for later review.

2 /OLD

  /OLD (default)

  /NOOLD

       This allows the user to tell SYSMON that it should not report on
  the OLD state of the processes when it updates its display.  Once this
  qualifier is set, it remains as set until explicitly changed or the
  image exits.

2 /DLB

  /DLB

  /NODLB (default)

       This allows the user to tell SYSMON to show two lines of
  information related to the activies of the Touch Technologies, Inc.
  Dynamic Load Balancer (DLB).  The first line shows the system dynamic
  parameters which DLB may change.  The second shows the translation the
  DLB_STATUS_INFO system logical name which DLB uses to record and
  report its activity.

       If the system does not have DLB then those system dynamic
  parameters are reported.  If the DLB_STATUS_INFO system logical name
  does not exist, then no output line is produced.  If it does, then its
  translation is displayed.

       Once set this remains as set until explicitly changed or the
  image exits.

2 Examples

  SYSMON

       Run SYSMON to display the processes on the system.  This will
  produce a single listing of the processes and a SYSMON> prompt.  At
  the prompt the user may press <RETURN> to produce a new display,
  provide a new or revised set of qualifiers (with or without the SYSMON
  verb) to produce a new display, type "EXIT" or CTRL/Z to exit, or
  press CTRL/Y to interupt.

  SYSMON/DLB/OUTPUT=USERDISK:SYSMON.OUTPUT/BEGINNING=00:30/ENDING=01:00

       Run SYSMON with its output written to the SYSMON.OUTPUT file,
  including the two lines of information on DLB, beginning in thirty
  minutes from the execution of the command and ending one hour from the
  execution of the command.  Since an ENDING time is specified without
  an INTERVAL, the interval period is sixty seconds.

  SYSMON/ID=(AF,135A,E44B)/INTERVAL=120

       Run SYSMON showing only the processes listed with a wait of 120
  seconds between displays.

  SYSMON/MODE=(INTERACTIVE,BATCH)

       Run SYSMON showing only INTERACTIVE and BATCH processes.  As in
  the first example this will produce a single listing of the processes
  and a SYSMON> prompt.

  SYSMON/USER=(BILL,SAM,SHERRIE)

       Run SYSMON showing only processes owned by the given usernames.
  Since the comparison is only for the number of characters given any
  processes owned by SAMANTHA whould also be shown.  As in the first
  example this will produce a single listing of the processes and a
  SYSMON> prompt.

  SYSMON/PROCESS=(ACCOUNTING,ENGINEERING)

       Run SYSMON showing all processes whose process names begin with
  either "ACCOUNTING" or "ENGINEERING".  Since the comparison is only
  for the number of characters given, a process such as ACCOUNTING001
  would also be shown.  As in the first example this will produce a
  single listing of the processes and a SYSMON> prompt.

  SYSMON/DLB/NOPROCESS/INTERVAL=30

       Run SYSMON including the two lines of information on DLB,
  updating the output every 30 seconds.  No process details are shown.

1 SPAWN

  SPAWN

       This allows the user to tell SYSMON to SPAWN another process.  A
  command with qualifiers and parameters may be specified following the
  SPAWN verb.

1 HELP

  HELP

       This allows the user to see this help information for SYSMON.
  Text for this help file and instructions for creating it is found in
  in SYSMON.RND.
