|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRPRCMFM
PrologControl Block Contents
Cross Reference
MRPRCMFM Prolog
DSECT NAME - PRCMFM
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRPRCMFM
DESCRIPTIVE NAME - Monitor Sample Record
Domain 5 - Processor Domain
Record 20 - MT CPUMF Counters
DESCRIPTION - Provides CPU Measurement Facility counter
values for the MT counter sets which are
available if and only if MT is enabled.
MT counter sets are not under control
of the CPUMFC operand which controls the
recording of the other CPUMF counters in
the D5R13 record. This monitor record
is reported when MT is enabled and Processor
Domain Sample record reporting is enabled.
This monitor record is recorded for all
logical CPUs regardless of whether there
are multiple CPUs per core for the CPU type.
The MT-Diagnostic counter set reported in
this record is a core-wide counter set so
the same data is reported on all threads of
the same core. However, it is possible that
the values do not match if the counters
were extracted for the core between the
generation of records for each thread.
It is reasonable to always use the thread 0
records as a means of selecting a complete
set of data with no redundancy for the
MT-Diagnostic counter set.
When the P bit is 1, one or more additional
monitor records are generated in the same
interval with the P bit = 1 in each interim
record and the P bit = 0 in the final
record. If a counter set is split across
multiple records the offset and length
fields will be nonzero in consecutive records
and the complete counter set is obtained
by concatenating the data from those
consecutive records. When data are split
across multiple records, PRCMFM_CAL_MFMMASK
will have bits set for all counter sets
reported in the complete set of records.
NOTES -
For additional information about the format and
meaning of fields defined in this record, refer to
the following book:
- Load-Program-Parameter and CPU-Measurement
Facilities (SA23-2260)
When multiple MT counter sets are reported in this
record, the data will be reported sequentially by
position of the counter set in PRCMFM_CAL_MFMMASK.
The length of each counter set will be as reported
in SA23-2260.
The only measurement alert that applies to the
MT counter sets is the loss-of-MT-counter-data.
Therefore this record does not include CCFCTLCD.
Instead CORCTLMT is included which records the
number of loss-of-MT-counter-data conditions
detected.
This record doesn't include RCCLFTIM which is
included in D5R13 because counter lifetimes don't
apply to MT counter sets. MT counter sets can't be
activated/deactivated by CP or be reset in other
ways.
MRPRCMFM Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 80+ PRCMFM Start of monitor record 0 0 Character 0 PRCMFM_MRHDR Record header. See MRRECHDR for details. 0 0 Character 20 MRHDR 0 0 Unsigned 2 MRHDRLEN 2 2 Unsigned 2 MRHDRZER 4 4 Unsigned 1 MRHDRDM 5 5 Unsigned 1 * 6 6 Unsigned 2 MRHDRRC 8 8 Character 8 MRHDRTOD 16 10 Character 4 * 20 14 Character 0 MRHDR_END 20 14 Character 60 PRCMFM_INTRO Introductory section 20 14 Unsigned 2 PRCMFM_INTLEN Length of intro section 22 16 Unsigned 2 PRCMFM_PFXCPUAD Processor address 24 18 Bitstring 1 PRCMFM_CAL_MFMMASK Mask of counter sets that are currently activated and are reported in this monitor record. 1... .... * .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 25 19 Bitstring 1 * 1... .... * .1.. .... * ..1. .... PRCMFM_QCIMT1CS MT-Diagnostic counter set. ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 26 1A Unsigned 1 * Reserved for IBM use 27 1B Unsigned 1 PRCMFM_FLAGS Flags 1... .... PRCMFM_P P bit: when P=1, this record is a partial response and the response is continued in the next MRPRCMFM record. When P=0 either the entire response is returned in this record or this record completes a partial response. .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 28 1C Unsigned 4 PRCMFM_CORCTLMT Cumulative number of times a Loss-of-MT-counter-data condition was detected. 32 20 Unsigned 4 PRCMFM_CORCTMON Reserved for IBM use 36 24 Unsigned 4 PRCMFM_CORCPUSP CPU Speed (cycles/microsec) 40 28 Unsigned 4 PRCMFM_COREXTCT Count of times MT counters were extracted. 44 2C Unsigned 2 PRCMFM_CORCFVN Hardware reported counter first version number 46 2E Unsigned 2 PRCMFM_CORCSVN Hardware reported counter second version number 48 30 Character 8 PRCMFM_COREXTTM TOD clock value when counters were harvested 56 38 Unsigned 2 PRCMFM_MTCSOFF Offset to MT counter set data. 58 3A Unsigned 2 PRCMFM_MTCSLEN Length of MT counter set data. 60 3C Unsigned 1 * Reserved for IBM use 61 3D Unsigned 1 PRCMFM_TID Thread ID for this processor. 62 3E Unsigned 2 PRCMFM_CORID Core ID for this Processor 64 40 Unsigned 4 PRCMFM_CORRESV1 Reserved for IBM use 68 44 Unsigned 4 PRCMFM_CORRESV2 Reserved for IBM use 72 48 Unsigned 4 PRCMFM_CORRESV3 Reserved for IBM use 76 4C Unsigned 4 PRCMFM_CORRESV4 Reserved for IBM use 80 50 Character 0 PRCMFM_INTEND 80 4C Unsigned 0+ PRCMFM_COUNTERS MT counter data. The offset and length should always be used to determine the byte offset to the counter set in this record and the byte length data for that counter set.
MRPRCMFM Cross Reference
Hex Hex
Name Offset Length Value
MRHDR 0 20
MRHDR_END 14 0
MRHDRDM 4 1
MRHDRLEN 0 2
MRHDRRC 6 2
MRHDRTOD 8 8
MRHDRZER 2 2
PRCMFM 0 80+
PRCMFM_CAL_MFMMASK 18 2
PRCMFM_CORCFVN 2C 2
PRCMFM_CORCPUSP 24 4
PRCMFM_CORCSVN 2E 2
PRCMFM_CORCTLMT 1C 4
PRCMFM_CORCTMON 20 4
PRCMFM_COREXTCT 28 4
PRCMFM_COREXTTM 30 8
PRCMFM_CORID 3E 2
PRCMFM_CORRESV1 40 4
PRCMFM_CORRESV2 44 4
PRCMFM_CORRESV3 48 4
PRCMFM_CORRESV4 4C 4
PRCMFM_COUNTERS 50 0+
PRCMFM_FLAGS 1B 1
PRCMFM_INTEND 50 0
PRCMFM_INTLEN 14 2
PRCMFM_INTRO 14 60
PRCMFM_MRHDR 0 0
PRCMFM_MTCSLEN 3A 2
PRCMFM_MTCSOFF 38 2
PRCMFM_P 1B 80
PRCMFM_PFXCPUAD 16 2
PRCMFM_QCIMT1CS 18 80
PRCMFM_TID 3D 1
This information is based on z/VM V6R3.0.
Last updated on 11 Mar 2015 at 17:43:38.
Copyright IBM Corporation, 2015