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

#### MRMTRCPD

Prolog
Control Block Contents
Cross Reference

#### MRMTRCPD Prolog

     DSECT NAME - MTRCPD
     FUNCTION - Map a Monitor record.
     LOCATED BY -
               Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRMTRCPD
     DESCRIPTIVE NAME - Monitor Event Record
                        Domain 1  - Monitor Domain
                        Record 29 - CPU Pool Definition
     DESCRIPTION - Records CPU Pool changes made by the DEFINE CPUPOOL,
                   SET CPUPOOL, and DELETE CPUPOOL commands.

#### MRMTRCPD Control Block Contents

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure    40  MTRCPD                 Start of monitor record.
       0   0  Character     0  MTRCPD_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  Character     8  MTRCPD_LIMPOOL         CPU pool name.
      28  1C  Bitstring     1  MTRCPD_FLAGS           Flag byte.
              1... ....        MTRCPD_CPUAFFON         CPU Affinity setting for
                                                      the MTRCPD_LIMCPUTY processor
                                                      type limited by this CPU
                                                      pool. If ON, CPU Affinity is
                                                      ON. If OFF, CPU Affinity is
                                                      suppressed.
              .1.. ....        *
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
      29  1D  Unsigned      1  MTRCPD_LIMCPUTY        CPU pool CPU type limited.
                                                      Valid values: X'00' - General
                                                      Purpose (CP) X'03' -
                                                      Integrated Facility for Linux
                                                      (IFL)
      30  1E  Unsigned      1  MTRCPD_TYPELIM         TYPE of LIMIT listed in
                                                      MTRCPD_MAXSHARE. Valid
                                                      values: X'01' - LIMITHARD
                                                      limit X'02' - CAPACITY limit
      31  1F  Unsigned      1  MTRCPD_COMMAND         What command/action caused
                                                      the change in CPU Pool? Valid
                                                      values: X'01' - DEFINE
                                                      CPUPOOL issued X'02' - SET
                                                      CPUPOOL issued X'03' - DELETE
                                                      CPUPOOL issued
      32  20  Unsigned      4  MTRCPD_MAXSHARE        CPU pool maximum share from
                                                      DEFINE or SET CPUPOOL
                                                      command. Unit of value is a
                                                      hexadecimal factor scaled 16
                                                      bits. For example,
                                                      X'00010000' = 1.00(100%),
                                                      X'0000C000' = 0.75(75%),
                                                      X'00008000' = 0.50(50%), etc.
      36  24  Unsigned      4  MTRCPD_LIMCTMEM        Current number of users in
                                                      the CPU pool.
      40  28  Character     0  MTRCPD_END

#### MRMTRCPD 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
    MTRCPD                     0     40
    MTRCPD_COMMAND            1F      1
    MTRCPD_CPUAFFON           1C           80
    MTRCPD_END                28      0
    MTRCPD_FLAGS              1C      1
    MTRCPD_LIMCPUTY           1D      1
    MTRCPD_LIMCTMEM           24      4
    MTRCPD_LIMPOOL            14      8
    MTRCPD_MAXSHARE           20      4
    MTRCPD_MRHDR               0      0
    MTRCPD_TYPELIM            1E      1

    This information is
    based on z/VM V7R2.0.

    Last updated on 09 August 2020 at 15:11:31.

    Copyright IBM Corporation, 1990, 2020