Invokes  the  VAX/VMS Monitor Utility (MONITOR) to  monitor  classes  of
 systemwide  performance  data   at  a  specified  interval.  It produces
 three types of optional output:

    o  Recording file
    o  Statistical terminal display
    o  Statistical summary file

 You  can collect data from a running system or from a previously created
 recording file.

 You can execute a single  MONITOR request,  or enter MONITOR interactive
 mode to execute a series of requests.  Interactive mode is entered  when
 the MONITOR command is issued with no parameters or qualifiers.

 A MONITOR request can be terminated by striking CTRL/C or CTRL/Z. CTRL/C
 causes MONITOR to enter interactive mode; CTRL/Z returns to DCL.

 The  MONITOR  Utility  is  described  in  detail in  the VAX/VMS Monitor
 Reference Manual.

 Format:
        MONITOR  class-name[,...]

Additional information available:

ALL_CLASSESCLUSTERDECNETDISKDLOCKFCP
FILE_SYSTEM_CACHEIOLOCKMODESPAGEPOOL
PROCESSESSCSSTATESSYSTEM

ParametersCommand QualifiersClass name QualifiersExamples

 class-name[,...]

  Specifies one or more classes of performance data to be monitored.
  The available class-names are:

      ALL_CLASSES     All MONITOR classes.
      CLUSTER         Cluster wide information.
      DECNET          DECnet-VAX statistics.
      DISK            Disk I/O statistics.
      DLOCK           Distributed lock management statistics
      FCP             File system primitive statistics.
      FILE_SYSTEM_CACHE File system caching statistics.
      IO              System I/O statistics.
      LOCK            Lock management statistics.
      MODES           Time spent in each of the processor modes.
      PAGE            Page management statistics.
      POOL            Space allocation in the nonpaged dynamic pool.
      PROCESSES       Statistics on all processes.
      SCS             System communication services statistics.
      STATES          Number of processes in each of the scheduler states.
      SYSTEM          System Statistics.

  The MONITOR ALL_CLASSES command initiates monitoring of all classes
  except  the  CLUSTER  class.  ALL_CLASSES and the CLUSTER class are
  mutually  exclusive.  The  default  interval for live requests is 6
  seconds.

  The MONITOR CLUSTER command initiates monitoring of CLUSTER statistics
  on all nodes in the cluster. The information presented on the CLUSTER
  screen includes CPU Busy, Percent Memory in use, Disk I/O activity,
  and Total Locking rate for all nodes in the cluster. The default
  interval for live requests is 6 seconds. The CLUSTER class and the
  ALL_CLASSES class are mutually exclusive.

  The MONITOR  DECNET  command  initiates  monitoring  of  the  DECNET
  STATISTICS  class,  which includes information on DECnet-VAX network
  activity.

  The MONITOR DISK command initiates monitoring of the DISK statistics
  class, which includes information on all mounted disks.

  The  MONITOR  DLOCK  command  initiates  monitoring  of  the   DLOCK
  (distributed  lock management) statistics class.  The DLOCK class is
  useful for monitoring the lock management subsystem in a  VAXcluster
  environment.

  The MONITOR FCP command initiates monitoring of the  FILE  PRIMITIVE
  STATISTICS class,  which includes  information on file  system (XQP
  and ACP) activity on the local node.

  The MONITOR FILE_SYSTEM_CACHE  command  initiates  monitoring of the
  FILE SYSTEM CACHING STATISTICS class.

  The MONITOR IO  command  initiates  monitoring  of  the  I/O  SYSTEM
  STATISTICS class.

  The MONITOR LOCK command initiates monitoring of the LOCK MANAGEMENT
  STATISTICS class.

  The MONITOR MODES  command  initiates  monitoring  of  the  TIME  IN
  PROCESSOR  MODES  class, which includes a data item for each mode of
  processor operation.

  The MONITOR PAGE command initiates monitoring of the PAGE MANAGEMENT
  STATISTICS class.

  The MONITOR POOL command initiates monitoring of the  NONPAGED  POOL
  STATISTICS  class,  which measures space allocations in the nonpaged
  dynamic pool.

  The MONITOR PROCESSES command initiates monitoring of the  PROCESSES
  class,  which  displays  information on all processes in the system.
  PROCESSES display  (and  summary)  formats  are different from those
  of all other classes.

  The  MONITOR  SCS  command  initiates  monitoring  of   the   System
  Communication Services statistics class.

  The MONITOR STATES  command  initiates  monitoring  of  the  PROCESS
  STATES  class, which shows the number of processes in each of the 14
  scheduler states.

  The  MONITOR SYSTEM  command  initiates  monitoring  of  the  SYSTEM
  statistics class,  which shows several  of the most  important items
  from other classes.

Additional information available:

/BEGINNING/BY_NODE/COMMENT/DISPLAY/ENDING
/FLUSH_INTERVAL/INPUT/INTERVAL/NODE/RECORD/SUMMARY
/VIEWING_TIME

   /BEGINNING=time

 Specifies the time that monitoring is to begin. You can specify either
 an absolute time or a combination of absolute and delta times. See the
 VAX/VMS DIGITAL Command Language Dictionary (or  access  the  DCL HELP
 topic SPECIFY) for complete information on specifying time values.

 If you specify a future time for a running  system  request,  the
 process hibernates until the specified time.

   /BY_NODE

 Specifies that a multi-file summary be formatted  with one column
 per distinct node. By default, such a summary contains one column
 per input file.

   /COMMENT="string"
   /NOCOMMENT         (D)

 Specifies  a message  of up  to 60 characters to be stored in the
 recording file.  This is valid only when /RECORD is specified.

 When  the recording  file containing  the comment is played back,
 the comment string is included in the display or summary.

   /DISPLAY[=file-spec]  (D)
   /NODISPLAY

 Controls whether collected data is to be formatted and displayed.

 The  /DISPLAY  qualifier  allows  you  to specify the name of the
 display file to contain screen image output.   If  you  omit  the
 optional  file-spec,  data  is  written to the current SYS$OUTPUT
 device.

   /ENDING=time

 Specifies the time that  monitoring is to end.  You can specify either
 an absolute time or a combination of absolute and delta times. See the
 VAX/VMS DIGITAL Command Language Dictionary (or  access  the  DCL HELP
 topic SPECIFY) for complete information on specifying time values.

 If you are monitoring a running system, and you omit the  /ENDING
 qualifier,  monitoring  ends  when you terminate the request with
 CTRL/C or CTRL/Z. CTRL/C causes MONITOR to enter interactive mode;
 CTRL/Z returns to DCL.

   /FLUSH_INTERVAL=seconds

 Specifies  the  amount of time  between  flush  operations on the
 recording file. The default is 300 seconds, or five minutes.

   /INPUT[=file-spec,...]
   /NOINPUT            (D)

 Controls whether performance data is collected from an input file
 or from the running system.

 The /INPUT qualifier allows you to specify the name of  an  input
 file.  The default name is MONITOR.DAT.  This file must have been
 produced  by  a  previous  MONITOR  run  which specified /RECORD.
 Specify a list  of  files  if the  multi-file summary  feature is
 desired. When a list is specified, wildcards are permitted.

   /INTERVAL=seconds

 Specifies the sampling interval between data  collection  events,
 recording events, and display events.

 For live requests, /INTERVAL  specifies  the  number  of  seconds
 between successive collection and recording events.  For playback
 requests, /INTERVAL  is used to combine records of the input file
 for display and re-recording.

 The default  interval for monitoring  the running system is three
 seconds (or 6 seconds  when  ALL_CLASSES or SYSTEM is specified).
 For playback requests,  the interval value  defaults to the value
 specified in the input recording file.

   /NODE[=(nodename,...)]

  Specifies the DECnet node from which information is collected. This
  qualifier is only valid in a VAXcluster which is running DECnet.

   /RECORD[=file-spec]
   /NORECORD            (D)

 Controls whether collected data is stored in a recording file.

 The default name is MONITOR.DAT.

   /SUMMARY[=file-spec]
   /NOSUMMARY             (D)

 Controls whether an  ASCII  file  is  to  be  created  containing
 summary  statistics  on  all  collected  data  for  this  MONITOR
 request.  The default file-spec is MONITOR.SUM.

 The summary file that is  generated  at  the  end  of  monitoring
 contains one page of output for each requested class.  The format
 of each page of a regular summary report is  similar to  that  of
 display  output  and  is determined by the class-name qualifiers.
 A multi-file summary  report contains  one column of averages for
 each  input  file  specified,  unless  the /BY_NODE  qualifier is
 specified, in which case there is one column per distinct node.

   /VIEWING_TIME=seconds

 For /DISPLAY requests, this qualifier specifies the duration  for
 each screen image display.

 If you are monitoring the running system, /VIEWING_TIME  defaults
 to  the  /INTERVAL  value.   If  you specify /INPUT (monitoring a
 recording file), /VIEWING_TIME defaults to three seconds.

  The class-name  parameter  qualifiers  control the type of display
  and summary output format generated for each class-name specified.
  Each of these qualifiers applies only to the immediately preceding
  class-name.

  Class-name qualifiers must not appear as part of the command verb.

Additional information available:

/ALL/AVERAGE/CPU/CURRENT/ITEM/MAXIMUM/MINIMUM
/PERCENT/TOPBIO/TOPCPU/TOPDIO/TOPFAULT

 Specifies that a table of current, average, minimum, and  maximum
 statistics is to be included in display and summary output.

 /ALL is the  default for all class-names except MODES, STATES and
 SYSTEM. It may not be used with the PROCESSES class-name.

 Selects  "average"  statistics in  bar graph form for display and
 summary output.

 This qualifier may not be used with the PROCESSES class-name.

   /CPU         (D)
   /NOCPU

 Selects the processor-specific form of display and summary output
 for the MODES class (for VAX/VMS Multiprocessing systems).

 The /CPU  qualifier is applicable  only to the  MODES class-name,
 and may be  specified  in addition to any  one of  the  statistic
 qualifiers (/ALL,  /AVERAGE,  /CURRENT,  /MAXIMUM,  /MINIMUM).

 The  qualifier  is  ignored  if  the  system  is  not  a  VAX/VMS
 Multiprocessing system.

 Selects  "current" statistics  in  bar graph form for display and
 summary output.

 /CURRENT is the  default for MODES, STATES and SYSTEM. It may not
 be used with the PROCESSES class-name.

   /ITEM=(item-keyword-list)

 Selects  one or more  data  items for inclusion  in  display  and
 summary output. To select all available items, specify /ITEM=ALL.

 The /ITEM qualifier is applicable only to the DISK and SCS class-
 names.  It may be specified  with any of the statistic qualifiers
 (/ALL, /AVERAGE, /CURRENT, /MAXIMUM, /MINIMUM).

 The item keywords for DISK  are:  OPERATION_RATE(D), QUEUE_LENGTH.

 The item keywords for SCS are: D_SEND, D_RECEIVE, D_DISCARD, M_SEND,
 M_RECEIVE, SEND_DATA, KB_SEND, REQUEST_DATA, KB_REQUEST, KB_MAP(D),
 SEND_CREDIT, and BUFFER_DESCRIPTOR.

 Selects "maximum"  statistics in  bar graph form  for display and
 summary output.

 This qualifier may not be used with the PROCESSES class-name.

 Selects  "minimum"  statistics in bar graph form  for display and
 summary output.

 This qualifier may not be used with the PROCESSES class-name.

   /PERCENT
   /NOPERCENT      (D)

 Controls  whether statistics are expressed as  percent  values in
 display and summary output.

 The  /PERCENT  qualifier is  applicable  only to the DISK, MODES,
 SCS and STATES class-names.  It may be  specified with any of the
 statistic qualifiers (/ALL, /AVERAGE, /CURRENT, /MAXIMUM, /MINIMUM).

 Used  with the  PROCESSES  class-name to specify that a bar graph
 listing the  top  buffered I/O  processes be produced  instead of
 the default PROCESSES display and summary output.

 This qualifier may be used only with the PROCESSES class-name.

 Used with the  PROCESSES  class-name to  specify that a bar graph
 listing the  top  CPU time  processes  be produced instead of the
 default PROCESSES display and summary output.

 This qualifier may be used only with the PROCESSES class-name.

 Used with the  PROCESSES  class-name to specify  that a bar graph
 listing the top  direct I/O processes be produced  instead of the
 default PROCESSES display and summary output.

 This qualifier may be used only with the PROCESSES class-name.

 Used with the  PROCESSES  class-name to  specify that a bar graph
 listing the top page faulting  processes  be produced  instead of
 the default PROCESSES display and summary output.

 This qualifier may be used only with the PROCESSES class-name.

  Note that while any of the commands in the following examples may be
  issued  from  DCL  level,  it  is  preferable  to invoke the MONITOR
  utility with the DCL command MONITOR, then  issue  the  commands  in
  response to the utility prompt MONITOR>.

  1.   $ MONITOR PAGE

  This command produces  a  display  of  page  management  statistics.
  Since  no  command or class-name qualifiers have been named, MONITOR
  applies the following defaults to the display:

       /ALL /INTERVAL=3 /VIEWING_TIME=3
       /INPUT=the running system
       /OUTPUT=current SYS$OUTPUT device.

  By default, monitoring begins when the command is  issued  and  ends
  when the user presses <CTRL/C> or <CTRL/Z>.

  2.   $ MONITOR IO /RECORD /INTERVAL=5
          .
          .
          .

       $ MONITOR IO /INPUT

  These commands produce system I/O  statistics.   The  first  command
  gathers  and  displays  data  every five seconds, beginning when the
  command is issued and ending  when  the  user  presses  <CTRL/C>  or
  <CTRL/Z>.  In addition, it records binary data in the default output
  file MONITOR.DAT.  The second command plays back the I/O  statistics
  display,  using  the  data  in  MONITOR.DAT  for input.  The default
  viewing time for the playback is  three  seconds,  but  each  screen
  display represents five seconds of monitored I/O statistics.

  3.   $ MONITOR POOL /DISPLAY=POOL.LOG
       $ MONITOR MODES+STATES /NODISPLAY /RECORD

  MONITOR display output can  be  routed  to  any  supported  terminal
  device,  or  to  a  disk  file.  The first of the two above commands
  writes its display of nonpaged pool statistics to the file POOL.LOG.
  This  file  could  then be printed out on a hard-copy terminal.  The
  second command records data on time spent in each of  the  processor
  modes  and  on  the  number  of  processes  in each of the scheduler
  states, but it does not display this information.

  4.   $ MONITOR FCP/AVERAGE,POOL/MINIMUM

  This command displays, in bar-graph form, average  file  system  ACP
  statistics  and  minimum  nonpaged  dynamic  pool  statistics.   The
  display alternates between the two graphs every three seconds.

  5.   $ MONITOR PROCESSES/TOPCPU

  This command displays a bar graph showing the eight  processes  that
  were  the  top  consumers  of  CPU  time  during  the period between
  displays.  It also displays the amount of total  CPU  time  each  of
  these processes used.

  6.   $ MONITOR POOL /RECORD /NODISPLAY -
       $ _/BEGINNING=08:00:00 -
       $ _/ENDING=16:00:00 -
       $ _/INTERVAL=120
          .
          .
          .

       $ MONITOR POOL /INPUT /DISPLAY=HOURLY.LOG -
       $ _/INTERVAL=3600

  These commands illustrate the recording of data  with  a  relatively
  small  interval and playback with a relatively large interval.  This
  is useful for producing average,  minimum,  and  maximum  statistics
  that  cover  a  wide  range of time, but have greater precision than
  they would have if they had been gathered over the larger interval.

  The first command records data on space allocation in  the  nonpaged
  dynamic pool for the) indicated eight-hour period, using an interval
  of two minutes.  The second plays the data back with an interval  of
  one  hour, storing display output in the file HOURLY.LOG.  This file
  may then be typed or printed to show the cumulative pool utilization
  at each hour throughout the eight-hour period.

  7.   $ MONITOR POOL /AVERAGE /INPUT /NODISPLAY /SUMMARY=DAILY.LOG

  Using the recording file  created  in  the  previous  example,  this
  command  produces a one-page summary report file showing the average
  statistics for the indicated eight-hour period.  The summary  report
  has the same format as a screen display, which in this case is a bar
  graph.