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 - MTRPRP FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor Control Area REFERENCED CONTROL BLOCKS - MRRECHDR Monitor Record Header NAME - MRMTRPRP DESCRIPTIVE NAME - Monitor Sample Configuration Record Domain 1 - Monitor Record Record 5 - Processor Configuration (Per Processor) DESCRIPTION - Describes the configuration of a real processor. A separate record is generated for each processor varied online. NOTE: When a field in this record uses the term "CPU/core", the meaning of the field changes based on whether Multithreading (MT) is enabled for this partition. Refer to Monitor Sample Record Domain 1 Record 4 (MRMTRSYS) to determine whether MT is enabled for this partition as well as the number of threads for each CPU type. When MT is not enabled, a physical core contains only one CPU: - CPU : central processing unit (processor). - CORE : physical unit containing one CPU. In this environment the core has 1 thread, the term "thread" is not used, and the term "CPU" is generally favored over the term "core". When MT is enabled, a physical core contains one or more CPUs (aka "threads"): - CPU : central processing unit (processor). Identified by CPU address which consists of core ID and thread ID. - CORE : physical unit containing one or more CPUs (aka "threads"). All CPUs of a core have the same CPU type. - THREAD: synonym for a CPU that is a member of a core. Each thread on a core has a distinct thread ID (TID), numbered from 0 up to the maximum thread ID available on the core.
MRMTRPRP Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 64 MTRPRP Start of monitor record 0 0 Character 0 MTRPRP_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 MTRPRP_PFXCPUAD Processor's CPU address 22 16 Character 2 MTRPRP_PFXIDMDL CPU/core model number in packed decimal 24 18 Character 3 MTRPRP_PFXIDSER CPU/core serial number in packed decimal 27 1B Bitstring 1 * Reserved for IBM use. Previous field is no longer meaningful. (MTRPRP_PFXVFST) 28 1C Bitstring 1 MTRPRP_CALFLAGS Flag byte 1... .... * .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 29 1D Unsigned 1 * Reserved for IBM use. Previous field is no longer meaningful. (MTRPRP_PCCCSU) 30 1E Unsigned 1 MTRPRP_PFXIDVER Processor model version code. Derived from the Store CPU ID instruction (STIPD) issued by CP. The format depends on the model, usually described in Processor Characteristics Manuals for different processors. 31 1F Unsigned 1 MTRPRP_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 32 20 Character 8 MTRPRP_CALUDED If processor is dedicated, this is the userid to which it is dedicated. Otherwise, the field is binary zeros. 40 28 Unsigned 1 MTRPRP_PFXCPUTY CPU 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) 41 29 Unsigned 1 MTRPRP_PFXPOLAR Current polarization of the CPU/Core. Valid values: X'00' - Horizontally polarized X'01' - Vertically polarized with low entitlement X'02' - Vertically polarized with medium entitlement X'03' - Vertically polarized with high entitlement. Note that while z/VM does not park horizontally polarized CPUs/cores, it is possible to observe a parked horizontal CPU/ core. This can occur during the transition between vertical and horizontal polarization. Shortly following this transition, z/VM will unpark any parked horizontal CPUs/cores. 42 2A Unsigned 2 MTRPRP_RCCTOPDI DSVBK index for CPU, If processor is not a member of any active Dispatch Vector Block, it contains all ones. 44 2C Unsigned 4 MTRPRP_CALENTMT For vertical CPUs/cores (MTRPRP_PFXPOLAR <> X'00'), this is a scaled number between X'00000000' and X'00010000' representing the portion of a physical CPU/core to which this vertical CPU/core is entitled. This value is X'00000000' for a horizontal CPU/core. When MT is enabled, this core value is repeated in the monitor record of each CPU in the core. These values are not to be added up across the core. 48 30 Bitstring 2 MTRPRP_OFFTOPDS Offset within this record to beginning of the MTRPRP_RCCTOPDS array. 50 32 Unsigned 1 MTRPRP_SIZTOPDS This value defines the size (in bytes) of the MTRPRP_RCCTOPDS field. 51 33 Unsigned 1 * Reserved for IBM use. 52 34 Unsigned 2 MTRPRP_CORID Core ID for this processor. 54 36 Character 6 * Reserved for IBM use. 60 3C Character 0 * Additional fields may be inserted before here. Use offsets to locate any fields after this point. 60 3C Bitstring 4 MTRPRP_RCCTOPDS This topology descriptor or identifier consists of the container IDs for each level of the topology tree above the dispatch vector specified in MTRPRP_RCCTOPDI. These container IDs are positioned left to right with the highest nesting level listed first. When MT is enabled, this value is given for each thread (CPU) in the core and indicates which dispatch vector each CPU is drawing work from. 64 40 Character 0 MTRPRP_END
MRMTRPRP 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 MTRPRP 0 64 MTRPRP_CALENTMT 2C 4 MTRPRP_CALFLAGS 1C 1 MTRPRP_CALUDED 20 8 MTRPRP_CORID 34 2 MTRPRP_END 40 0 MTRPRP_MRHDR 0 0 MTRPRP_OFFTOPDS 30 2 MTRPRP_PFXCPUAD 14 2 MTRPRP_PFXCPUTY 28 1 MTRPRP_PFXIDMDL 16 2 MTRPRP_PFXIDSER 18 3 MTRPRP_PFXIDVER 1E 1 MTRPRP_PFXPOLAR 29 1 MTRPRP_PFXTYPE 1F 1 MTRPRP_RCCTOPDI 2A 2 MTRPRP_RCCTOPDS 3C 4 MTRPRP_SIZTOPDS 32 1
This information is based on z/VM V6R4.0.
Last updated on 4 Oct 2016 at 14:55:17.
Copyright IBM Corporation, 1990, 2016