|
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