Document revision date: 19 July 1999

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

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

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

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

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

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 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-1998 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 
 




      

The cache hits and misses reflect the effectiveness of file system caching. Generally, the size of the cache affects the hit rate. The Attempt Rate is the sum of hits plus misses; the Hit% is the percentage of attempts that were successful.

Unlike other MONITOR data items, the averages for the hit percentages are not calculated based on previous hit percentages. Instead, these values are calculated based on the total number of hits and the total number of attempts on a cache since the beginning of the Monitor request. This provides more accurate average values for the hit percentage items.

The directory FCB cache is checked whenever a directory lookup is performed. Directory lookups can be performed on file open, creation, deletion, extension, or truncation. If the file control block associated with the directory is found in the cache, a hit is recorded. Otherwise, a miss is recorded. Both hits and misses are counted as attempts.

The directory data cache is checked whenever a file lookup is performed. Directory lookups may be performed on file open, creation, deletion, extension, or truncation. If an entry for the file being accessed is found in the directory data cache, a hit is recorded. Otherwise, a miss is recorded. Both hits and misses are counted as attempts.

The file header cache is checked on file open, close, creation, deletion, extension, or truncation. If the file header for the file being accessed is found in the file header cache, a hit is recorded. Otherwise, a miss is recorded. Both hits and misses are counted as attempts.

The file identification cache is a list of file identifiers that are removed on file creation and returned on file deletion. The File ID hits indicate file numbers successfully removed or returned to the file ID cache. Otherwise, a miss is recorded. Both hits and misses are counted as attempts.

The extent cache is checked on file creation, deletion, extension, and truncation. An attempt is made to allocate space from the extent cache during file creation or extension. During file creation, if sufficient size is found, a hit is recorded. If the desired size is not found, or an entry is forced to be split, an attempt is recorded. During file deletion, if the blocks were returned to the cache without the extent cache becoming too large, a hit is recorded. Otherwise, a miss is recorded. Both hits and misses are counted as attempts.

If quota checking is enabled, the quota cache is checked on file creation, deletion, extension, and truncation. If the desired entry (the identifier matching that of the requester) is found in the quota cache, a hit is recorded. Otherwise, a miss is recorded. Both hits and misses are counted as attempts.

The bitmap cache contains blocks from the storage bitmap file. This cache is accessed when the extent cache cannot satisfy requests for disk space. High rates indicate fragmented volumes.

Data items in the FILE_SYSTEM_CACHE display correspond to SYSGEN ACP/XQP parameters, as follows:

FILE_SYSTEM_CACHE Item	ACP/XQP Parameters
Dir FCB	ACP_SYSACC
	ACP_DINDXCACHE
Dir Data	ACP_DIRCACHE
File Hdr	ACP_HDRCACHE
File ID	ACP_FIDCACHE
Extent	ACP_EXTCACHE
	ACP_EXTLIMIT
Quota	ACP_QUOCACHE
Bitmap	ACP_MAPCACHE

When you change the ACP/XQP cache parameters, remember to reboot the system to make the changes effective. For more information about these parameters, refer to Appendix C.

MONITOR IO

The MONITOR IO command initiates monitoring of the I/O class.

Format

MONITOR IO

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 IO class includes the following data items:

Data Item	Description
Direct I/O Rate	Rate of direct I/O (for example, disk and tape) operations
Buffered I/O Rate	Rate of buffered I/O (for example, terminal and line printer) operations
Mailbox Write Rate	Rate of write-to-mailbox requests received by the system
Split Transfer Rate	Rate at which transfers were split into multiple I/Os
Log Name Translation Rate	Rate of logical name translations
File Open Rate	Rate at which files were opened
Page Fault Rate	Rate of occurrence 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 of pages written to the page file
Page Write I/O Rate	Rate of write I/O operations to the page file
Inswap Rate	Rate at which working sets were read into memory from the swap file
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 /RECORD IO
 
 



  

    

      

      
 
  
 
  
                           OpenVMS Monitor Utility 
                             I/O SYSTEM STATISTICS 
                                 on node SAMPLE 
                              29-APR-1998 22:22:44 
 
                                       CUR        AVE        MIN        MAX 
 
     Direct I/O Rate                 15.33       4.46       0.33      15.33 
     Buffered I/O Rate               24.91      47.47      24.91      69.00 
     Mailbox Write Rate               0.00       0.45       0.00       2.95 
     Split Transfer Rate              1.66       1.56       0.33       3.97 
     Log Name Translation Rate       13.28      10.75       3.66      27.66 
     File Open Rate                   1.66       1.26       0.33       2.98 
 
     Page Fault Rate                 24.58      52.31      17.33     178.00 
     Page Read Rate                  12.29       9.00       0.00      26.88 
     Page Read I/O Rate               2.65       2.43       0.00       6.22 
     Page Write Rate                  0.00       6.69       0.00      58.66 
     Page Write I/O Rate              0.00       0.27       0.00       1.66 
     Inswap Rate                      0.00       0.00       0.00       0.00 
     Free List Size                3621.00    3604.09    3392.00    3771.00 
     Modified List Size              49.00      73.36       4.00     181.00 
 
                                                                      RECORDING 




      

This example shows that the direct I/O rate is currently at its highest level since the MONITOR command was entered and is significantly higher than the average rate. Termination of this command by Ctrl/C and entry of a MONITOR PROCESSES/TOPDIO command would show the top users of direct I/Os. Note that if I/O monitoring is begun at a later time, a new MONITOR request is defined. That is, it is not a continuation of the original request; the average, minimum, and maximum statistics are reinitialized. However, because the original request specified recording, that data can be played back for redisplay or summarization.

	privacy and legal statement
6048PRO_042.HTML