Programming Interface Information: The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM.

#### MRMTRPRP

Prolog
Control Block Contents
Cross Reference

#### MRMTRPRP Prolog

     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  *                      Reserved for IBM use.
                                                      Previous field is no longer
                                                      meaningful. (MTRPRP_CALUDED)
      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_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 V7R2.0.

    Last updated on 08 August 2020 at 21:33:17.

    Copyright IBM Corporation, 1990, 2020