HP OpenVMS System Management Utilities Reference Manual

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.

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.

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.

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.

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

Examples

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.

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