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    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