Programming Interface Information:
The Monitor Records are intended Programming Interfaces that
allow the customer to write programs to obtain services of z/VM.

MRPRCMFC

Prolog
Control 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.
 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-01)
          - CPU-Measurement Facility Extended Counters
            Definition for System z10 and System z196
            (SA23-2261-01)


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      2  *                      Reserved for IBM use
  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      4  *                      Reserved for future IBM use
  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_COUNTERS           40      0
PRCMFC_CRYPTO             18           08
PRCMFC_CSVN               2A      2
PRCMFC_EXT                18           01
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_PFXCPUAD           16      2
PRCMFC_PROB               18           04
PRCMFC_RCCLFTIM           20      4

This information is based on z/VM V6R1.0.
Last updated on 09 Aug 2011 at 16:21:13.
Copyright IBM Corporation, 1990, 2011