Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRPRCDHF
PrologControl Block Contents
Cross Reference
MRPRCDHF Prolog
DSECT NAME - PRCDHF FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor Control Area REFERENCED CONTROL BLOCKS - MRRECHDR Monitor Record Header NAME - MRPRCDHF DESCRIPTIVE NAME - Monitor Sample Record Domain 5 - Processor Domain Record 18 - Dispatch Vector High Frequency Data DESCRIPTION - Provides high frequency sampling data related to dispatch vectors (DSVBKs). One stanza is provided for each DSVBK that is currently in use. The master DSVBK is indicated by a DSVBK id (PRCDHF_CALDSVID) of x'FFFF'. PRCDHF_RCCDSVCH is provided as a way to know whether CPU-to-DSVBK assignments have changed since the last sample. If they have, this record should not be compared with the previous. Events which cause CPU-to_DSVBK assignments to change include: - CPU topology changes - VARY ON|OFF of a CPU - Dedication/undedication of a virtual CPU When this record is present in monitor data, this record and Domain 5 Record 17 should be used instead of Domain 5 Record 3. Domain 5 Records 17 and 18 are intended to replace Domain 5 Record 3.
MRPRCDHF Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 44+ PRCDHF Start of monitor record 0 0 Character 0 PRCDHF_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 PRCDHF_SCOUNT Number of stanzas in this record 22 16 Unsigned 2 PRCDHF_SSIZE Size of a stanza (bytes) 24 18 Unsigned 2 PRCDHF_SOFFSET Offset within this record to the first stanza 26 1A Unsigned 2 PRCDHF_MAXRPROC This value defines the number of valid bits in bit masks: PRCDHF_DSVASSOC, PRCDHF_DSVUNPRK. 28 1C Unsigned 4 PRCDHF_RCCDSVCH Count of times CPU-to-DSVBK assignments have changed 32 20 Unsigned 4 PRCDHF_SYSDVENT Maximum number of VMDBKs allowed in a DSVBK 36 24 Unsigned 2 PRCDHF_OFSASSOC PRCDHF_DSVASSOC field offset from beginning of the stanza. 38 26 Unsigned 2 PRCDHF_OFSUNPRK PRCDHF_DSVUNPRK field offset from beginning of the stanza. 40 28 Unsigned 1 PRCDHF_CONT Record continuation identifier: 0 = The record does not continue into an additional record. This is the last record. 1 = The record continues into additional records. 41 29 Character 3 * Reserved for IBM use 44 2C Character 0 * Additional fields may be inserted before here. Use offsets to locate any fields after this point. 44 2C Character 0 PRCDHF_STANZAS Start of first stanza. The first stanza should be located by adding PRCDHF_SOFFSET to the address of this record. Subsequent stanzas should be located by adding PRCDHF_SSIZE to the address of the current stanza.
Mapping of the stanzas located beginning at PRCDHF_STANZAS.
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 16+ PRCDHF_STANZA Start of a stanza for a DSVBK 0 0 Unsigned 2 PRCDHF_CALDSVID DSVBK id 2 2 Unsigned 1 * reserved for IBM use 3 3 Unsigned 1 PRCDHF_CPUTYPE CPU type being described. 0=CP, 2=zAAP, 3=IFL, 4=ICF, 5=zIIP. 4 4 Character 12 PRCDHF_HFSAMPLE 4 4 Unsigned 4 PRCDHF_HFCOUNT Number of times this DSVBK was sampled for high frequency data. 8 8 Unsigned 4 PRCDHF_HFUSERZ High-frequency count. Number of times the DSVBK had no VMDBKs 12 C Unsigned 4 PRCDHF_HFUSERC High-frequency count. Cumulative number of VMDBKs in the DSVBK when the DSVBK was not empty (DSVUSERC). 16 10 Character 0 * Additional fields may be inserted before here. Use offsets to locate any fields after this point. 0 0 Bit 1 PRCDHF_DSVASSOC(MAXVMPRC) Bit mask of CPUs associated with this DSVBK. PRCDHF_MAXRPROC should be used to determine the length (in bits) of this field. PRCDHF_OFSASSOC should be used to locate this field. 0 0 Bit 1 PRCDHF_DSVUNPRK(MAXVMPRC) Bit mask indicating which CPUs associated with this DSVBK are currently in the unparked state. PRCDHF_MAXRPROC should be used to determine the length (in bits) of this field. PRCDHF_OFSUNPRK should be used to locate this field. * * Character 0 PRCDHF_END_STANZA End of stanza
MRPRCDHF 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 PRCDHF 0 44+ PRCDHF_CALDSVID 0 2 PRCDHF_CONT 28 1 PRCDHF_CPUTYPE 3 1 PRCDHF_DSVASSOC 0 * PRCDHF_DSVUNPRK 0 * PRCDHF_END_STANZA * * PRCDHF_HFCOUNT 4 4 PRCDHF_HFSAMPLE 4 12 PRCDHF_HFUSERC C 4 PRCDHF_HFUSERZ 8 4 PRCDHF_MAXRPROC 1A 2 PRCDHF_MRHDR 0 0 PRCDHF_OFSASSOC 24 2 PRCDHF_OFSUNPRK 26 2 PRCDHF_RCCDSVCH 1C 4 PRCDHF_SCOUNT 14 2 PRCDHF_SOFFSET 18 2 PRCDHF_SSIZE 16 2 PRCDHF_STANZA 0 16+ PRCDHF_STANZAS 2C 0 PRCDHF_SYSDVENT 20 4
This information is based on z/VM V7R1.0.
Last updated on 15 Sept 2019 at 19:26:15.
Copyright IBM Corporation, 1990, 2019