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: 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