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:30Array 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 V4R4.0.
Last updated on 22 Jul 2003 at 15:04:23.
Copyright IBM Corporation, 1990, 2003