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

#### MRPRCPRP

Prolog
Control Block Contents
Cross Reference

#### MRPRCPRP Prolog

####

####

     DSECT NAME - PRCPRP
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRPRCPRP
     DESCRIPTIVE NAME - Monitor Sample Record
                        Domain 5 - Processor Domain
                        Record 3 - Processor Data (Per Processor)
     DESCRIPTION - Provides data related to work dispatched on a real
                   processor.  A separate record is generated for each
                   real processor.

    MRPRCPRP Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)          Description

      0   0  Structure  124  PRCPRP              Start of monitor record
      0   0  Character    0  PRCPRP_MRHDR        Record header. See MRRECHDR for
                                                 details.
      0   0  Character   20  MRHDR
      0   0  Unsigned     2  MRHDRLEN            record length in bytes
      2   2  Unsigned     2  MRHDRZER            field of zeros
      4   4  Unsigned     1  MRHDRDM             domain identifier
      5   5  Unsigned     1  *
      6   6  Unsigned     2  MRHDRRC             record identifier
      8   8  Character    8  MRHDRTOD            Time at which this record was
                                                 built. In time-of-day (TOD) clock
                                                 format. See IBM System 370 XA
                                                 Principle of Operation for
                                                 explanation of format.
     16  10  Character    4  *
     20  14  Character    0  MRHDR_END           End of header
     20  14  Unsigned     2  PRCPRP_PFXCPUAD     Processor address
     22  16  Unsigned     2  PRCPRP_PLSSTLNU(0:30Array of counts of 'stolen'
                                                 VMDBKs, one count for each
                                                 processor from which the VMDBK was
                                                 stolen. This array does not
                                                 include the master-only processor
                                                 since its work cannot be
                                                 dispatched by another processor.
     84  54  Unsigned     4  PRCPRP_PFXDSPCS     Count of 'long paths' through
                                                 the dispatcher. This is roughly
                                                 the number of times a different
                                                 user was selected to be
                                                 dispatched. It includes also the
                                                 number of times a running user was
                                                 examined to see if it should
                                                 continue to run, and was selected
                                                 to run again (no switch made).
     88  58  Unsigned     4  PRCPRP_PLSDSPCM     Count of times a VMDBK was
                                                 chosen to be dispatched, then had
                                                 to be moved to the master
                                                 processor for master-only work.
                                                 This is the only time work will be
                                                 passed from a non-master-processor
                                                 to another processor.
     92  5C  Unsigned     4  PRCPRP_DSVMAXUS     Maximum number of users allowed
                                                 in the Processor Local Dispatch
                                                 Vector (PLDV)
     96  60  Character   28  PRCPRP_HFSAMPLE
     96  60  Unsigned     4  PRCPRP_HFCOUNT      Number of times this processor
                                                 was sampled for high frequency
                                                 data.
    100  64  Unsigned     4  PRCPRP_HFUSERZ      High-frequency count. Number of
                                                 times the Processor Local Dispatch
                                                 Vector (PLDV) had no VMDBKs
    104  68  Unsigned     4  PRCPRP_HFUSERC      High-frequency count. Number of
                                                 VMDBKs in the Local Dispatch
                                                 Vector (PLDV) when the PLDV was
                                                 not empty. DSVUSERC
    108  6C  Character    8  PRCPRP_CALUDED      If processor is dedicated, this
                                                 is the userid to which it is
                                                 dedicated. Otherwise, the field is
                                                 binary zeros.
    116  74  Unsigned     1  PRCPRP_PFXTYPE      Host CPU usage type identifier.
                                                 Processor type is: X'14' = Master
                                                 Processor X'1E' = Dedicated
                                                 Processor X'28' = Alternate
                                                 Processor
    117  75  Character    3  *                   Reserved and available for IBM
                                                 use.
    120  78  Unsigned     4  PRCPRP_HFUSERM      High-frequency count. Number of
                                                 VMDBKs in the master-only Local
                                                 Dispatch Vector (PLDV). This
                                                 varies from PRCPRP_HFUSERC which
                                                 for the master processor is the
                                                 sum of VMDBKs in both the
                                                 master-only PLDV and the normal
                                                 PLDV.
    124  7C  Character    0  PRCPRP_END

    MRPRCPRP 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
    PRCPRP                  0    124
    PRCPRP_CALUDED         6C      8
    PRCPRP_DSVMAXUS        5C      4
    PRCPRP_END             7C      0
    PRCPRP_HFCOUNT         60      4
    PRCPRP_HFSAMPLE        60     28
    PRCPRP_HFUSERC         68      4
    PRCPRP_HFUSERM         78      4
    PRCPRP_HFUSERZ         64      4
    PRCPRP_MRHDR            0      0
    PRCPRP_PFXCPUAD        14      2
    PRCPRP_PFXDSPCS        54      4
    PRCPRP_PFXTYPE         74      1
    PRCPRP_PLSDSPCM        58      4
    PRCPRP_PLSSTLNU        16     62

    This information is
    based on z/VM V4R4.0.

    Last updated on 22 Jul 2003 at 15:04:23.

    Copyright IBM Corporation, 1990, 2003