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:
            Valid values for PRCPRP_PFXSTATE are:
             000 - CPU is online and available
             022 - Attempting to quiesce this CPU so it can be
                   be taken offline
             044 - CPU has been quiesced and is in disable wait
                   state so it can be taken offline
             055 - CPU is check-stopped
             066 - CPU is now logically offline
             110 - CPU is physically offline
             238 - CPU is in an unknown state (SIGP
                   communication failure)
             130 - CPU is being brought online

    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. This
                                                    field used to be called
                                                    PRCPRP_PLSSTLNU and was filled
                                                    in using PLSSTLNU. See the new
                                                    field PRCPRP_PLSSTLCT which
                                                    supports 64 processors and now
                                                    uses fullword 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  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  Unsigned     4  PRCPRP_PLSSTLCT(0:63)  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.
    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
    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_CALUDED            6C      8
    PRCPRP_DSVMAXUS           5C      4
    PRCPRP_END               180      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_PFXCPUTY          17C      1
    PRCPRP_PFXDSPCS           54      4
    PRCPRP_PFXSTATE          17D      1
    PRCPRP_PFXTYPE            74      1
    PRCPRP_PLSDSPCM           58      4
    PRCPRP_PLSSTLCT           7C    256

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

    Last updated on 13 October 2009 at 14:39:30.

    Copyright IBM Corporation, 1990, 2009