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:30)  Array 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 V5R2.0.

    Last updated on 11 Dec 2005 at 18:48:12.

    Copyright IBM Corporation, 1990, 2005