HP OpenVMS Systems Documentation

Content starts here

OpenVMS System Management Utilities Reference Manual


Previous Contents Index

H.4.1.2 Class Prefix (Component Classes Only)

The class prefix always follows the class header for component class records. It contains data describing the number of elements (for example, processes for the PROCESSES class, disks for the DISK class) represented by the class records for the current collection interval. Unlike system class records, which have one data block per record, component classes have one data block per element.

One of the class prefix data items describes the number of elements (and therefore the number of data blocks) included in the class record. The other class prefix data item is used only for the PROCESSES class, and describes the number of processes included in the interval. The following discussion applies only to the PROCESSES class.

It is possible to monitor a number of processes so large that the required number of data blocks for one collection interval does not fit into a single maximum size record. In this case, the required number of PROCESSES class records is created to fully describe the processes.

All class headers in the set of PROCESSES class records for a given interval are identical, except for the setting of bit 0 in the MNR_CLS$W_FLAGS field. This bit is set to 1 for all records except the last, for which it is set to 0.

The class prefixes in the set of class records vary, as described in the table following the next figure. The contents of the MNR_CMP$L_ELTCT field depends on the number of data blocks contained in the record; the contents of the MNR_CMP$L_PCTINT field remain constant for each record in the set. All records in the set except the last contain as many data blocks as will fit into the maximum size record (32000 bytes). The last record in the set contains the remaining data blocks.

Figure H-7 illustrates the class prefix format.

Figure H-7 Class Prefix Format


The following table describes the fields in the class prefix. The class prefix is 8 bytes long.

Field Symbolic Offset Contents
Elements in
Record
MNR_CMP$L_ELTCT Count of elements (data blocks) in this record (1 longword).
Processes in
Interval
MNR_CMP$L_PCTINT Count of processes (data blocks) for this interval (1 longword). This field is for the PROCESSES class only. For other component classes, this longword is reserved to Compaq for future use.

H.4.2 Class Data Blocks

The size and format of each data block and the number of blocks per record depend on the class. System classes have one data block per record. Component classes have one data block per element. The fields within each block are performance data items.

The following sections describe the data items within the data block for each class. Every data item falls into one of three categories. It is either a count, a level, or an informational item. A count is a numeric quantity that increases at each succeeding interval for the duration of a system boot. A level is a numeric quantity that may increase or decrease at each succeeding interval. An informational item represents data that, rather than being a unit of performance measurement (as are the first two types), is descriptive in nature.

In the tables that follow, item types are identified by the letters C (count), L (level), and I (informational). Item types are shown in parentheses, following the length of the field. Class records are listed alphabetically.

H.4.2.1 CLUSTER Class Record

The CLUSTER class record contains data describing clusterwide CPU, memory, and locking activity. The CLUSTER class record has a record type of 19 and a size of 65 bytes. Note that when the CLUSTER class is recorded, the DISK and MODES classes are also recorded, even if not explicitly requested.

Figure H-8 illustrates the format of the CLUSTER class record.

Figure H-8 CLUSTER Class Record Format


The following table describes the fields in the data block for the CLUSTER class record.

Field Symbolic Offset Contents
CPU Busy MNR_CLU$L_CPU_BUSY Count of clock ticks (10-millisecond units) spent in all CPU modes since system was booted (longword,C)
Free List Size MNR_CLU$L_FRLIST Number of pages currently on the free list (longword,L)
Reserved MNR_CLU$L_RESERVED Reserved to Compaq
Total Locks MNR_CLU$L_TOTAL_LOCKS Total of all incoming, outgoing, and local ENQs, DEQs, and conversions (longword,C)
New ENQ Local MNR_CLU$L_ENQNEWLOC Count of new lock requests that originate and are performed on the system (local) (longword,C)
New ENQ Incoming MNR_CLU$L_ENQNEWIN Count of new lock requests that originate on other systems and are performed on this system (incoming) (longword,C)
New ENQ Outgoing MNR_CLU$L_ENQNEWOUT Count of new lock requests that originate on this system and are performed on other systems (outgoing) (longword,C)
ENQ Conversions Local MNR_CLU$L_ENQCVTLOC Count of lock conversion requests (local) (longword,C)
ENQ Conversions Incoming MNR_CLU$L_ENQCVTIN Count of lock conversion requests (incoming) (longword,C)
ENQ Conversions Outgoing MNR_CLU$L_ENQCVTOUT Count of lock conversion requests (outgoing) (longword,C)
DEQ Local MNR_CLU$L_DEQLOC Count of unlock requests (local) (longword,C)
DEQ Incoming MNR_CLU$L_DEQIN Count of unlock requests (incoming) (longword,C)
DEQ Outgoing MNR_CLU$L_DEQOUT Count of unlock requests (outgoing) (longword,C)

H.4.2.2 DECNET Class Record

The DECNET class record contains data describing the operation of the DECnet for OpenVMS subsystem. The DECNET class record has a record type of 8 and a size of 33 bytes.

Figure H-9 illustrates the format of the DECNET class record.

Figure H-9 DECNET Class Record Format


The following table describes the fields in the data block for the DECNET class record.

Field Symbolic Offset Contents
Arriving
Local Packets
MNR_NET$L_ARRLOCPK Count of arriving local packets (longword,C)
Departing
Local Packets
MNR_NET$L_DEPLOCPK Count of departing local packets (longword,C)
Arriving Transit
Packets
MNR_NET$L_ARRTRAPK Count of arriving transit packets (longword,C)
Transit Packets
Lost
MNR_NET$L_TRCNGLOS Count of packets lost because of transit congestion (longword,C)
Receiver Buffer
Failures
MNR_NET$L_RCVBUFFL Count of receiver buffer failures (longword,C)

H.4.2.3 DISK Class Record

The DISK class record contains data describing all disk devices in the system. The DISK class record has a record type of 12; its size depends on the number of disks being monitored. The size, in bytes, is calculated by adding the size of the class header, the class prefix, and the data blocks contained in the record. This is shown in the following formula:


13 + 8 + (37 * the value of MNR_CMP$L_ELTCT)

Figure H-10 illustrates the format of the DISK class record.

Figure H-10 DISK Class Record Format


The following table describes the fields in the data block for the DISK class record.

Field Symbolic Offset Contents
Allocation Class MNR_DSK$W_ALLOCLS Allocation class number (word,I)
Controller MNR_DSK$T_CTRLR Name of device controller (counted ASCII string) (4 bytes,I)
Unit Number MNR_DSK$W_UNITNO Unit number (word,I)
Flags MNR_DSK$B_FLAGS Total of 8 flag bits; if the low bit is set, the device is served by the MSCP server (byte,I)
Node Name MNR_DSK$T_NODENAME Name of cluster node where device resides (counted ASCII string) (8 bytes,I)
Volume Name MNR_DSK$T_VOLNAME Volume name of disk (ASCII) (12 bytes,I)
Operations MNR_DSK$L_OPCNT Count of I/O operations (longword,C)
Queue Length MNR_DSK$L_IOQUELN Sum of I/O request queue samples (longword,C)

H.4.2.4 DLOCK Class Record

The DLOCK class record contains data describing the operation of the Distributed Lock Management facility. The DLOCK class record has a record type of 14 and a size of 73 bytes.

Figure H-11 illustrates the format of the DLOCK class record.

Figure H-11 DLOCK Class Record Format


The following table describes the fields in the data block for the DLOCK class record.

Field Symbolic Offset Contents
New Locks
---Local
MNR_DLO$L_ENQNEWLOC Count of new lock requests that originate and are performed on this system (local) (longword,C)
New Locks
---Incoming
MNR_DLO$L_ENQNEWIN Count of new lock requests originating on another system and performed on this system (incoming) (longword,C)
New Locks
---Outgoing
MNR_DLO$L_ENQNEWOUT Count of new lock requests originating on this system and performed on another system (outgoing) (longword,C)
Lock Conversions
---Local
MNR_DLO$L_ENQCVTLOC Count of lock conversion requests (local) (longword,C)
Lock Conversions
---Incoming
MNR_DLO$L_ENQCVTIN Count of lock conversion requests (incoming) (longword,C)
Lock Conversions
---Outgoing
MNR_DLO$L_ENQCVTOUT Count of lock conversion requests (outgoing) (longword,C)
Unlocks---Local MNR_DLO$L_DEQLOC Count of unlock requests (local) (longword,C)
Unlocks---Incoming MNR_DLO$L_DEQIN Count of unlock requests (incoming) (longword,C)
Unlocks---Outgoing MNR_DLO$L_DEQOUT Count of unlock requests (outgoing) (longword,C)
Blocking ASTs
---Local
MNR_DLO$L_BLKLOC Count of lock manager blocking ASTs (local) (longword,C)
Blocking ASTs
---Incoming
MNR_DLO$L_BLKIN Count of lock manager blocking ASTs (incoming) (longword,C)
Blocking ASTs
---Outgoing
MNR_DLO$L_BLKOUT Count of lock manager blocking ASTs (outgoing) (longword,C)
Directory Functions
---Incoming
MNR_DLO$L_DIRIN Count of directory functions (incoming) (longword,C)
Directory Functions
---Outgoing
MNR_DLO$L_DIROUT Count of directory functions (outgoing) (longword,C)
Deadlock
Message Rate
MNR_DLO$L_DLCKMSG Count of incoming and outgoing lock manager messages required for deadlock detection (longword,C)

H.4.2.5 FCP Class Record

The FCP class record contains data describing the operation of the file system ACPs. The FCP class record has a record type of 5 and a size of 61 bytes.

Figure H-12 illustrates the format of the FCP class record.

Figure H-12 FCP Class Record Format


The following table describes the fields in the data block for the FCP class record.

Field Symbolic Offset Contents
FCP Calls MNR_FCP$L_FCPCALLS Count of QIO requests received by the file system (longword,C)
Disk Allocations MNR_FCP$L_ALLOC Count of QIO requests that caused allocation of disk space (longword,C)
New Files MNR_FCP$L_FCPCREATE Count of new files created (longword,C)
Read I/Os MNR_FCP$L_FCPREAD Count of read I/O operations from the disk by the file system (longword,C)
Write I/Os MNR_FCP$L_FCPWRITE Count of write I/O operations to disk by the file system (longword,C)
Volume Lock Waits MNR_FCP$L_VOLWAIT Number of times a wait state was entered by the XQP due to volume lock contention (longword,C)
CPU Time MNR_FCP$L_FCPCPU Count of clock ticks (10-millisecond units) of CPU time used by the file system (longword,C)
FCP Page Faults MNR_FCP$L_FCPFAULT Count of page faults for the file system (longword,C)
Window Turns MNR_FCP$L_FCPTURN Count of file-map window misses (longword,C)
Access MNR_FCP$L_ACCESS Count of file name lookup operations in file directories (longword,C)
Files Opened MNR_FCP$L_OPENS Count of files opened (longword,C)
Erase I/O
Operations
MNR_FCP$L_ERASE Count of erase I/O operations issued (longword,C)

H.4.2.6 FILE_SYSTEM_CACHE Class Record

The FILE_SYSTEM_CACHE class record contains data describing the operation of the caches for the file system ACPs and XQPs. The FILE_SYSTEM_CACHE class record has a record type of 11 and a size of 69 bytes.

Figure H-13 illustrates the format of the FILE_SYSTEM_CACHE class record.

Figure H-13 FILE_SYSTEM_CACHE Class Record Format


The following table describes the fields in the data block for the FILE_SYSTEM_CACHE class record.

Field Symbolic Offset Contents
Directory FCB
Cache Hits
MNR_FIL$L_DIRFCB_HIT Count of hits on directory FCB cache (longword,C)
Directory FCB
Cache Attempts
MNR_FIL$L_DIRFCB_TRIES Count of attempts on directory FCB cache (longword,C)
Directory Data
Cache Hits
MNR_FIL$L_DIRDATA_HIT Count of hits on directory data cache (longword,C)
Directory Data
Cache Attempts
MNR_FIL$L_DIRDATA_TRIES Count of attempts on directory data cache (longword,C)
File Header
Cache Hits
MNR_FIL$L_FILHDR_HIT Count of hits on file header cache (longword,C)
File Header
Cache Attempts
MNR_FIL$L_FILHDR_TRIES Count of attempts on file header cache (longword,C)
File ID
Cache Hits
MNR_FIL$L_FIDHIT Count of hits on file ID cache (longword,C)
File ID
Cache Attempts
MNR_FIL$L_FID_TRIES Count of attempts on file ID cache (longword,C)
Extent Cache
Hits
MNR_FIL$L_EXTHIT Count of hits on extent cache (longword,C)
Extent Cache
Attempts
MNR_FIL$L_EXT_TRIES Count of attempts on extent cache (longword,C)
Quota Cache
Hits
MNR_FIL$L_QUOHIT Count of hits on quota cache (longword,C)
Quota Cache
Attempts
MNR_FIL$L_QUO_TRIES Count of attempts on quota cache (longword,C)
Storage Bitmap
Cache Hits
MNR_FIL$L_STORAGMAP_HIT Count of hits on storage bitmap cache (longword,C)
Storage Bitmap
Cache Attempts
MNR_FIL$L_STORAGMAP_TRIES Count of attempts on storage bitmap cache (longword,C)

H.4.2.7 I/O Class Record

The I/O class record contains data describing the operation of the I/O subsystem. The I/O class record has a record type of 4 and a size of 69 bytes.

Figure H-14 illustrates the format of the I/O class record.

Figure H-14 I/O Class Record Format


The following table describes the fields in the data block for the I/O class record.

Field Symbolic Offset Contents
Direct I/Os MNR_IO$L_DIRIO Count of direct I/O operations (longword,C)
Buffered I/Os MNR_IO$L_BUFIO Count of buffered I/O operations (longword,C)
Mailbox Writes MNR_IO$L_MBWRITES Count of write-to-mailbox requests (longword,C)
Split Transfers MNR_IO$L_SPLTRANS Count of split transfers (longword,C)
Logical Name
Translations
MNR_IO$L_LOGNAM Count of logical name translations (longword,C)
Files Opened MNR_IO$L_OPENS Count of files opened (longword,C)
Page Faults MNR_IO$L_FAULTS Count of page faults for all working sets (longword,C)
Page Reads MNR_IO$L_PREADS Count of pages read from disk as a result of page faults (longword,C)
Page Read I/Os MNR_IO$L_PREADIO Count of read I/O operations from disk as a result of page faults (longword,C)
Page Writes MNR_IO$L_PWRITES Count of pages written to the page file (longword,C)
Page Write I/Os MNR_IO$L_PWRITIO Count of write I/O operations to the page file (longword,C)
Inswaps MNR_IO$L_ISWPCNT Count of working sets read into memory from the swap file (longword,C)
Free Page Count MNR_IO$L_FREECNT Number of pages currently on free-page list (longword,L)
Modified Page
Count
MNR_IO$L_MFYCNT Number of pages currently on modified-page list (longword,L)


Previous Next Contents Index