OpenVMS System Management Utilities Reference Manual

Updated: 11 December 1998

OpenVMS System Management Utilities Reference Manual

Contents

Index

MONITOR LOCK

The MONITOR LOCK command initiates monitoring of the LOCK class.

Format

MONITOR LOCK

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
Selects average statistics to be displayed in a bar graph for display and summary output.
/CURRENT
Selects current statistics to be displayed in a bar graph for display and summary output. The /CURRENT qualifier is the default for the CLUSTER, MODES, STATES, SYSTEM, and VECTOR classes.
/MAXIMUM
Selects maximum statistics to be displayed in a bar graph for display and summary output.
/MINIMUM
Selects minimum statistics to be displayed in a bar graph for display and summary output.

Description

The LOCK class includes the following data items:

Data Item Description

New ENQ Rate Rate of new lock (ENQ) requests (as opposed to conversions)

Converted ENQ Rate Rate of lock (ENQ) conversion requests

DEQ Rate Rate of unlock (DEQ) requests

Blocking AST Rate Rate of lock manager blocking ASTs delivered

ENQs Forced To Wait Rate Rate of occurrence of locks that could not be granted immediately, thus causing a wait

ENQs Not Queued Rate Rate of occurrence of locks that could not be granted immediately but requested not to be queued, and thus received an error status instead

Deadlock Search Rate Rate at which a deadlock search was performed

Deadlock Find Rate Rate at which deadlocks were found

Total Locks Total number of locks in the system

Total Resources Total number of resources in the system

Data Item	Description
New ENQ Rate	Rate of new lock (ENQ) requests (as opposed to conversions)
Converted ENQ Rate	Rate of lock (ENQ) conversion requests
DEQ Rate	Rate of unlock (DEQ) requests
Blocking AST Rate	Rate of lock manager blocking ASTs delivered
ENQs Forced To Wait Rate	Rate of occurrence of locks that could not be granted immediately, thus causing a wait
ENQs Not Queued Rate	Rate of occurrence of locks that could not be granted immediately but requested not to be queued, and thus received an error status instead
Deadlock Search Rate	Rate at which a deadlock search was performed
Deadlock Find Rate	Rate at which deadlocks were found
Total Locks	Total number of locks in the system
Total Resources	Total number of resources in the system

Example

MONITOR> MONITOR /RECORD IO
MONITOR> MONITOR /INPUT=LOCKSTATS.DAT/SUMMARY/NODISPLAY LOCK/AVERAGE
   .
   .
   .
MONITOR> [Ctrl/Z]
$  TYPE MONITOR.SUM
 
 



  
    
      

       
  
 
  
                             OpenVMS Monitor Utility 
            +-----+        LOCK MANAGEMENT STATISTICS 
            | AVE |            on node SAMPLE       From:  29-APR-1998 08:00:00 
            +-----+                 SUMMARY         To:    29-APR-1998 17:00:00 
 
                                     0         5         10        15        20 
                                     + - - - - + - - - - + - - - - + - - - - -+ 
 New ENQ Rate                      2 |**** 
 Converted ENQ Rate                1 |** 
                                     |         |         |         |          | 
 DEQ Rate                          3 |****** 
 Blocking AST Rate                   | 
                                     |         |         |         |          | 
 ENQs Forced To Wait Rate            | 
 ENQs Not Queued Rate                | 
                                     |         |         |         |          | 
 Deadlock Search Rate                | 
 Deadlock Find Rate                  | 
                                     |         |         |         |          | 
 Total Locks                       3 |****** 
 Total Resources                   3 |****** 
                                     |         |         |         |          | 
                                     + - - - - + - - - - + - - - - + - - - - -+ 
 PLAYBACK                         SUMMARIZING

This example shows the average use of the lock management subsystem during a typical workday, based on data that was previously recorded.

MONITOR 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

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
Selects average statistics to be displayed in a bar graph for display and summary output.
/CPU

/NOCPU [=(x[,...])] (default)
In multiprocessor configurations, selects the CPU-specific form of output, where x specifies the CPU identification. If you specify /CPU without specifying a CPU identification, MONITOR displays MODES class statistics for each successive CPU until information for all active CPUs has been displayed. MONITOR then repeats the cycle beginning with the first CPU. If you specify one CPU identification, MONITOR displays statistics for that CPU only. If you specify multiple CPU identifications, MONITOR displays statistics for each successive CPU specified, then repeats the cycle beginning with the first specified CPU.
Note that if you specify multiple CPU identifications, MONITOR does not notify you if one or more of the specified CPUs is unavailable. If all of the CPU identifications that you specify do not exist, then MONITOR will behave as if /CPU were specified without any arguments.
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.
/CURRENT
Selects current statistics to be displayed in a bar graph for display and summary output. The /CURRENT qualifier is the default for the CLUSTER, MODES, STATES, SYSTEM, and VECTOR classes.
/MAXIMUM
Selects maximum statistics to be displayed in a bar graph for display and summary output.
/MINIMUM
Selects minimum statistics to be displayed in a bar graph for display and summary output.
/PERCENT

/NOPERCENT (default)
Controls whether statistics are expressed as percent values in display and summary output. The [NO]PERCENT qualifier is applicable only to the DISK, MODES, SCS, and STATES classes.

Description

The following data items, included in the MODES class, can be displayed as percentages of all processor (CPU) time or as rates of clock ticks (10 millisecond units) per second:

Data Item Description

Interrupt Stack (Interrupt State on Alpha systems) Time spent on the interrupt stack (on VAX systems) or in an interrupt state on a kernel stack (on Alpha systems).

MP Synchronization Time spent synchronizing multiple CPUs (applicable to multiprocessor systems only).

Kernel Mode Time spent in kernel mode, but not in an interrupt state.

Executive Mode Time spent in executive mode.

Supervisor Mode Time spent in supervisor mode.

User Mode Time spent in user mode executing instructions.

Compatibility Mode Time spent executing compatibility mode instructions. (This data item is meaningful only for VAX systems.)

Idle Time Time not spent in any of the other modes.

For multiprocessor systems, when you enter the MONITOR MODES command without using the /CPU qualifier to select specific CPUs, MONITOR produces a single modes screen similar to those produced for nonmultiprocessor systems. However, the statistics produced for multiprocessor systems reflect the combined time that all CPUs spent in each mode.

Data Item	Description
Interrupt Stack (Interrupt State on Alpha systems)	Time spent on the interrupt stack (on VAX systems) or in an interrupt state on a kernel stack (on Alpha systems).
MP Synchronization	Time spent synchronizing multiple CPUs (applicable to multiprocessor systems only).
Kernel Mode	Time spent in kernel mode, but not in an interrupt state.
Executive Mode	Time spent in executive mode.
Supervisor Mode	Time spent in supervisor mode.
User Mode	Time spent in user mode executing instructions.
Compatibility Mode	Time spent executing compatibility mode instructions. (This data item is meaningful only for VAX systems.)
Idle Time	Time not spent in any of the other modes.

Examples

MONITOR> MONITOR MODES /PERCENT
 
 



  
    
      

       
  
 
  
                             OpenVMS Monitor Utility 
                            TIME IN PROCESSOR MODES (%) 
              +-----+             on node SAMPLE 
              | CUR |          29-APR-1998  22:52:42 
              +-----+ 
                                     0%        25%       50%       75%     100% 
                                     + - - - - + - - - - + - - - - + - - - - -+ 
 Interrupt Stack                   4 |* 
                                     |         |         |         |          | 
 MP Synchronization                  | 
                                     |         |         |         |          | 
 Kernel Mode                       6 |** 
                                     |         |         |         |          | 
 Executive Mode                    2 | 
                                     |         |         |         |          | 
 Supervisor Mode                     | 
                                     |         |         |         |          | 
 User Mode                        72 |*************************** 
                                     |         |         |         |          | 
 Compatibility Mode                  | 
                                     |         |         |         |          | 
 Idle Time                        16 |****** 
                                     |         |         |         |          | 
                                     + - - - - + - - - - + - - - - + - - - - -+

This display shows that, over the last collection interval, the processor spent 72 percent of its time executing user code, 8 percent executing system code to service user requests in executive and kernel modes, and 4 percent processing interrupts on the interrupt stack. It was idle 16 percent of the time. Time spent executing OpenVMS RMS code is included in executive-mode time. Time spent executing DCL code is included in supervisor-mode time.
If you omit the /PERCENT qualifier or specify /NOPERCENT, MONITOR displays mode times as rates of clock ticks per second, where a clock tick is 10 milliseconds. On a uniprocessor, the rate value is equivalent to the percent value.

MONITOR> MONITOR MODES
 
 



  
    
      

       
  
 
  
                           OpenVMS Monitor Utility 
            +-----+         TIME IN PROCESSOR MODES 
            | CUR |              on node SAMPLE 
            +-----+           29-APR-1998 15:02:36 
 
Combined for 2 (of 4) CPUs           0         50        100       150      200 
                                     + - - - - + - - - - + - - - - + - - - - -+ 
 Interrupt Stack                     | 
                                     |         |         |         |          | 
 MP Synchronization                  | 
                                     |         |         |         |          | 
 Kernel Mode                       2 |* 
                                     |         |         |         |          | 
 Executive Mode                    1 |* 
                                     |         |         |         |          | 
 Supervisor Mode                     | 
                                     |         |         |         |          | 
 User Mode                       101 |******************** 
                                     |         |         |         |          | 
 Compatibility Mode                  | 
                                     |         |         |         |          | 
 Idle Time                        96 |****************** 
                                     + - - - - + - - - - + - - - - + - - - - -+

This example demonstrates output of the MONITOR MODES command for a multiprocessor system. Displayed statistics represent rates of clock ticks per second. Information in the upper left corner of the screen indicates that node SAMPLE has four CPUs, two of which are active. Because the command line does not include the /CPU qualifier, statistics reflect the combined time that all CPUs spent in each mode.

MONITOR MSCP_SERVER

The MONITOR MSCP_SERVER command initiates monitoring of the mass storage control protocol (MSCP) server class.

Format

MONITOR MSCP_SERVER

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
Selects average statistics to be displayed in a bar graph for display and summary output.
/CURRENT
Selects current statistics to be displayed in a bar graph for display and summary output. The /CURRENT qualifier is the default for the CLUSTER, MODES, STATES, SYSTEM, and VECTOR classes.
/MAXIMUM
Selects maximum statistics to be displayed in a bar graph for display and summary output.
/MINIMUM
Selects minimum statistics to be displayed in a bar graph for display and summary output.

Description

The MSCP server class consists of the following data items that can be useful in tuning the MSCP server:

Data Item Description

Server I/O Request Rate The rate at which remote processors request I/O transfers.

Read Request Rate The rate at which remote processors request Read I/O transfers.

Write Request Rate The rate at which remote processors request Write I/O transfers.

Extra Fragment Rate The rate at which the server issues extra fragments. One or more extra fragments are created when, due to buffering constraints, the MSCP server issues multiple I/Os in order to fulfill a single I/O request. For example, if the MSCP server breaks up a 64-block request into 4 fragments of 16 blocks, 3 extra fragments are created.

Fragmented Request Rate The rate at which fragmented requests occur. A fragmented request is a transfer request that the server fragments due to buffering constraints. For example, one fragmented request occurs when the server splits a 36-block request into 3 fragments of 16 blocks, 16 blocks, and 4 blocks. In this example, the server creates two extra fragments.

Buffer Wait Rate The rate at which "buffer waits" occur in the server. A buffer wait occurs when a request must wait for MSCP buffer memory.

Request Size Rates A histogram that displays the rate of requests for various block sizes.

Data Item	Description
Server I/O Request Rate	The rate at which remote processors request I/O transfers.
Read Request Rate	The rate at which remote processors request Read I/O transfers.
Write Request Rate	The rate at which remote processors request Write I/O transfers.
Extra Fragment Rate	The rate at which the server issues extra fragments. One or more extra fragments are created when, due to buffering constraints, the MSCP server issues multiple I/Os in order to fulfill a single I/O request. For example, if the MSCP server breaks up a 64-block request into 4 fragments of 16 blocks, 3 extra fragments are created.
Fragmented Request Rate	The rate at which fragmented requests occur. A fragmented request is a transfer request that the server fragments due to buffering constraints. For example, one fragmented request occurs when the server splits a 36-block request into 3 fragments of 16 blocks, 16 blocks, and 4 blocks. In this example, the server creates two extra fragments.
Buffer Wait Rate	The rate at which "buffer waits" occur in the server. A buffer wait occurs when a request must wait for MSCP buffer memory.
Request Size Rates	A histogram that displays the rate of requests for various block sizes.

Example

MONITOR> MONITOR MSCP_SERVER

OpenVMS Monitor Utility MSCP SERVER STATISTICS on node GLOBBO 29-APR-1998 09:51:43 CUR AVE MIN MAX Server I/O Request Rate 0.00 0.71 0.00 6.22 Read Request Rate 0.00 0.54 0.00 6.22 Write Request Rate 0.00 0.16 0.00 6.16 Extra Fragment Rate 0.00 0.00 0.00 0.00 Fragmented Request Rate 0.00 0.00 0.00 0.00 Buffer Wait Rate 0.00 0.00 0.00 0.00 Request Size Rates 1 0.00 0.07 0.00 0.98 (Blocks) 2-3 0.00 0.03 0.00 0.65 4-7 0.00 0.03 0.00 0.65 8-15 0.00 0.10 0.00 1.63 16-31 0.00 0.46 0.00 5.51 32-63 0.00 0.00 0.00 0.00 64+ 0.00 0.00 0.00 0.00

This example demonstrates use of the MONITOR MSCP_SERVER command to generate MSCP statistics on node GLOBBO.

MONITOR PAGE

The MONITOR PAGE command initiates monitoring of the PAGE class.

Format

MONITOR PAGE

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
Selects average statistics to be displayed in a bar graph for display and summary output.
/CURRENT
Selects current statistics to be displayed in a bar graph for display and summary output. The /CURRENT qualifier is the default for the CLUSTER, MODES, STATES, SYSTEM, and VECTOR classes.
/MAXIMUM
Selects maximum statistics to be displayed in a bar graph for display and summary output.
/MINIMUM
Selects minimum statistics to be displayed in a bar graph for display and summary output.

Description

The PAGE class includes the following data items:

Data Item Description

Page Fault Rate Rate of page faults for all working sets

Page Read Rate Rate of pages read from disk as a result of page faults

Page Read I/O Rate Rate of read I/O operations from disk as a result of page faults

Page Write Rate Rate at which pages were written to the page file

Page Write I/O Rate Rate of write I/O operations to the page file

Free List Fault Rate Rate at which pages were read from the free-page list as a result of page faults

Modified List Fault Rate Rate of pages read from the modified-page list as a result of page faults

Demand Zero Fault Rate Rate at which zero-filled pages were allocated as a result of page faults

Global Valid Fault Rate Rate of page faults for pages that are not in the process's working set, but are in physical memory and are indicated as valid pages in the systemwide global page tables

Writes In Progress Fault Rate Rate of pages read that were in the process of being written back to disk when faulted

System Fault Rate Rate of page faults for pages in system space

Free List Size Number of pages on the free-page list

Modified List Size Number of pages on the modified-page list

Data Item	Description
Page Fault Rate	Rate of page faults for all working sets
Page Read Rate	Rate of pages read from disk as a result of page faults
Page Read I/O Rate	Rate of read I/O operations from disk as a result of page faults
Page Write Rate	Rate at which pages were written to the page file
Page Write I/O Rate	Rate of write I/O operations to the page file
Free List Fault Rate	Rate at which pages were read from the free-page list as a result of page faults
Modified List Fault Rate	Rate of pages read from the modified-page list as a result of page faults
Demand Zero Fault Rate	Rate at which zero-filled pages were allocated as a result of page faults
Global Valid Fault Rate	Rate of page faults for pages that are not in the process's working set, but are in physical memory and are indicated as valid pages in the systemwide global page tables
Writes In Progress Fault Rate	Rate of pages read that were in the process of being written back to disk when faulted
System Fault Rate	Rate of page faults for pages in system space
Free List Size	Number of pages on the free-page list
Modified List Size	Number of pages on the modified-page list

Example

MONITOR> MONITOR PAGE

OpenVMS Monitor Utility PAGE MANAGEMENT STATISTICS on node SAMPLE 29-APR-1998 22:22:44 CUR AVE MIN MAX Page Fault Rate 26.82 18.27 9.66 26.82 Page Read Rate 3.97 2.65 1.33 3.97 Page Read I/O Rate 1.32 0.99 0.66 1.32 Page Write Rate 0.00 0.00 0.00 0.00 Page Write I/O Rate 0.00 0.00 0.00 0.00 Free List Fault Rate 13.90 10.96 8.00 13.90 Modified List Fault Rate 5.62 2.99 0.33 5.62 Demand Zero Fault Rate 4.63 2.65 0.66 4.63 Global Valid Fault Rate 1.32 0.66 0.00 1.32 Wrt In Progress Fault Rate 0.00 0.00 0.00 0.00 System Fault Rate 2.31 1.99 1.66 2.31 Free List Size 3164.00 3176.00 3164.00 3188.00 Modified List Size 155.00 131.00 107.00 155.00

This example shows that the current rate of pages read per read I/O operation is approximately 3 per second (Page Read Rate divided by Page Read I/O Rate). Note that while the page fault rate is currently at the highest point of the monitoring session, the majority of the pages are faulted from memory, not from disk.

Contents

Index

Legal

 
6048PRO_043.HTML