Document revision date: 19 July 1999
[Compaq] [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]
[OpenVMS documentation]

OpenVMS System Management Utilities Reference Manual


Previous 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

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.


Examples

#1

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.

#2

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.

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

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.


Previous Next Contents Index

  [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]  
  privacy and legal statement  
6048PRO_043.HTML