HP OpenVMS Systems Documentation

Content starts here

OpenVMS System Management Utilities Reference Manual


Previous Contents Index

MONITOR DECNET

The MONITOR DECNET command initiates monitoring of the DECNET class, which includes information about DECnet for OpenVMS network activity.

Format

MONITOR DECNET


Command Qualifiers

/qualifier[,...]

One or more qualifiers as described in the Command Qualifier Descriptions section.

Classname Qualifiers

/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.

/AVERAGE

Specifies that a bar graph of average statistics is to be included in the display and summary outputs.

/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.

/MAXIMUM

Specifies that a bar graph of maximum statistics is to be included in the display and summary outputs.

/MINIMUM

Specifies that a bar graph of minimum statistics is to be included in the display and summary outputs.

Description

The DECNET class consists of the following data items:
Data Item Description
Arriving Local Packet Rate Rate at which local packets are being received.
Departing Local Packet Rate Rate at which local packets are being sent.
Arriving Transit Packet Rate Rate at which transit packets are arriving.
Transit Congestion Loss Rate Rate of transit congestion loss.
Receiver Buffer Failure Rate Rate of receiver buffer failures.

Example


MONITOR> MONITOR DECNET








                           OpenVMS Monitor Utility
                               DECNET STATISTICS
                                 on node SAMPLE
                              29-APR-2000 22:22:44

                                       CUR        AVE        MIN        MAX

     Arriving Local Packet Rate       9.54       5.08       0.00      11.25

     Departing Local Packet Rate      9.22       4.66       0.00      10.92

     Arriving Trans Packet Rate       0.00       0.00       0.00       0.00

     Trans Congestion Loss Rate       0.00       0.00       0.00       0.00

     Receiver Buff Failure Rate       0.00       0.00       0.00       0.00

This example shows that arriving and departing network packet rates (including control packets) are roughly equivalent, and that network activity is currently at a level higher than the average since monitoring began, but not at its highest point.

MONITOR 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


Command Qualifiers

/qualifier[,...]

One or more qualifiers as described in the Command Qualifier Descriptions section.

Classname Qualifiers

/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.

/AVERAGE

Specifies that a bar graph of average statistics is to be included in the display and summary outputs.

/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.

/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_RATE Specifies that I/O operation rate statistics are 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.

/MAXIMUM

Specifies that a bar graph of maximum statistics is to be included in the display and summary outputs.

/MINIMUM

Specifies that a bar graph of minimum statistics is to be included in the display and summary outputs.

/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.

Description

The DISK class is a component class. Data items for this class are collected for each mounted disk device in a single-node or cluster system. The DISK class consists of the following data items:
Data Item Description
I/O Operation Rate Rate at which I/O operations occur on each disk. By comparing operation rates for all disks in the system, you can tell which disks are busy and which are idle. However, because this statistic does not provide information about the time required for individual operations, use discretion in interpreting it.
I/O Request Queue Length Number of outstanding I/O request packets. Includes the request currently being serviced and those awaiting service. Note that, for greater precision, this item is always sampled at a 1-second interval, regardless of the value specified with the /INTERVAL command qualifier.

The maximum number of disks that can be monitored is 909 for record output and 1817 for display or summary output. In previous versions, the limit was 799 disks for both types of output.

In the following example, typical of a cluster environment, note that each disk is identified by three elements:

  • Disk name ending in a colon.
  • Name of the cluster node through which the disk is accessed. This field appears only in the multiple-statistic display; it is not included in single-statistic displays or multifile summaries.
  • Volume label.

In cluster configurations, the MSCP server software makes locally attached and HSC disks available to other nodes. A node uses remote access to a disk when it accesses the disk through another VAX node (using the MSCP server). A node uses direct access to a disk when it directly accesses a locally attached or HSC disk.

An "R" following the device name indicates that the displayed statistics represent I/O operations requested by nodes using remote access.

If an "R" does not appear after the device name, the displayed statistics represent I/O operations issued by nodes with direct access. These I/O operations might include those issued by the MSCP server on behalf of remote requests.


Example


MONITOR> MONITOR DISK/ITEM=QUEUE_LENGTH








                           OpenVMS Monitor Utility
                              DISK I/O STATISTICS
                                 on node SAMPLE
                              29-APR-2000 14:19:56

I/O Request Queue Length                   CUR        AVE        MIN        MAX

SAMPLE$DBA0:          SAMPLE09APR         0.00       0.00       0.00       0.00
SAMPLE$DRA2:          SAMPLEPAGE          2.00       1.43       0.00       4.00
SAMPLE$DRB1:          ACCREG              0.00       0.00       0.00       0.00
$1$DRA5:     (MOE)    MOE$$PAGE           0.00       0.00       0.00       0.00
$1$DBA3:     (CURLEY) UMASTER             0.00       0.00       0.00       0.00
$1$DBA5:     (CURLEY) MIDNITE             0.00       0.00       0.00       0.00
$2$DRA7:     (LARRY)  RES26APR            0.00       0.00       0.00       0.00
$2$DRB6:     (LARRY)  CLUSTERDUMP1        0.00       0.00       0.00       0.00
$255$DUA4:   (SHEMP)  RES06AUG            0.00       0.00       0.00       0.00
$255$DUA5:   (SHEMP)  VMSDOCLIB           0.00       0.00       0.00       0.00

This example, typical of a cluster environment, shows the number of I/O packets awaiting service or in service for each disk. Note that the device SAMPLE$DRA2 is the only device with a nonzero queue length. Because MONITOR samples queue lengths every second, regardless of the collection interval value, the precision of the data does not depend on the collection interval.

MONITOR DLOCK

The MONITOR DLOCK command initiates monitoring of the DLOCK (distributed lock management) statistics class.

Format

MONITOR DLOCK


Command Qualifiers

/qualifier[,...]

One or more qualifiers as described in the Command Qualifier Descriptions section.

Classname Qualifiers

/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.

/AVERAGE

Specifies that a bar graph of average statistics is to be included in the display and summary outputs.

/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.

/MAXIMUM

Specifies that a bar graph of maximum statistics is to be included in the display and summary outputs.

/MINIMUM

Specifies that a bar graph of minimum statistics is to be included in the display and summary outputs.

Description

The DLOCK class is useful for monitoring the lock management subsystem in a cluster environment. The class consists of the following data items:
Data Item Description
New ENQ Rate (Local) Rate of new lock (ENQ) requests that originate and are performed on this system
New ENQ Rate (Incoming) Rate of new lock requests that originate on other systems and are performed on this system
New ENQ Rate (Outgoing) Rate of new lock requests that originate on this system and are performed on another system
Converted ENQ Rate (Local) Rate of lock (ENQ) conversion requests that originate and are performed on this system
Converted ENQ Rate (Incoming) Rate of lock conversion requests that originate on other systems and are performed on this system
Converted ENQ Rate (Outgoing) Rate of lock conversion requests that originate on this system and are performed on another system
DEQ Rate (Local) Rate of unlock (DEQ) requests that originate and are performed on this system
DEQ Rate (Incoming) Rate of unlock requests that originate on other systems and are performed on this system
DEQ Rate (Outgoing) Rate of unlock requests that originate on this system and are performed on another system
Blocking AST Rate (Local) Rate of lock manager blocking ASTs that originate and are performed on this system
Blocking AST Rate (Incoming) Rate of lock manager blocking ASTs that originate on other systems and are performed on this system
Blocking AST Rate (Outgoing) Rate of lock manager blocking ASTs that originate on this system and are performed on another system
Directory Function Rate (Incoming) Rate of requests for locks being managed by this node
Directory Function Rate (Outgoing) Rate of requests for locks being managed by other nodes
Deadlock Message Rate Rate of incoming and outgoing messages required for deadlock detection


Example


MONITOR> MONITOR DLOCK








                            OpenVMS Monitor Utility
                     DISTRIBUTED LOCK MANAGEMENT STATISTICS
                                 on node SAMPLE
                              29-APR-2000 11:02:20

                                       CUR        AVE        MIN        MAX

    New ENQ Rate       (Local)       15.84      11.59       1.54      26.88
                    (Incoming)        1.67       2.62       0.11      25.05
                    (Outgoing)        0.05       0.63       0.00       5.99
    Converted ENQ Rate (Local)       23.67       9.13       0.99      41.22
                    (Incoming)        4.48       5.71       0.00      70.19
                    (Outgoing)        0.00       1.43       0.00      15.90
    DEQ Rate           (Local)       15.86      11.58       1.64      26.68
                    (Incoming)        1.66       2.59       0.00      24.85
                    (Outgoing)        0.05       0.63       0.00       5.99
    Blocking AST Rate  (Local)        0.00       0.00       0.00       0.01
                    (Incoming)        0.00       0.00       0.00       0.00
                    (Outgoing)        0.00       0.00       0.00       0.00
    Dir Functn Rate (Incoming)        8.00       7.33       4.66      11.00
                    (Outgoing)        1.00       0.77       0.00       2.66
    Deadlock Message Rate             0.00       0.00       0.00       0.00

This example shows that most of the current lock management activity occurs locally, but that, at some point during the monitoring period, a significant amount of incoming activity occurred.

MONITOR 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


Command Qualifiers

/qualifier[,...]

One or more qualifiers as described in the Command Qualifier Descriptions section.

Classname Qualifiers

/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.

/AVERAGE

Specifies that a bar graph of average statistics is to be included in the display and summary outputs.

/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.

/MAXIMUM

Specifies that a bar graph of maximum statistics is to be included in the display and summary outputs.

/MINIMUM

Specifies that a bar graph of minimum statistics is to be included in the display and summary outputs.

Description

The FCP class consists of the following data items, all of which are displayed as occurrences per second:
Data Item Description
FCP Call Rate Rate of QIO requests received by the file system.
Allocation Rate Rate of calls that caused allocation of disk space.
Create Rate Rate at which new files were created.
Disk Read Rate Rate of read I/O operations from disk by the file system.
Disk Write Rate Rate of write I/O operations to disk by the file system.
Volume Lock Wait Rate Rate of entry into a wait state due to contention for a volume synchronization lock. Volume synchronization locks are removed by the XQP during file creation, deletion, extension, and truncation operations.
CPU Tick Rate Rate at which CPU time was used by the file system (in 10-millisecond ticks).
File System Page Fault Rate Rate at which page faults occurred in the file system.
Window Turn Rate Rate of file-map window misses.
File Lookup Rate Rate of file name lookup operations in file directories.
File Open Rate Rate at which files were opened.
Erase Rate Rate of erase operations issued by the file system.

Example


MONITOR> MONITOR /INTERVAL=10 FCP








                           OpenVMS Monitor Utility
                           FILE PRIMITIVE STATISTICS
                                 on node SAMPLE
                              29-APR-2000 16:13:38

                                       CUR        AVE        MIN        MAX
     FCP Call Rate                    4.62       3.80       0.33       7.61
     Allocation Rate                  0.99       0.24       0.00       0.99
     Create Rate                      2.31       0.57       0.00       2.31

     Disk Read Rate                   1.98       2.48       0.33       6.95
     Disk Write Rate                  3.30       2.39       0.33       5.62
     Volume Lock Wait Rate            4.62       3.06       0.00       6.95

     CPU Tick Rate                    3.63       3.88       0.33      10.26
     File Sys Page Fault Rate         0.00       0.00       0.00       0.00
     Window Turn Rate                 1.98       0.99       0.00       1.98

     File Lookup Rate                 0.33       1.40       0.00       4.63
     File Open Rate                   2.00       3.54       2.00       5.10
     Erase Rate                       0.00       0.00       0.00       0.00

This example shows that the rate of files opened during the last 10-second collection interval was 2.0 (for a total of 20). The average rate since the MONITOR command was entered is 3.54; the highest rate achieved during any 10-second interval is 5.10, and the lowest rate of 2.0 occurred during the last interval.

MONITOR FILE_SYSTEM_CACHE

The MONITOR FILE_SYSTEM_CACHE command initiates monitoring of the FILE_SYSTEM_CACHE statistics class.

Format

MONITOR FILE_SYSTEM_CACHE


Command Qualifiers

/qualifier[,...]

One or more qualifiers as described in the Command Qualifier Descriptions section.

Classname Qualifiers

/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.

/AVERAGE

Specifies that a bar graph of average statistics is to be included in the display and summary outputs.

/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.

/MAXIMUM

Specifies that a bar graph of maximum statistics is to be included in the display and summary outputs.

/MINIMUM

Specifies that a bar graph of minimum statistics is to be included in the display and summary outputs.

Description

The FILE_SYSTEM_CACHE class includes the following data items:
Data Item Description
Directory FCB Hit% Percentage of directory file control block hits on the directory cache. The percentage value shown is the ratio of hits to the sum of hits plus misses.
Directory FCB Attempt Rate Rate at which attempts were made to find directory file control blocks in the directory cache.
Directory Data Hit% Percentage of directory data hits on the directory cache. The percentage value shown is the ratio of hits to the sum of hits plus misses.
Directory Data Attempt Rate Rate at which attempts were made to find directory data in the directory cache.
File Header Hit% Percentage of file header hits on the file header cache. The percentage value shown is the ratio of hits to the sum of hits plus misses.
File Header Attempt Rate Rate at which attempts were made to find file headers in the file header cache.
File ID Hit% Percentage of file identifier hits on the file ID cache. The percentage value shown is the ratio of hits to the sum of hits plus misses.
File ID Cache Attempt Rate Rate at which attempts were made to find file identifiers in the file ID cache.
Extent Cache Hit% Percentage of appropriate size extent hits on the extent cache. The percentage value shown is the ratio of hits to the sum of hits plus misses.
Extent Cache Attempt Rate Rate at which attempts were made to find appropriate size extents in the extent cache.
Quota Cache Hit% Percentage of quota entry hits on the quota cache. The percentage value shown is the ratio of hits to the sum of hits plus misses.
Quota Cache Attempt Rate Rate at which attempts were made to find entries in the quota cache.
Bitmap Cache Hit% Percentage of entry hits on the bitmap cache. The percentage value shown is the ratio of hits to the sum of hits plus misses.
Bitmap Cache Attempt Rate Rate at which attempts were made to find entries in the bitmap cache.

Note that all items shown in the FILE_SYSTEM_CACHE display except Dir FCB apply only to XQPs. The Dir FCB item applies to both XQPs and the ODS-1 ACP.


Example


MONITOR> MONITOR FILE_SYSTEM_CACHE








                            OpenVMS Monitor Utility
                         FILE SYSTEM CACHING STATISTICS
                                 on node SAMPLE
                              29-APR-2000 13:08:53

                                       CUR        AVE        MIN        MAX

    Dir FCB    (Hit %)              100.00     100.00       0.00     100.00
               (Attempt Rate)         1.66       0.49       0.00       1.66
    Dir Data   (Hit %)              100.00     100.00       0.00     100.00
               (Attempt Rate)         4.66       1.24       0.00       4.66
    File Hdr   (Hit %)               66.00      80.00       0.00     100.00
               (Attempt Rate)         1.00       0.41       0.00       1.00
    File ID    (Hit %)                0.00       0.00       0.00       0.00
               (Attempt Rate)         0.00       0.00       0.00       0.00

    Extent     (Hit %)                0.00     100.00       0.00     100.00
               (Attempt Rate)         0.00       0.24       0.00       1.00
    Quota      (Hit %)                0.00     100.00       0.00     100.00
               (Attempt Rate)         0.00       0.16       0.00       0.66
    Bitmap     (Hit %)                0.00       0.00       0.00       0.00
               (Attempt Rate)         0.00       0.00       0.00       0.00


Previous Next Contents Index