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 V5R1.0.
Last updated on 13 Sep 2004 at 11:25:22.
Copyright IBM Corporation, 1990, 2004