[an error occurred while processing this directive]

HP OpenVMS Systems Documentation

Content starts here

HP OpenVMS System Management Utilities Reference Manual


Previous Contents Index

MONITOR SCS

The MONITOR SCS command initiates monitoring of the System Communications Services (SCS) class.

Format

MONITOR SCS


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=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_DESCRIPTOR Specifies that statistics on the queued-for-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.

/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 SCS class is a component class. Data items for this class are collected for each node in the cluster. The SCS class consists of the following data items:
Data Item Description
Datagram Send Rate Rate at which datagrams are sent to another node.
Datagram Receive Rate Rate at which datagrams are received from another node.
Datagram Discard Rate Rate at which datagrams are discarded.
Message Send Rate Rate at which sequenced messages are sent to another node. Sequenced messages are exchanged between nodes to communicate with mass storage control protocol (MSCP) disks and the lock manager.
Message Receive Rate Rate at which sequenced messages are received from another node. Sequenced messages are exchanged between nodes to communicate with MSCP disks and the lock manager.
Send Data Rate Rate at which block send datas are initiated on the local node.
Kbytes Send Rate Rate at which kilobytes are sent, as a result of send datas initiated on the local node.
Request Data Rate Rate at which request datas are initiated on the local node.
Kbytes Request Rate Rate at which kilobytes are received, as a result of request datas initiated on the local node.
Kbytes Map Rate Rate at which kilobytes are mapped for block transfers. This is a rough measure of the data transfer rate between the local node and a remote node. Before any transfer can take place, a buffer must be mapped. The size of the accumulated buffers that were mapped is displayed by the Kbytes Map Rate. If request datas or send datas are initiated on the local or a remote node, then the Kbytes Map Rate reflects the number of kilobytes actually transferred between the two nodes.
Send Credit Queued Rate Rate at which connections are queued for a send credit. A connection is queued for a send credit whenever all of the buffers that were allocated by the remote node have been used.
Buffer Descriptor Queued Rate Rate at which connections are queued for a buffer descriptor. A connection is queued for a buffer descriptor whenever all of the buffer descriptors have been allocated by the local node. You can increase the number of buffer descriptors allocated on the local system by adjusting the system parameter SCSBUFFCNT.


Example


MONITOR> MONITOR SCS









                            OpenVMS Monitor Utility
                                 SCS STATISTICS
                                 on node CURLEY
                               29-APR-2003 10:21:46

    Kbytes Map Rate                    CUR        AVE        MIN        MAX

    CURLEY                            0.00       0.00       0.00       0.00
    MOE                               0.00       0.00       0.00       0.00
    LARRY                             0.00       0.00       0.00       0.00
    SHEMP                             5.64       3.81       1.98       5.64

The command in this example requests that kilobyte map rate statistics collected for SCS be displayed for each node in the cluster. The display shows block transfer map activity between the node CURLEY and the hierarchical storage controller (HSC) SHEMP. Note that each node in the cluster is identified by its SCS node name.

MONITOR 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


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.

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


Description

The STATES class shows the number of processes in each of the 14 scheduler states. The following table describes these scheduler states:
Scheduler State Description
Collided Page Wait (COLPG) Waiting for a faulted page in transition.
Mutex & Miscellaneous Resource Wait (MWAIT) Waiting for the availability of a mutual exclusion semaphore or a dynamic resource. The following table contains a summary of Mutex and Miscellaneous Resource Wait states and identifying codes, as they appear in the PROCESSES class display:
MWAIT Reason for Wait
MUTEX Mutual exclusion semaphore
RWAST AST wait (wait for system or special kernel AST)
RWBRK Breakthrough (wait for broadcast message)
RWCAP CPU capability required
RWCLU Cluster state transition wait
RWCSV Cluster server
RWIMG Image activation lock
RWLCK Lock database
RWMBX Mailbox full
RWMPB Modified page writer busy
RWMPE Modified page list empty
RWNPG Nonpaged dynamic memory
RWPAG Paged dynamic memory
RWPGF Page file full
RWQUO Job quota
RWSCS System Communications Services wait
RWSNP System snapshot
RWSWP Swap file space
Common Event Flag Wait (CEF) Waiting for a combination of event flags to be set in a common event block.
Page Fault Wait (PFW) Waiting for a page to be read as a result of a page fault; resident processes.
Local Event Flag Wait (LEF) Waiting for one or more local event flags to be posted; resident processes.
Local Event Flag (Outswapped) (LEFO) Waiting for one or more local event flags to be posted; outswapped processes.
Hibernate (HIB) Hibernating, or process has executed a hibernate request; resident processes.
Hibernate (Outswapped) (HIBO) Hibernating, or process has executed a hibernate request; outswapped processes.
Suspended (SUSP) Process has executed a suspend request; resident processes.
Suspended (Outswapped) (SUSPO) Process has executed a suspend request; outswapped processes.
Free Page Wait (FPW) Waiting for a free page of memory.
Compute (COM) Ready to use the processor; resident processes.
Compute (Outswapped) (COMO) Ready to use the processor; outswapped processes.
Current Process (CUR) Using the processor.

The data items can also be displayed as percentages of all processes.

Note that the Current Process is always the process running MONITOR, because MONITOR is running when each measurement is made.

For performance reasons, MONITOR does not synchronize the scanning of process state data structures with operating system use of those structures. It is therefore possible that MONITOR will display certain anomalous state indications.


Example


$ MONITOR/INPUT/SUMMARY/NODISPLAY -
_$/BEGINNING=29-APR-2003:13:00 -
_$/ENDING=29-APR-2003:14:00 STATES/PERCENT/ALL
$ TYPE MONITOR.SUM








                            OpenVMS Monitor Utility
                                 PROCESS STATES (%)
                                 on node SAMPLE       From: 29-APR-2003 13:00:00
                                    SUMMARY           To:   29-APR-2003 14:00:00

                                       CUR%       AVE%       MIN%       MAX%
     Collided Page Wait                0.0        0.0        0.0        0.0
     Mutex & Misc Resource Wait        0.0        0.0        0.0        0.0
     Common Event Flag Wait            0.0        0.0        0.0        0.0
     Page Fault Wait                   4.3        1.4        0.0        4.3
     Local Event Flag Wait            34.7       31.7       34.7       42.8
     Local Evt Flg (Outswapped)        0.0        9.0        0.0       19.4

     Hibernate                        43.4       40.7       43.4       52.1
     Hibernate (Outswapped)            0.0        4.3        0.0       15.4
     Suspended                         0.0        0.0        0.0        0.0
     Suspended (Outswapped)            0.0        0.0        0.0        0.0
     Free Page Wait                    0.0        0.0        0.0        0.0
     Compute                          13.0        7.3        4.3       13.0
     Compute (Outswapped)              0.0        0.8        0.0        3.2
     Current Process                   1.0        1.0        1.0        1.0
     PLAYBACK                     SUMMARIZING

The commands in this example generate and display a PROCESS STATES summary. Note that since use of the Return key is not permitted within a single MONITOR command following the MONITOR> prompt, the MONITOR command is entered at DCL level. The summary shows that, on the average, 14.1 percent of processes were swapped out for the summarized period. Note that the summary was requested for data covering only the hour between 1 P.M. and 2 P.M., although the input file could have contained data covering a longer period.

MONITOR 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


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

Because the SYSTEM class collects the most significant performance statistics from other classes in a single display, it is particularly useful to system managers and other users seeking a general overview of system activity. The SYSTEM class includes the following data items:
Interrupt Stack (on VAX systems) or Interrupt State (on Alpha and I64 systems)
MP Synchronization
Kernel Mode
Executive Mode
Supervisor Mode
User Mode
Compatibility Mode (meaningful on VAX systems only)
Idle Time
Process Count
Page Fault Rate
Page Read I/O Rate
Free List Size
Modified List Size
Direct I/O Rate
Buffered I/O Rate

The following two display formats are provided, depending on the classname qualifier specified:

  • A tabular style format for the /ALL qualifier
  • A bar graph style format for the /AVERAGE, /CURRENT, /MAXIMUM, and /MINIMUM qualifiers

Examples of these formats are at the end of this section. Note that the bar graph version of the SYSTEM class (shown in Example 2) contains the following data, which differs from the tabular version:

  • All of the CPU processor modes except Idle Time are summarized in the CPU Busy segment.
  • In the Page Fault segment, the page read I/O rate is indicated by a vertical bar. The bar provides a visual estimate of the proportion of the total page fault rate that caused read I/O operations (the hard fault rate). The hard fault rate appears to the left of the bar.
  • Four segments show the processes that are currently the top consumers of CPU (since the last screen update), page faults, direct I/Os, and buffered I/Os.

Beginning in OpenVMS Version 7.3, the following rate fields have increased in the MONITOR SYSTEM bar graph screen display:

Rate Name Old Rate New Rate
Page Fault 100 500
Hard Page Fault (vertical line on Page Fault display) 100 500
Direct I/O 60 500
Free List Size Shown in K blocks Shown in K, M, or G blocks (whichever is appropriate)
Mod (modified) List Size 5 digits; K blocks 8 digits; K, M, or G blocks (whichever is appropriate)
Buffered I/O 150 500

Any process that MONITOR designates as a top user process must be swapped in at the beginning and ending of the display interval or at the beginning and ending of the entire period covered by a summary.

When the lower bar graph (top user) and the corresponding upper bar graph (overall system measure) are tracking the same statistic for the same interval (as in Example 2), it is reasonable to compare the two graphs. This will be the case in the following situation:

  • SYSTEM is the only class being monitored (no other class names have been specified with the MONITOR command).
  • The CURRENT statistic is specified.
  • The /INTERVAL and /VIEWING_TIME values are equal.

Otherwise, exercise care in making such comparisons because the top user statistic is always CURRENT, while the overall system measure statistic may be CURRENT, AVERAGE, MAXIMUM, or MINIMUM.

Rates for top users are calculated based on the interval between two successive screen displays, while overall system rates are based on the collection interval. These two interval values can be different whenever one or more classes are being monitored with the SYSTEM class, or when /INTERVAL and /VIEWING_TIME values differ.

While other upper boundary figures for the SYSTEM class bar graphs are constants, the figures for Free List Size and Modified List Size are derived from the physical memory configuration and system parameters of individual systems. The upper boundary figure for the Free List is the number of pages available after deducting the pages permanently allocated to the operating system. This figure, sometimes referred to as balance set memory, is the number of pages that can be allocated to processes, the Free List, and the Modified List. The upper boundary figure for the Modified List is the value of the MPW_HILIMIT system parameter. Note that both upper boundary figures are calculated when the MONITOR request is initiated and do not change thereafter.


Examples

#1

MONITOR> MONITOR SYSTEM/ALL








                           OpenVMS Monitor Utility
                               SYSTEM STATISTICS
                                 on node SAMPLE
                              29-APR-2003 12:43:28

                                       CUR        AVE        MIN        MAX

    Interrupt Stack                   0.33       0.33       0.33       0.33
    MP Synchronization                0.00       0.00       0.00       0.00
    Kernel Mode                       0.16       0.16       0.16       0.16
    Executive Mode                    0.00       0.00       0.00       0.00
    Supervisor Mode                   0.00       0.00       0.00       0.00
    User Mode                         0.50       0.49       0.50       0.50
    Compatibility Mode                0.00       0.00       0.00       0.00
    Idle Time                        99.00      98.67      99.00      99.00
    Process Count                    14.00      14.00      14.00      14.00
    Page Fault Rate                   0.33       0.33       0.33       0.33
    Page Read I/O Rate                0.00       0.00       0.00       0.00
    Free List Size                 4255.00    4255.00    4255.00    4255.00
    Modified List Size              105.00     105.00     105.00     105.00
    Direct I/O Rate                   0.00       0.00       0.00       0.00
    Buffered I/O Rate                 0.16       0.16       0.16       0.16

This example shows the tabular style format for the SYSTEM display.

#2

MONITOR> MONITOR SYSTEM









Node: BRS004                OpenVMS Monitor Utility      5-JUN-2003 10:45:32
Statistic: CURRENT             SYSTEM STATISTICS
                                                     Process States
          + CPU Busy (400)          -+         LEF:    15      LEFO:     0
          |**************************|         HIB:    14      HIBO:     0
CPU     0 +--------------------------+ 400     COM:     8      COMO:     0
          |*                         |         PFW:     0      Other:    1
          +--------------------------+         MWAIT:   0
          Cur Top: BATCH_27 (6)                          Total: 38

          + Page Fault Rate (1438)  -+         + Free List Size (35173)   +
          |****|*********************|         |****************          | 54K
MEMORY  0 +--------------------------+ 500   0 +--------------------------+
          |****                      |         |*************             | 5765
          +--------------------------+         + Mod List Size (3078)     +
          Cur Top: BATCH_29 (78)

          + Direct I/O Rate (442)   -+         + Buffered I/O Rate (112) -+
          |**********************    |         |*****                     |
I/O     0 +--------------------------+ 500   0 +--------------------------+ 500
          |*                         |         |                          |
          +--------------------------+         +--------------------------+
          Cur Top: BATCH_24 (23)               Cur Top: BATCH_24 (6)


Previous Next Contents Index