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
Cross Reference


 FUNCTION - Map a Monitor record.
        Through the Monitor Control Area
        MRRECHDR    Monitor Record Header
 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

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