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 44 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 44 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 V6R3.0.
Last updated on 11 Mar 2015 at 16:24:38.
Copyright IBM Corporation, 1990, 2015