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