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.
     NOTES:
           Domain 5 Record 17 (MRPRCRCD) and Domain 5 Record 18
           (MRPRCDHF) are intended to replace this record. If
           these records are present in monitor data, they
           should be used instead of this record.

#### MRPRCPRP Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

      0   0  Structure  384  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
      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  Unsigned     2  PRCPRP_PFXCPUAD        Processor address
     22  16  Unsigned     2  *(0:30)                Reserved for IBM use.
                                                    Previously this field was
                                                    PRCPRP_PLSSTLNU, which was an
                                                    array of steal counts. See
                                                    MRPRCDHF for replacement steal
                                                    counts.
     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  *                      Reserved for IBM use.
                                                    Previously this field was
                                                    PRCPRP_DSVMAXUS, which was the
                                                    maximum number of users
                                                    allowed in the Processor
                                                    Local Dispatch Vector (PLDV).
                                                    See PRCDHF_SYSDVENT in
                                                    MRPRCDHF which has replaced
                                                    this field.
     96  60  Unsigned     4  *(3)                   Reserved for IBM use.
                                                    Previously this field was
                                                    PRCPRP_HFSAMPLE, PRCPRP_HFCOUNT,
                                                    PRCPRP_HFUSERZ, and
                                                    PRCPRP_HFUSERC. See MRPRCDHF
                                                    for replacement high frequency
                                                    sampling data for dispatch
                                                    vectors.
    108  6C  Character    8  *                      Reserved for IBM use.
                                                    Previous field is no longer
                                                    meaningful. (PRCPRP_CALUDED)
    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
                                                    X'32' = Parked Processor
    117  75  Character    3  *                      Reserved and available for
                                                    IBM use.
    120  78  Unsigned     4  *                      Reserved for IBM use.
                                                    Previously this field was
                                                    PRCPRP_HFUSERM. See MRPRCDHF
                                                    for replacement high frequency
                                                    sampling data for dispatch
                                                    vectors.
    124  7C  Unsigned     4  *(0:63)                Reserved for IBM use.
                                                    Previously this field was
                                                    PRCPRP_PLSSTLCT, which was an
                                                    array of steal counts. See
                                                    MRPRCDHF for replacement steal
                                                    counts.
    380 17C  Unsigned     1  PRCPRP_PFXCPUTY        Processor type. Valid values:
                                                    X'00' - General Purpose (CP)
                                                    X'02' - zSeries Application
                                                            Assist (zAAP)
                                                    X'03' - Integrated Facility for
                                                            Linux (IFL)
                                                    X'04' - Internal Coupling Facility
                                                            (ICF)
                                                    X'05' - zSeries Integrated
                                                            Information (zIIP)
    381 17D  Unsigned     1  PRCPRP_PFXSTATE        CPU Operating Status
                                                    Valid values:
                                                    000 x'00' CPU is online and
                                                              available
                                                    022 x'16' Attempting to quiesce
                                                              this CPU so it can be
                                                              taken offline
                                                    044 x'2C' CPU has been quiesced
                                                              and is in disable wait
                                                              state so it can be
                                                              taken offline
                                                    055 x'37' CPU is check-stopped
                                                    066 x'42' CPU is now logically
                                                              offline
                                                    110 x'6E' CPU is physically
                                                              offline
                                                    238 x'EE' CPU is in an unknown
                                                              state (SIGP
                                                              communication failure)
                                                    130 x'82' CPU is being brought
                                                              online
    382 17E  Character    2  *                      Reserved for IBM use
    384 180  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    384
    PRCPRP_END               180      0
    PRCPRP_MRHDR               0      0
    PRCPRP_PFXCPUAD           14      2
    PRCPRP_PFXCPUTY          17C      1
    PRCPRP_PFXDSPCS           54      4
    PRCPRP_PFXSTATE          17D      1
    PRCPRP_PFXTYPE            74      1
    PRCPRP_PLSDSPCM           58      4

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

    Last updated on 30 January 2023 at 15:36:19.

    Copyright IBM Corporation, 1990, 2023