![[Digital logo]](../../IMAGES/DIGITAL-LOGO.GIF){kind=logo}
![[HR]](../../IMAGES/REDBAR.GIF)
The MONITOR FCP command initiates monitoring of the File Control Primitive statistics class, which includes information on all Files-11 Ancillary Control Processes (ACPs) and extended QIO processors (XQPs) on the local node.
MONITOR FCP
/qualifier[,...]
One or more qualifiers as described in the Command Qualifier Descriptions section.
/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.
The FCP class consists of the following data items, all of which are displayed as occurrences per second:
- 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.
MONITOR> MONITOR /INTERVAL=10 FCP
OpenVMS Monitor Utility
FILE PRIMITIVE STATISTICS
on node SAMPLE
29-APR-1996 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.
MONITOR FILE_SYSTEM_CACHE
/qualifier[,...]
One or more qualifiers as described in the Command Qualifier Descriptions section.
/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.
The FILE_SYSTEM_CACHE class includes the following data items:
- 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-1996 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 on these parameters, refer to Appendix J.
The MONITOR IO command initiates monitoring of the I/O class.
MONITOR IO
/qualifier[,...]
One or more qualifiers as described in the Command Qualifier Descriptions section.
/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.
The IO class includes the following data items:
- 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
MONITOR> MONITOR /RECORD IO
OpenVMS Monitor Utility
I/O SYSTEM STATISTICS
on node SAMPLE
29-APR-1996 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.
The MONITOR LOCK command initiates monitoring of the LOCK class.
MONITOR LOCK
/qualifier[,...]
One or more qualifiers as described in the Command Qualifier Descriptions section.
/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.
The LOCK class includes the following data items:
- 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 having to 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 a deadlock was found
- Total Locks---Total number of locks in the system
- Total Resources---Total number of resources in the system
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-1996 08:00:00
+-----+ SUMMARY To: 29-APR-1996 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.
The MONITOR MODES command initiates monitoring of the MODES class, which includes a data item for each mode of processor operation.
MONITOR MODES
/qualifier[,...]
One or more qualifiers as described in the Command Qualifier Descriptions section.
/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.
The following data items, included by the MODES class, can be displayed as percentages of all processor (CPU) time or as rates of clock ticks (10 millisecond units) per second:
- 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 only meaningful 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
MONITOR> MONITOR MODES /PERCENT
OpenVMS Monitor Utility
TIME IN PROCESSOR MODES (%)
+-----+ on node SAMPLE
| CUR | 29-APR-1996 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 |******
| | | | |
+ - - - - + - - - - + - - - - + - - - - -+)
MONITOR> MONITOR MODES
OpenVMS Monitor Utility
+-----+ TIME IN PROCESSOR MODES
| CUR | on node SAMPLE
+-----+ 29-APR-1996 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 |******************
+ - - - - + - - - - + - - - - + - - - - -+)
6048P035.HTM OSSG Documentation 26-NOV-1996 12:43:11.69
Copyright © Digital Equipment Corporation 1996. All Rights Reserved.