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