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 MRPRCHDF
                                                for replacement high frequency
                                                sampling data for dispatch
                                                vectors.
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
                                                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
                                                MRPRCHDF 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_CALUDED            6C      8
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 V6R4.0.

Last updated on 5 Oct 2016 at 13:24:19.
Copyright IBM Corporation, 1990, 2016