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 V5R4.0.
Last updated on 5 Sep 2008 at 20:31:30.
Copyright IBM Corporation, 1990, 2008