CCFBK | Back to Index page

| Prolog Control Block Contents CCFBK DSECT Storage Layout Cross Reference (Contains links to field and bit definitions) |
Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

CCFBK Prolog | Top of page

     NAME       : HCPCCFBK
     DESCRIPTION: CPU-Measurement Counter Facility Counters
     DSECT      : CCFBK
     FUNCTION   : Mapping of the CPU-Measurement Facility Counters
                  for all supported Counter First Version Number (CFVN)
                  and Counter Second Version Number (CSVN) combinations.
                  The MT counter set data is stored in the CORBK every
                  100 milliseconds whenever MT is enabled. Reporting
                  in Monitor D5 R20 (MRPRCMFM) is not subject to the
                  MONITOR SAMPLE command CPUMFC operand so HCPCCF is not
                  involved in extraction of the MT counters.
     LOCATED BY : PLSCCFBK
     CREATED BY : HCPMPS (when a PLSBK is allocated)
     DELETED BY : HCPMPS (when a PLSBK is released)
     REFERENCES : none
     SERIALIZED : Processor Local - updates are only made on the CPU
                  whose PLSBK points to this instance of the CCFBK.
                  Monitor Command Lock (MND_CMD_LOCK) - the collection
                  task is serialized by this lock to prevent a race
                  between two tasks collecting counters in the CCFBK
                  on each CPU.
     RELOCATION CONSIDERATIONS : None
     COMPATIBILITY AND MIGRATION CONCERNS : The format of this control block is defined in "The
                  Set-Program-Parameter and CPU-Measurement Facilities"
                  book and should not be modified.  If new CFVN/CSVN
                  combinations are created, new mappings will need
                  to be added to support them.

CCFBK Control Block Content | Top of page

     CCFBK DSECT
    Top of page

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      CCFBK          CPU-Measurement Counter Facility Counters
    0000    0 Signed       4 CCFCTLCD       Count of times a Measurement
                                            Alert external interruption
                                            reported Lost Counter Data
    0004    4 Signed       4 CCFCPUSP       CPU Speed (CPU cycles/microsec)
    0008    8 Bitstring    2 CCFCMFAC       Mask of CPU-Measurement Facility
                                            counters that were activated when
                                            this CPU last enabled or disabled
                                            collection of these counters (See
                                            QCIAC in HCPQCIBK COPY for
                                            definition of bits)
    000A   10 Signed       2 *              Reserved for future IBM use
    000C   12 Signed       2 CCFCFVN        Counter First Version Number
    000E   14 Signed       2 CCFCSVN        Counter Second Version Number
    0010   16 Signed       8 CCFTOD         TOD clock value when counters
                                            were harvested
    0018   24 Dbl-Word     8 CCFDATA (288)  Data is size of largest CFVN/CSVN
                                            format
          CCFDATADWS must be set to the maximum possible length of
          CCFDATA for the known combinations of CFVN/CSVN. To do this
          add the maximum number of counters for each counter set
          together in order (ie: BASIC+PROBLEM+CRYPTO+EXTENDED)
              00000123       CCFSIZE        (*-CCFBK+7)/8 size in double
                                            words
              00000918       CCFBSIZE       CCFSIZE*8 size in bytes
              00000120       CCFDATADWS     32+32+64+160 data length is
                                            length of longest format
              .... ....      CCFEXTCO       X'0' Extended counter set mask
                                            for STCCTM instruction
              .... ...1      CCFBASCO       X'1' Basic counter set mask for
                                            STCCTM instruction
              .... ..1.      CCFPROCO       X'2' Problem-state counter set
                                            mask for STCCTM instruction
              .... ..11      CCFCRYCO       X'3' Crypto-activity counter set
                                            mask for STCCTM instruction
              .... .1.1      CCFMTDCO       X'5' MT-Diagnostic counter set
                                            mask for STCCTM instruction.
              .... 1..1      CCFMTRCO       X'9' MT-Diagnostic counter set
                                            with reset mask for STCCTM
                                            instruction.
              000001C0       CCF04C1        448 Counter number for cycle
                                            count with one thread active
              000001C1       CCF04C2        449 Counter number for cycle
                                            count with two threads active

CCFBK Storage Layout | Top of page

    *** CCFBK - CPU-Measurement Counter Facility Counters
    *
    *     +---------------------------+---------------------------+
    *   0 |         CCFCTLCD          |         CCFCPUSP          |
    *     +-------------+-------------+-------------+-------------+
    *   8 |  CCFCMFAC   |/////////////|  CCFCFVN    |  CCFCSVN    |
    *     +-------------+-------------+-------------+-------------+
    *  10 |                        CCFTOD                         |
    *     +-------------------------------------------------------+
    *  18 |                                                       |
    *     =                       CCFDATA                         =
    *     |                                                       |
    *     +-------------------------------------------------------+
    * 918
    *
    *** CCFBK - CPU-Measurement Counter Facility Counters

CCFBK Cross Reference | Top of page

    Symbol         Dspl Value
    -------------- ---- -----
    CCFBASCO       0018 01
    CCFBSIZE       0018 00000918
    CCFCFVN        000C
    CCFCMFAC       0008
    CCFCPUSP       0004
    CCFCRYCO       0018 03
    CCFCSVN        000E
    CCFCTLCD       0000
    CCFDATA        0018
    CCFDATADWS     0018 00000120
    CCFEXTCO       0018 00
    CCFMTDCO       0018 05
    CCFMTRCO       0018 09
    CCFPROCO       0018 02
    CCFSIZE        0018 00000123
    CCFTOD         0010
    CCF04C1        0018 000001C0
    CCF04C2        0018 000001C1

This information is based on z/VM 7.2.0 Last updated on 24 Jun 2020 at 09:27:13 EDT.
Copyright IBM Corporation, 1990, 2020