The Monitor utility (MONITOR) is a system management tool used
to obtain information about operating system performance. MONITOR
allows you to monitor classes of systemwide performance data
(such as system I/O statistics, page management statistics,
and time spent in each of the processor modes) at specifiable
intervals, and produce several types of output.
To monitor a particular class of information, specify the class
names corresponding to the information classes that you want to
monitor. For example, to monitor page management statistics,
specify the PAGE class name in the MONITOR command. MONITOR
collects system performance data by class and produces the
following three forms of optional output:
o A disk recording file in binary format
o Statistical terminal displays
o A disk file containing statistical summary information in
ASCII format
The utility initiates a single MONITOR request for the classes of
performance data specified each time you enter a command in the
following form:
MONITOR [/qualifier[,...]] classname[,...] [/qualifier[,...]]
Regardless of the order in which you specify classname
parameters, MONITOR always executes requests in the following
sequence:
PROCESSES
STATES
MODES
PAGE
IO
FCP
LOCK
DECNET
FILE_SYSTEM_CACHE
DISK
DLOCK
SCS
SYSTEM
CLUSTER
RMS
MSCP_SERVER
TRANSACTION
VECTOR
TIMER
RLOCK
Depending on the command qualifiers specified, MONITOR collects
system performance data from the running system or plays back
data recorded previously in a recording file. When you play back
data, you can display it, summarize it, and even rerecord it to
reduce the amount of data in the recording file.
To invoke MONITOR, enter the DCL command MONITOR.
$ MONITOR
The utility then displays the following prompt:
MONITOR>
To begin monitoring a system, issue the Monitor utility MONITOR
command.
NOTE
If you attempt to monitor a remote node that is
incompatible, the system displays the following message:
%MONITOR-E-SRVMISMATCH, MONITOR server on remote node is an incompatible
version
If you receive this message, contact your VSI support
representative for a remedial kit that corrects this
problem.
Before you install the remedial kit, you can still use
MONITOR to obtain data about the remote node. To do this,
record the data on the remote node, and then run the MONITOR
playback feature to examine the data on the local node.
Generally, each MONITOR request runs until the time specified or
implied by the /ENDING qualifier. To exit from MONITOR, enter the
EXIT command at the MONITOR> prompt or press Ctrl/Z. To terminate
a MONITOR request without exiting from the utility, press Ctrl/C.
Information that MONITOR collect is usually displayed as ASCII
screen images. You can use the optional /DISPLAY qualifier to
specify a disk file to contain the information. If you omit the
file specification, output is directed to SYS$OUTPUT. See the
Monitor utility MONITOR command for a discussion of the /DISPLAY
qualifier.
You can also initiate MONITOR requests from command level by
entering the DCL command MONITOR with the desired qualifiers and
parameters. However, in terms of conserving system resources, it
is preferable to initiate requests in response to the MONITOR>
prompt.
1 – ALIGN
On Integrity server systems, the ALIGN command displays
information about alignment faults, thereby helping troubleshoot
VSI Integrity server systems.
Format
ALIGN
1.1 – Example
MONITOR> ALIGN
ALIGNMENT FAULT STATISTICS
on node MTDIB9
11-JAN-2006 16:58:07.25
CUR AVE MIN MAX
Kernel Fault Rate 19529.00 19529.00 19529.00 19529.00
Exec Fault Rate 7581.00 7581.00 7581.00 7581.00
Super Fault Rate 0.00 0.00 0.00 0.00
User Fault Rate 164972.00 164972.00 164972.00 164972.00
Total Fault Rate 192082.00 192082.00 192082.00 192082.00
This example shows the alignment fault rate on the current
system.
2 – CONVERT
The CONVERT command converts a pre-Version 5.0 MONITOR recording
file to the current format.
Format
CONVERT file-spec
2.1 – Parameter
file-spec
Specifies the file to be converted. The default file
specification is MONITOR.DAT.
2.2 – Qualifier
2.2.1 /OUTPUT
The file specification of the converted file. The default
specification is MONITOR.DAT.
3 – EXECUTE
The EXECUTE command or the at sign (@) executes a series of
MONITOR commands contained in a file.
Format
EXECUTE (@) file-spec
3.1 – Parameter
file-spec
Specifies a command file to be executed by the EXECUTE (@)
command.
3.2 – Qualifiers
None.
4 – EXIT
The EXIT command terminates MONITOR, returning control to command
level.
Format
EXIT
4.1 – Parameters
None.
4.2 – Qualifiers
None.
5 – HELP
The HELP command displays information about MONITOR.
Format
HELP [command]
5.1 – Parameter
command
Specifies the name of a MONITOR command for which HELP is
desired.
5.2 – Qualifiers
None.
5.3 – Example
MONITOR> HELP MONITOR INITIALIZE
The INITIALIZE command reestablishes initial default settings for
parameters and qualifiers previously altered by the SET DEFAULT
command.
The command in this example requests help information about the
INITIALIZE command.
6 – INITIALIZE
The INITIALIZE command reestablishes initial default settings for
parameters and qualifiers altered by the SET DEFAULT command.
Format
INITIALIZE
6.1 – Parameters
None.
6.2 – Qualifiers
None.
7 – MONITOR
The MONITOR command initiates monitoring of statistics for the
classes of information you specify.
Format
MONITOR [/command qualifier[,...]] classname[,...] [/classname
qualifier[,...]]
7.1 – Parameter
classname[,...]
Specifies the class of performance data to be monitored. To
monitor all classes, specify the ALL_CLASSES parameter. When you
specify several classes, separate the classname parameters with
commas or plus signs. You cannot specify the CLUSTER class name
with any other class name. Cluster monitoring functions require
that DECnet for OpenVMS be installed.
The MONITOR and SET DEFAULT commands accept the same qualifiers.
As these qualifiers follow the standard rules of DCL grammar as
specified in the <REFERENCE>(VMS_DCLDICT_REF), you can abbreviate
any qualifier or keyword as long as the abbreviation is not
ambiguous. Use the asterisk and the percent sign as wildcard
characters unless otherwise noted.
7.2 – Command Qualifier Descriptions
7.2.1 /BEGINNING
/BEGINNING=time
Specifies the time that monitoring begins, by using a combination
of absolute and delta times. Observe the syntax rules for time
values described in the online help topic DCL_Tips (subtopic
Date_Time).
7.2.2 /BY_NODE
/BY_NODE
/NOBY_NODE
Specifies that performance class data in a multifile summary be
displayed as a single column of AVERAGE statistics for each node.
The /BY_NODE qualifier displays data in a multifile summary. If
you specify only one input file, MONITOR ignores the /BY_NODE
qualifier because you are not performing a multifile summary.
7.2.3 /COMMENT
/COMMENT=string
/NOCOMMENT (default)
Specifies an ASCII string to be stored in the output recording
file. The string can contain up to 60 characters.
7.2.4 /DISPLAY
/DISPLAY[=file-spec] (default)
/NODISPLAY
Specifies whether information collected by MONITOR is to be
displayed as ASCII screen images. Optionally names the disk file
to contain the output.
7.2.5 /ENDING
/ENDING=time
Specifies the time that monitoring ends, by using a combination
of absolute and delta times. Observe the syntax rules for time
values described in the online help topic DCL_Tips (subtopic
Date_Time).
7.2.6 /FLUSH_INTERVAL
/FLUSH_INTERVAL=seconds
Specifies the interval, in seconds, at which data collected by
MONITOR (contents of MONITOR buffers) is written to disk. Values
must be in the range from 1 to 9,999. The default interval is 300
seconds.
7.2.7 /INPUT
/INPUT[=(file-spec,...)]
/NOINPUT (default)
Controls whether performance data is played back from one or more
input files or collected from the running system. If you specify
more than one file, enclose the list in parentheses, and separate
the file specifications with commas. Wildcard characters are
allowed in the file specification.
7.2.8 /INTERVAL
/INTERVAL=seconds
Specifies the sampling interval between data collection events,
recording events, and display events. Values can range from 1 to
9,999,999.
7.2.9 /NODE
/NODE=(nodename,...)
Specifies the nodes (up to 48 in a cluster) for which data is
to be collected. If you specify more than one name, separate the
names with commas, and enclose the list in parentheses.
Remote monitoring in an OpenVMS Cluster environment might not be
compatible for nodes that are running different OpenVMS versions.
The following table shows the compatibility of versions for
remote monitoring.
OpenVMS Alpha and OpenVMS Alpha Version 1.5
VAX Version 6.n and VAX Version 5.n
OpenVMS Alpha and Yes No
VAX Version 6.n
OpenVMS Alpha No Yes
Version 1.5 and
VAX Version 5.n
To obtain data from an incompatible remote node, record the data
on the remote node and then use the MONITOR playback feature to
examine the data on the local node. The <REFERENCE>(VMS_SYSMAN_
MAN) describes remote monitoring.
7.2.10 /OUTPUT
/OUTPUT=file-spec
Used with the CONVERT command, this qualifier specifies the name
of the converted recording file. The default specification is
MONITOR.DAT. File lists are not permitted.
7.2.11 /RECORD
/RECORD[=file-spec]
/NORECORD (default)
Specifies that a binary disk file be created containing all
collected data for the request. Note that recording is restricted
to files on disks. No wildcard characters are allowed in the file
specification. If you omit the file type, the default file type
is .DAT. If you omit the file specification, output is generated
to a file named MONITOR.DAT in the current default device and
directory. If you specify an existing file but omit the version
number, a new version of the file is created.
7.2.12 /SUMMARY
/SUMMARY[=file-spec]
/NOSUMMARY (default)
Specifies that an ASCII disk file be created containing
summary statistics on all data collected for this request.
If the optional file specification is omitted, it defaults to
MONITOR.SUM.
7.2.13 /VIEWING_TIME
/VIEWING_TIME=seconds
Specifies the duration for each screen image display for /DISPLAY
requests. Values can range from 1 to 9,999,999.
7.3 – ALL_CLASSES
The MONITOR ALL_CLASSES command initiates monitoring of
statistics for all classes except the CLUSTER and RMS classes.
Format
MONITOR ALL_CLASSES
7.3.1 – Classname Qualifiers
7.3.1.1 /ALL
Specifies that a table of all available statistics (current,
average, minimum, and maximum) is to be included in the display
and summary output. For summary output, this qualifier is the
default for all classes; otherwise, it is the default for all
classes except CLUSTER, MODES, PROCESSES, STATES, SYSTEM, and
VECTOR.
7.3.1.2 /AVERAGE
Specifies that a bar graph of average statistics is to be
included in the display and summary outputs.
7.3.1.3 /CURRENT
Specifies that a bar graph of current statistics is to be
included in the display and summary outputs. The /CURRENT
qualifier is the default for the CLUSTER, MODES, STATES, SYSTEM,
and VECTOR classes.
7.3.1.4 /MAXIMUM
Specifies that a bar graph of maximum statistics is to be
included in the display and summary outputs.
7.3.1.5 /MINIMUM
Specifies that a bar graph of minimum statistics is to be
included in the display and summary outputs.
7.4 – CLUSTER
The MONITOR CLUSTER command initiates monitoring of the CLUSTER
statistics class, which shows clusterwide CPU, memory, disk, and
locking activity.
Format
MONITOR CLUSTER
7.4.1 – Classname Qualifiers
7.4.1.1 /ALL
Specifies that a table of all available statistics (current,
average, minimum, and maximum) is to be included in the display
and summary output. For summary output, this qualifier is the
default for all classes; otherwise, it is the default for all
classes except CLUSTER, MODES, PROCESSES, STATES, SYSTEM, and
VECTOR.
7.4.1.2 /AVERAGE
Specifies that a bar graph of average statistics is to be
included in the display and summary outputs.
7.4.1.3 /CURRENT
Specifies that a bar graph of current statistics is to be
included in the display and summary outputs. The /CURRENT
qualifier is the default for the CLUSTER, MODES, STATES, SYSTEM,
and VECTOR classes.
7.4.1.4 /MAXIMUM
Specifies that a bar graph of maximum statistics is to be
included in the display and summary outputs.
7.4.1.5 /MINIMUM
Specifies that a bar graph of minimum statistics is to be
included in the display and summary outputs.
7.5 – DECNET
The MONITOR DECNET command initiates monitoring of the DECNET
class, which includes information about DECnet for OpenVMS
network activity.
Format
MONITOR DECNET
7.5.1 – Classname Qualifiers
7.5.1.1 /ALL
Specifies that a table of all available statistics (current,
average, minimum, and maximum) is to be included in the display
and summary output. For summary output, this qualifier is the
default for all classes; otherwise, it is the default for all
classes except CLUSTER, MODES, PROCESSES, STATES, SYSTEM, and
VECTOR.
7.5.1.2 /AVERAGE
Specifies that a bar graph of average statistics is to be
included in the display and summary outputs.
7.5.1.3 /CURRENT
Specifies that a bar graph of current statistics is to be
included in the display and summary outputs. The /CURRENT
qualifier is the default for the CLUSTER, MODES, STATES, SYSTEM,
and VECTOR classes.
7.5.1.4 /MAXIMUM
Specifies that a bar graph of maximum statistics is to be
included in the display and summary outputs.
7.5.1.5 /MINIMUM
Specifies that a bar graph of minimum statistics is to be
included in the display and summary outputs.
7.6 – DISK
The MONITOR DISK command initiates monitoring of the DISK
statistics class. The maximum number of disks that can be
monitored for record output is 909, and for display and summary
output is 1817.
Format
MONITOR DISK
7.6.1 – Classname Qualifiers
7.6.1.1 /ALL
Specifies that a table of all available statistics (current,
average, minimum, and maximum) is to be included in the display
and summary output. For summary output, this qualifier is the
default for all classes; otherwise, it is the default for all
classes except CLUSTER, MODES, PROCESSES, STATES, SYSTEM, and
VECTOR.
7.6.1.2 /AVERAGE
Specifies that a bar graph of average statistics is to be
included in the display and summary outputs.
7.6.1.3 /CURRENT
Specifies that a bar graph of current statistics is to be
included in the display and summary outputs. The /CURRENT
qualifier is the default for the CLUSTER, MODES, STATES, SYSTEM,
and VECTOR classes.
7.6.1.4 /ITEM
/ITEM=(keyword[,...])
Selects one or more data items for inclusion in display and
summary outputs. If you specify two or more keywords, enclose
them in parentheses, and separate them with commas. When the
/ITEM qualifier is omitted, the default is /ITEM=OPERATION_RATE.
The following table describes /ITEM qualifier keywords:
Keyword Description
ALL Specifies that statistics on all data items
collected for the disks are displayed on successive
screens.
OPERATION_ Specifies that I/O operation rate statistics are
RATE displayed for each disk.
QUEUE_LENGTH Specifies that the number of I/O request packets
being serviced (current or waiting) is displayed
for each disk.
7.6.1.5 /MAXIMUM
Specifies that a bar graph of maximum statistics is to be
included in the display and summary outputs.
7.6.1.6 /MINIMUM
Specifies that a bar graph of minimum statistics is to be
included in the display and summary outputs.
7.6.1.7 /PERCENT
/PERCENT
/NOPERCENT (default)
Controls whether statistics are expressed as percent values in
display and summary outputs. The /PERCENT qualifier is applicable
only to the DISK, MODES, SCS, and STATES classes.
7.7 – DLOCK
The MONITOR DLOCK command initiates monitoring of the DLOCK
(distributed lock management) statistics class.
Format
MONITOR DLOCK
7.7.1 – Classname Qualifiers
7.7.1.1 /ALL
Specifies that a table of all available statistics (current,
average, minimum, and maximum) is to be included in the display
and summary output. For summary output, this qualifier is the
default for all classes; otherwise, it is the default for all
classes except CLUSTER, MODES, PROCESSES, STATES, SYSTEM, and
VECTOR.
7.7.1.2 /AVERAGE
Specifies that a bar graph of average statistics is to be
included in the display and summary outputs.
7.7.1.3 /CURRENT
Specifies that a bar graph of current statistics is to be
included in the display and summary outputs. The /CURRENT
qualifier is the default for the CLUSTER, MODES, STATES, SYSTEM,
and VECTOR classes.
7.7.1.4 /MAXIMUM
Specifies that a bar graph of maximum statistics is to be
included in the display and summary outputs.
7.7.1.5 /MINIMUM
Specifies that a bar graph of minimum statistics is to be
included in the display and summary outputs.
7.8 – FCP
The MONITOR FCP command initiates monitoring of the File Control
Primitive statistics class, which includes information about
all Files-11 ancillary control processes (ACPs) and extended QIO
processors (XQPs) on the local node.
Format
MONITOR FCP
7.8.1 – Classname Qualifiers
7.8.1.1 /ALL
Specifies that a table of all available statistics (current,
average, minimum, and maximum) is to be included in the display
and summary output. For summary output, this qualifier is the
default for all classes; otherwise, it is the default for all
classes except CLUSTER, MODES, PROCESSES, STATES, SYSTEM, and
VECTOR.
7.8.1.2 /AVERAGE
Specifies that a bar graph of average statistics is to be
included in the display and summary outputs.
7.8.1.3 /CURRENT
Specifies that a bar graph of current statistics is to be
included in the display and summary outputs. The /CURRENT
qualifier is the default for the CLUSTER, MODES, STATES, SYSTEM,
and VECTOR classes.
7.8.1.4 /MAXIMUM
Specifies that a bar graph of maximum statistics is to be
included in the display and summary outputs.
7.8.1.5 /MINIMUM
Specifies that a bar graph of minimum statistics is to be
included in the display and summary outputs.
7.9 – FILE_SYSTEM_CACHE
The MONITOR FILE_SYSTEM_CACHE command initiates monitoring of the
FILE_SYSTEM_CACHE statistics class.
Format
MONITOR FILE_SYSTEM_CACHE
7.9.1 – Classname Qualifiers
7.9.1.1 /ALL
Specifies that a table of all available statistics (current,
average, minimum, and maximum) is to be included in the display
and summary output. For summary output, this qualifier is the
default for all classes; otherwise, it is the default for all
classes except CLUSTER, MODES, PROCESSES, STATES, SYSTEM, and
VECTOR.
7.9.1.2 /AVERAGE
Specifies that a bar graph of average statistics is to be
included in the display and summary outputs.
7.9.1.3 /CURRENT
Specifies that a bar graph of current statistics is to be
included in the display and summary outputs. The /CURRENT
qualifier is the default for the CLUSTER, MODES, STATES, SYSTEM,
and VECTOR classes.
7.9.1.4 /MAXIMUM
Specifies that a bar graph of maximum statistics is to be
included in the display and summary outputs.
7.9.1.5 /MINIMUM
Specifies that a bar graph of minimum statistics is to be
included in the display and summary outputs.
7.10 – IO
The MONITOR IO command initiates monitoring of the I/O class.
Format
MONITOR IO
7.10.1 – Classname Qualifiers
7.10.1.1 /ALL
Specifies that a table of all available statistics (current,
average, minimum, and maximum) is to be included in the display
and summary output. For summary output, this qualifier is the
default for all classes; otherwise, it is the default for all
classes except CLUSTER, MODES, PROCESSES, STATES, SYSTEM, and
VECTOR.
7.10.1.2 /AVERAGE
Specifies that a bar graph of average statistics is to be
included in the display and summary outputs.
7.10.1.3 /CURRENT
Specifies that a bar graph of current statistics is to be
included in the display and summary outputs. The /CURRENT
qualifier is the default for the CLUSTER, MODES, STATES, SYSTEM,
and VECTOR classes.
7.10.1.4 /MAXIMUM
Specifies that a bar graph of maximum statistics is to be
included in the display and summary outputs.
7.10.1.5 /MINIMUM
Specifies that a bar graph of minimum statistics is to be
included in the display and summary outputs.
7.11 – LOCK
The MONITOR LOCK command initiates monitoring of the LOCK class.
Format
MONITOR LOCK
7.11.1 – Classname Qualifiers
7.11.1.1 /ALL
Specifies that a table of all available statistics (current,
average, minimum, and maximum) is to be included in the display
and summary output. For summary output, this qualifier is the
default for all classes; otherwise, it is the default for all
classes except CLUSTER, MODES, PROCESSES, STATES, SYSTEM, and
VECTOR.
7.11.1.2 /AVERAGE
Specifies that a bar graph of average statistics is to be
included in the display and summary outputs.
7.11.1.3 /CURRENT
Specifies that a bar graph of current statistics is to be
included in the display and summary outputs. The /CURRENT
qualifier is the default for the CLUSTER, MODES, STATES, SYSTEM,
and VECTOR classes.
7.11.1.4 /MAXIMUM
Specifies that a bar graph of maximum statistics is to be
included in the display and summary outputs.
7.11.1.5 /MINIMUM
Specifies that a bar graph of minimum statistics is to be
included in the display and summary outputs.
7.12 – MODES
The MONITOR MODES command initiates monitoring of the MODES
class, which includes a data item for each mode of processor
operation.
Format
MONITOR MODES
7.12.1 – Classname Qualifiers
7.12.1.1 /ALL
Specifies that a table of all available statistics (current,
average, minimum, and maximum) is to be included in the display
and summary output. For summary output, this qualifier is the
default for all classes; otherwise, it is the default for all
classes except CLUSTER, MODES, PROCESSES, STATES, SYSTEM, and
VECTOR.
7.12.1.2 /AVERAGE
Specifies that a bar graph of average statistics is to be
included in the display and summary outputs.
7.12.1.3 /CPU
/CPU
/NOCPU [=(x[,...])] (default)
In multiprocessor configurations, selects the CPU-specific form
of output, where x specifies the CPU identification.
For multiprocessor systems, /NOCPU produces a single modes screen
that reflects the combined time that all CPUs spent in each mode.
For nonmultiprocessor systems, the /CPU qualifier displays the
CPU ID; /NOCPU does not display the CPU ID.
7.12.1.4 /CURRENT
Specifies that a bar graph of current statistics is to be
included in the display and summary outputs. The /CURRENT
qualifier is the default for the CLUSTER, MODES, STATES, SYSTEM,
and VECTOR classes.
7.12.1.5 /MAXIMUM
Specifies that a bar graph of maximum statistics is to be
included in the display and summary outputs.
7.12.1.6 /MINIMUM
Specifies that a bar graph of minimum statistics is to be
included in the display and summary outputs.
7.12.1.7 /PERCENT
/PERCENT
/NOPERCENT (default)
Controls whether statistics are expressed as percent values
in display and summary outputs. The [NO]PERCENT qualifier is
applicable only to the DISK, MODES, SCS, and STATES classes.
7.13 – MSCP_SERVER
The MONITOR MSCP_SERVER command initiates monitoring of the mass
storage control protocol (MSCP) server class.
Format
MONITOR MSCP_SERVER
7.13.1 – Classname Qualifiers
7.13.1.1 /ALL
Specifies that a table of all available statistics (current,
average, minimum, and maximum) is to be included in the display
and summary output. For summary output, this qualifier is the
default for all classes; otherwise, it is the default for all
classes except CLUSTER, MODES, PROCESSES, STATES, SYSTEM, and
VECTOR.
7.13.1.2 /AVERAGE
Specifies that a bar graph of average statistics is to be
included in the display and summary outputs.
7.13.1.3 /CURRENT
Specifies that a bar graph of current statistics is to be
included in the display and summary outputs. The /CURRENT
qualifier is the default for the CLUSTER, MODES, STATES, SYSTEM,
and VECTOR classes.
7.13.1.4 /MAXIMUM
Specifies that a bar graph of maximum statistics is to be
included in the display and summary outputs.
7.13.1.5 /MINIMUM
Specifies that a bar graph of minimum statistics is to be
included in the display and summary outputs.
7.14 – PAGE
The MONITOR PAGE command initiates monitoring of the PAGE class.
Format
MONITOR PAGE
7.14.1 – Classname Qualifiers
7.14.1.1 /ALL
Specifies that a table of all available statistics (current,
average, minimum, and maximum) is to be included in the display
and summary output. For summary output, this qualifier is the
default for all classes; otherwise, it is the default for all
classes except CLUSTER, MODES, PROCESSES, STATES, SYSTEM, and
VECTOR.
7.14.1.2 /AVERAGE
Specifies that a bar graph of average statistics is to be
included in the display and summary outputs.
7.14.1.3 /CURRENT
Specifies that a bar graph of current statistics is to be
included in the display and summary outputs. The /CURRENT
qualifier is the default for the CLUSTER, MODES, STATES, SYSTEM,
and VECTOR classes.
7.14.1.4 /MAXIMUM
Specifies that a bar graph of maximum statistics is to be
included in the display and summary outputs.
7.14.1.5 /MINIMUM
Specifies that a bar graph of minimum statistics is to be
included in the display and summary outputs.
7.15 – PROCESSES
The MONITOR PROCESSES command initiates monitoring of the
PROCESSES class, which displays information about all processes
in the system.
In a multifile summary request, the classes CLUSTER and PROCESSES
are ignored. If these classes are the only classes specified on
the command line, MONITOR does not recognize them and displays a
"no classes specified" error message.
Beginning in OpenVMS Version 8.3, four new qualifiers (
/TOPKERNEL, /TOPEXECUTIVE, /TOPSUPERVISOR, and /TOPUSER) allow
you to monitor per-process-based modes usage. These qualifiers
are useful in helping to identify the top consumers of the
various CPU modes. For example, if the MONITOR MODES command
reveals that an excessive amount of supervisor mode is being
used, the new MONITOR PROCESSES/TOPSUPERVISOR display reveals
which process-and therefore, which user-is responsible.
Format
MONITOR PROCESSES
7.15.1 – Classname Qualifiers
7.15.1.1 /TOPBIO
Specifies that a bar graph listing the top buffered I/O users
be produced instead of the standard display and summary output.
Values are expressed in units of buffered I/Os per second.
7.15.1.2 /TOPCPU
Specifies that a bar graph listing the top CPU time users be
produced instead of the standard display and summary output.
Values are expressed in units of clock ticks (10 milliseconds)
per second.
Prior to OpenVMS Version 7.3, the MONITOR PROCESSES/TOPCPU
display showed only a maximum of 8 processes on one screen. In
OpenVMS Version 7.3 and later versions, the choice of which one
of three screens is displayed is determined by the number of CPUs
on the system. (See the examples in the MONITOR chapter in the
hardcopy <REFERENCE>(vms_sysman_util_ref).)
7.15.1.3 /TOPDIO
Specifies that a bar graph listing the top direct I/O users be
produced instead of the standard display and summary output.
Values are expressed in units of direct I/Os per second.
7.15.1.4 /TOPEXECUTIVE
Specifies that a bar graph listing the top executive-mode users
be produced instead of the standard display and summary output.
Values are expressed in clock ticks (10 ms) per second.
7.15.1.5 /TOPFAULT
Specifies that a bar graph listing the top page-faulting
processes be produced instead of the standard display and summary
output. Values are expressed in number of page faults per second.
7.15.1.6 /TOPKERNEL
Specifies that a bar graph listing the top kernel-mode users
be produced instead of the standard display and summary output.
Values are expressed in clock ticks (10 ms_ per second.
7.15.1.7 /TOPSUPERVISOR
Specifies that a bar graph listing the top supervisor-mode users
be produced instead of the standard display and summary output.
Values are expressed in clock ticks (10 ms) per second.
7.15.1.8 /TOPUSER
Specifies that a bar graph listing the top user-mode users be
produced instead of the standard display and summary output.
Values are expressed in clock ticks (10 ms_ per second.
7.16 – RLOCK
The MONITOR RLOCK command initiates monitoring of the RLOCK
(dynamic lock remastering) statistics class.
Format
MONITOR RLOCK
7.16.1 – Classname Qualifiers
7.16.1.1 /ALL
Specifies that a table of all available statistics (current,
average, minimum and maximum) is to be included in the display
and summary outputs. For summary output, this qualifier is the
default for all classes; otherwise, it is the default for all
classes except CLUSTER, MODES, PROCESSES, STATES, SYSTEM, and
VECTOR.
7.16.1.2 /AVERAGE
Specifies that a bar graph of average statistics is to be
included in the display and summary outputs.
7.16.1.3 /CURRENT
Specifies that a bar graph of current statistics is to be
included in the display and summary outputs. The /CURRENT
qualifier is the default for the CLUSTER, MODES, STATES, SYSTEM,
and VECTOR classes.
7.16.1.4 /MAXIMUM
Specifies that a bar graph of maximum statistics is to be
included in the display and summary outputs.
7.16.1.5 /MINIMUM
Specifies that a bar graph of minimum statistics is to be
included in the display and summary outputs.
7.17 – RMS
The MONITOR RMS command initiates monitoring of the OpenVMS
Record Management Services (OpenVMS RMS) statistics class for
a specific file.
Format
MONITOR RMS
7.17.1 – Classname Qualifiers
7.17.1.1 /ALL
Specifies that a table of all available statistics (current,
average, minimum, and maximum) is to be included in the display
and summary output. For summary output, this qualifier is the
default for all classes; otherwise, it is the default for all
classes except CLUSTER, MODES, PROCESSES, STATES, SYSTEM, and
VECTOR.
7.17.1.2 /AVERAGE
Specifies that a bar graph of average statistics is to be
included in the display and summary outputs.
7.17.1.3 /CURRENT
Specifies that a bar graph of current statistics is to be
included in the display and summary outputs. The /CURRENT
qualifier is the default for the CLUSTER, MODES, STATES, SYSTEM,
and VECTOR classes.
7.17.1.4 /FILE
/FILE=(file-name[,...])
Specifies a list of one or more files to which the MONITOR RMS
command applies.
7.17.1.5 /ITEM
/ITEM=(keyword[,...])
Selects one or more data items for inclusion in display and
summary outputs. If you specify two or more keywords, enclose
them in parentheses, and separate them with commas. When the
/ITEM qualifier is omitted, the default is /ITEM=OPERATIONS.
The following table describes /ITEM qualifier keywords:
Keyword Description
OPERATIONS Specifies that RMS basic operations statistics are
displayed for the selected file.
DATA_RATES Specifies that RMS data rate statistics are
displayed for the selected file.
LOCKING Specifies that RMS locking statistics are displayed
for the selected file.
CACHING Specifies that RMS caching statistics are displayed
for the selected file.
7.17.1.6 /MAXIMUM
Specifies that a bar graph of maximum statistics is to be
included in the display and summary outputs.
7.17.1.7 /MINIMUM
Specifies that a bar graph of minimum statistics is to be
included in the display and summary outputs.
7.18 – SCS
The MONITOR SCS command initiates monitoring of the System
Communications Services (SCS) class.
Format
MONITOR SCS
7.18.1 – Classname Qualifiers
7.18.1.1 /ALL
Specifies that a table of all available statistics (current,
average, minimum, and maximum) is to be included in the display
and summary output. For summary output, this qualifier is the
default for all classes; otherwise, it is the default for all
classes except CLUSTER, MODES, PROCESSES, STATES, SYSTEM, and
VECTOR.
7.18.1.2 /AVERAGE
Specifies that a bar graph of average statistics is to be
included in the display and summary outputs.
7.18.1.3 /CURRENT
Specifies that a bar graph of current statistics is to be
included in the display and summary outputs. The /CURRENT
qualifier is the default for the CLUSTER, MODES, STATES, SYSTEM,
and VECTOR classes.
7.18.1.4 /ITEM
/ITEM=(keyword[,...])
Selects one or more data items for inclusion in display and
summary outputs. If you specify two or more keywords, enclose
them in parentheses, and separate them with commas. When the
/ITEM qualifier is omitted, the default is /ITEM=KB_MAP.
The following table describes /ITEM qualifier keywords:
Keyword Description
ALL Specifies that statistics on all data items
collected for the disks are displayed on
successive screens.
BUFFER_ Specifies that statistics on the queued-for-
DESCRIPTOR buffer-descriptor (on the local node) rate are
displayed for each node.
D_DISCARD Specifies that datagram discard rate statistics
are displayed for each node.
D_RECEIVE Specifies that datagram receive rate statistics
are displayed for each node.
D_SEND Specifies that datagram send rate statistics are
displayed for each node.
KB_MAP Specifies that kilobyte map rate statistics are
displayed for each node.
KB_REQUEST Specifies that kilobyte request (via request
datas) rate statistics are displayed for each
node.
KB_SEND Specifies that kilobyte send (via send datas)
rate statistics are displayed for each node.
M_RECEIVE Specifies that message receive rate statistics
are displayed for each node.
M_SEND Specifies that message send rate statistics are
displayed for each node.
REQUEST_DATA Specifies that request data (initiated on the
local node) rate statistics are displayed for
each node.
SEND_CREDIT Specifies that queued-for-send-credit (on the
local node) rate statistics are displayed for
each node.
SEND_DATA Specifies that send data (initiated on the local
node) rate statistics are displayed for each
node.
7.18.1.5 /MAXIMUM
Specifies that a bar graph of maximum statistics is to be
included in the display and summary outputs.
7.18.1.6 /MINIMUM
Specifies that a bar graph of minimum statistics is to be
included in the display and summary outputs.
7.18.1.7 /PERCENT
/PERCENT
/NOPERCENT (default)
Controls whether statistics are expressed as percent values in
display and summary outputs. The /PERCENT qualifier is applicable
only to the DISK, MODES, SCS, and STATES classes.
7.19 – STATES
The MONITOR STATES command initiates monitoring of the PROCESS
STATES class, which shows the number of processes in each of the
14 scheduler states.
Format
MONITOR STATES
7.19.1 – Classname Qualifiers
7.19.1.1 /ALL
Specifies that a table of all available statistics (current,
average, minimum, and maximum) is to be included in the display
and summary output. For summary output, this qualifier is the
default for all classes; otherwise, it is the default for all
classes except CLUSTER, MODES, PROCESSES, STATES, SYSTEM, and
VECTOR.
7.19.1.2 /AVERAGE
Specifies that a bar graph of average statistics is to be
included in the display and summary outputs.
7.19.1.3 /CURRENT
Specifies that a bar graph of current statistics is to be
included in the display and summary outputs. The /CURRENT
qualifier is the default for the CLUSTER, MODES, STATES, SYSTEM,
and VECTOR classes.
7.19.1.4 /MAXIMUM
Specifies that a bar graph of maximum statistics is to be
included in the display and summary outputs.
7.19.1.5 /MINIMUM
Specifies that a bar graph of minimum statistics is to be
included in the display and summary outputs.
7.19.1.6 /PERCENT
/PERCENT
/NOPERCENT (default)
Controls whether statistics are expressed as percent values in
display and summary outputs. The /PERCENT qualifier is applicable
only to the DISK, MODES, SCS, and STATES class names.
7.20 – SYSTEM
The MONITOR SYSTEM command initiates monitoring of the SYSTEM
statistics class, which shows several of the most important items
from other classes.
Format
MONITOR SYSTEM
7.20.1 – Classname Qualifiers
7.20.1.1 /ALL
Specifies that a table of all available statistics (current,
average, minimum, and maximum) is to be included in the display
and summary output. For summary output, this qualifier is the
default for all classes; otherwise, it is the default for all
classes except CLUSTER, MODES, PROCESSES, STATES, SYSTEM, and
VECTOR.
7.20.1.2 /AVERAGE
Specifies that a bar graph of average statistics is to be
included in the display and summary outputs.
7.20.1.3 /CURRENT
Specifies that a bar graph of current statistics is to be
included in the display and summary outputs. The /CURRENT
qualifier is the default for the CLUSTER, MODES, STATES, SYSTEM,
and VECTOR classes.
7.20.1.4 /MAXIMUM
Specifies that a bar graph of maximum statistics is to be
included in the display and summary outputs.
7.20.1.5 /MINIMUM
Specifies that a bar graph of minimum statistics is to be
included in the display and summary outputs.
7.21 – TIMER
The MONITOR TIMER command initiates monitoring of the TIMER
statistics class, which is the rate of processing Timer Queue
Entries (TQEs) by the OpenVMS executive. A TQE is a data
structure representing a timer request made by a user or by the
system.
Format
MONITOR TIMER
7.21.1 – Classname Qualifiers
7.21.1.1 /ALL
Specifies that a table of all available statistics (current,
average, minimum and maximum) is to be included in the display
and summary outputs. For summary output, this qualifier is the
default for all classes; otherwise, it is the default for all
classes except CLUSTER, MODES, PROCESSES, STATES, SYSTEM, and
VECTOR.
7.21.1.2 /AVERAGE
Specifies that a bar graph of average statistics is to be
included in the display and summary outputs.
7.21.1.3 /CURRENT
Specifies that a bar graph of current statistics is to be
included in the display and summary outputs. The /CURRENT
qualifier is the default for the CLUSTER, MODES, STATES, SYSTEM,
and VECTOR classes.
7.21.1.4 /MAXIMUM
Specifies that a bar graph of maximum statistics is to be
included in the display and summary outputs.
7.21.1.5 /MINIMUM
Specifies that a bar graph of minimum statistics is to be
included in the display and summary outputs.
7.22 – TRANSACTION
The MONITOR TRANSACTION command initiates monitoring of the
TRANSACTION class, which shows information about transactions
coordinated by DECdtm services.
Format
MONITOR TRANSACTION
7.22.1 – Classname Qualifiers
7.22.1.1 /ALL
Specifies that a table of all available statistics (current,
average, minimum, and maximum) is to be included in the display
and summary output. For summary output, this qualifier is the
default for all classes; otherwise, it is the default for all
classes except CLUSTER, MODES, PROCESSES, STATES, SYSTEM, and
VECTOR.
7.22.1.2 /AVERAGE
Specifies that a bar graph of average statistics is to be
included in the display and summary outputs.
7.22.1.3 /CURRENT
Specifies that a bar graph of current statistics is to be
included in the display and summary outputs. The /CURRENT
qualifier is the default for the CLUSTER, MODES, STATES, SYSTEM,
and VECTOR classes.
7.22.1.4 /MAXIMUM
Specifies that a bar graph of maximum statistics is to be
included in the display and summary outputs.
7.22.1.5 /MINIMUM
Specifies that a bar graph of minimum statistics is to be
included in the display and summary outputs.
7.23 – VECTOR
The MONITOR VECTOR command displays the number of 10-millisecond
clock ticks per second in which one or more vector consumers have
been scheduled on each currently configured vector processor in
the system.
Format
MONITOR VECTOR
7.23.1 – Classname Qualifiers
7.23.1.1 /ALL
Specifies that a table of all available statistics (current,
average, minimum, and maximum) is to be included in the display
and summary output. For summary output, this qualifier is the
default for all classes; otherwise, it is the default for all
classes except CLUSTER, MODES, PROCESSES, STATES, SYSTEM, and
VECTOR.
7.23.1.2 /AVERAGE
Specifies that a bar graph of average statistics is to be
included in the display and summary outputs.
7.23.1.3 /CURRENT
Specifies that a bar graph of current statistics is to be
included in the display and summary outputs. The /CURRENT
qualifier is the default for the CLUSTER, MODES, STATES, SYSTEM,
and VECTOR classes.
7.23.1.4 /MAXIMUM
Specifies that a bar graph of maximum statistics is to be
included in the display and summary outputs.
7.23.1.5 /MINIMUM
Specifies that a bar graph of minimum statistics is to be
included in the display and summary outputs.
8 – SET_DEFAULT
The SET DEFAULT command sets command qualifier, classname
parameter, and classname qualifier defaults for the MONITOR
command. Each SET DEFAULT command sets only the command
qualifiers you specify, but replaces the entire set of classname
parameters and classname qualifiers. All qualifiers and class
names are identical to those for the MONITOR command.
Format
SET DEFAULT [/qualifier[,...]] classname[,...]
[/qualifier[,...]]
9 – SHOW_DEFAULT
The SHOW DEFAULT command displays the defaults established by the
SET DEFAULT command.
Format
SHOW DEFAULT