Programming Interface Information:
The Monitor Records are intended Programming Interfaces that
allow the customer to write programs to obtain services of z/VM.
Control Block Contents
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 ContentsOffsets 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 ReferenceHex 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