|
OpenVMS System Management Utilities Reference
Manual
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)
|
|