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.
                   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 V7R2.0.

    Last updated on 09 August 2020 at 14:44:52.

    Copyright IBM Corporation, 1990, 2020