|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRPRCMFC
PrologControl Block Contents
Cross Reference
MRPRCMFC Prolog
DSECT NAME - PRCMFC
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRPRCMFC
DESCRIPTIVE NAME - Monitor Sample Record
Domain 5 - Processor Domain
Record 13 - CPU Measurement Facility Counters
DESCRIPTION - Provides CPU Measurement Facility counter values.
values for the Basic, Problem-state,
Extended, and Crypto-activity counter sets.
These are the counter sets controlled by
the CPUMFC operand of the MONITOR SAMPLE
command. Independent of the CPUMFC setting,
the MT counter sets are reported in the
MRPRCMFM D5R20 - CPUMF MT Counters record.
One or more records are generated to include
all of the information for the processor's
CPUMF counter sets reported in this type
Monitor sample record.
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 last record.
Each record contains a portion of the CPUMF
counter data for the specified length. The
contents of an individual counter set may be
split across counter records. When multiple
records are generated the complete data are
obtained by concatenating PRCMFC_COUNTERS
values from consecutive records. The values
of all other fields in the record are
duplicated on the continuation records.
The PRCMFC_CCFCMFAC mask value indicates
the activation status of 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
books:
- Load-Program-Parameter and CPU-Measurement
Facilities (SA23-2260)
- CPU-Measurement Facility Extended Counters
Definition for System z10 and System z196
(SA23-2261)
MRPRCMFC Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 64+ PRCMFC Start of monitor record 0 0 Character 0 PRCMFC_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 * PRCMFC_INTRO Introductory section 20 14 Unsigned 2 PRCMFC_INTLEN Length of intro section 22 16 Unsigned 2 PRCMFC_PFXCPUAD Processor address 24 18 Bitstring 1 PRCMFC_CCFCMFAC Mask of counter sets that are currently activated 1... .... PRCMFC_COPROC Coprocessor-group .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 25 19 Bitstring 1 * 1... .... * .1.. .... * ..1. .... * ...1 .... * .... 1... PRCMFC_CRYPTO Crypto-activity .... .1.. PRCMFC_PROB Problem-state .... ..1. PRCMFC_BASIC Basic .... ...1 PRCMFC_EXT Extended 26 1A Unsigned 1 * Reserved for IBM use 27 1B Bitstring 1 PRCMFC_FLAGS Flags 1... .... PRCMFC_P P bit: when P=1, this is a partial response and response is continued in next MRPRCMFC 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 * 28 1C Unsigned 4 PRCMFC_CCFCTLCD Cumulative number of times a Measurement Alert external interruption reported Lost Counter Data 32 20 Unsigned 4 PRCMFC_RCCLFTIM A monotonically increasing 'counter lifetime' indicator 36 24 Unsigned 4 PRCMFC_CCFCPUSP CPU Speed (cycles/microsec) 40 28 Unsigned 2 PRCMFC_CFVN Data format counter first version number 42 2A Unsigned 2 PRCMFC_CSVN Data format counter second version number 44 2C Unsigned 2 PRCMFC_CCFCFVN Hardware reported counter first version number 46 2E Unsigned 2 PRCMFC_CCFCSVN Hardware reported counter second version number 48 30 Character 8 PRCMFC_CCFTOD TOD clock value when counters were harvested 56 38 Unsigned 2 PRCMFC_HWCOFF Offset to counters structure 58 3A Unsigned 2 PRCMFC_HWCLEN Length of counters structure 60 3C Unsigned 1 * Reserved for future IBM use 61 3D Unsigned 1 PRCMFC_TID Thread ID for this processor. 62 3E Unsigned 2 PRCMFC_CORID Core ID for this processor. 64 40 Character 0 PRCMFC_INTEND 64 40 Character 0+ PRCMFC_COUNTERS Hardware counters section. PRCMFC_HWCOFF and PRCMFC_HWCLEN should always be used to determine the byte offset of this field in the record and the byte length of this field.
MRPRCMFC 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
PRCMFC 0 64+
PRCMFC_BASIC 18 02
PRCMFC_CCFCFVN 2C 2
PRCMFC_CCFCMFAC 18 1
PRCMFC_CCFCPUSP 24 4
PRCMFC_CCFCSVN 2E 2
PRCMFC_CCFCTLCD 1C 4
PRCMFC_CCFTOD 30 8
PRCMFC_CFVN 28 2
PRCMFC_COPROC 18 80
PRCMFC_CORID 3E 2
PRCMFC_COUNTERS 40 0+
PRCMFC_CRYPTO 18 08
PRCMFC_CSVN 2A 2
PRCMFC_EXT 18 01
PRCMFC_FLAGS 1B 1
PRCMFC_HWCLEN 3A 2
PRCMFC_HWCOFF 38 2
PRCMFC_INTEND 40 0
PRCMFC_INTLEN 14 2
PRCMFC_INTRO 14 *
PRCMFC_MRHDR 0 0
PRCMFC_P 1B 80
PRCMFC_PFXCPUAD 16 2
PRCMFC_PROB 18 04
PRCMFC_RCCLFTIM 20 4
PRCMFC_TID 3D 1
This information is based on z/VM V6R4.0.
Last updated on 20 Sep 2019 at 15:30:52.
Copyright IBM Corporation, 1990, 2019