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

#### MRMTRSCH

Prolog
Control Block Contents
Cross Reference

#### MRMTRSCH Prolog

     DSECT NAME - MTRSCH
     FUNCTION - Map a Monitor record.
     LOCATED BY -
               Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRMTRSCH
     DESCRIPTIVE NAME - Monitor Sample Configuration Record
                        Domain 1  - Monitor Domain
                        Record 16 - Scheduler Settings
     DESCRIPTION - Provides current settings of scheduler tuning
                   commands such as SET SRM DSPLICE.

#### MRMTRSCH Control Block Contents

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure   128+ MTRSCH                 Start of monitor record
       0   0  Character     0  MTRSCH_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      4  MTRSCH_SRMBIASI        Interactive bias intensity.
                                                      Set or defaulted by the SET
                                                      SRM IAB command.
      24  18  Character     8  MTRSCH_SRMTSLIC        Minor time slice size. Set
                                                      or defaulted by the SET SRM
                                                      DSPSLICE command.
      32  20  Character     8  MTRSCH_SRMTSHOT        The minor time slice used
                                                      for 'hotshot' users.
      40  28  Unsigned      2  MTRSCH_SRMBIASD        Interactive bias duration.
                                                      Set or defaulted by the SET
                                                      SRM IAB command.
      42  2A  Unsigned      2  MTRSCH_SRMLDGUS        Number of page reads a user
                                                      must do in a minor time slice
                                                      to be classified as a
                                                      'loading user'.
      44  2C  Unsigned      4  MTRSCH_SRMP1LDG        Percentage of 'Load
                                                      Capacity' which can be taken
                                                      by Q1, Q2, and Q3 users. Set
                                                      or defaulted by the SET SRM
                                                      LDUBUF command.
      48  30  Unsigned      4  MTRSCH_SRMP2LDG        Percentage of 'Load
                                                      Capacity' which can be taken
                                                      by Q2, and Q3 users. Set or
                                                      defaulted by the SET SRM
                                                      LDUBUF command.
      52  34  Unsigned      4  MTRSCH_SRMP3LDG        Percentage of 'Load
                                                      Capacity' which can be taken
                                                      by Q3 user. Set or defaulted
                                                      by the SET SRM LDUBUF
                                                      command.
      56  38  Unsigned      4  MTRSCH_SRMLDGCP        Loading user capacity of
                                                      the system
      60  3C  Unsigned      4  MTRSCH_SRMP1WSS        Percentage of available
                                                      memory which is assignable to
                                                      E1, E2 and E3 users. Set or
                                                      defaulted by the SET SRM
                                                      STORBUF command.
      64  40  Unsigned      4  MTRSCH_SRMP2WSS        Percentage of available
                                                      memory which is assignable to
                                                      E2 and E3 users. Set or
                                                      defaulted by the SET SRM
                                                      STORBUF command.
      68  44  Unsigned      4  MTRSCH_SRMP3WSS        Percentage of available
                                                      memory which is assignable to
                                                      E3 users. Set or defaulted by
                                                      the SET SRM STORBUF command.
      72  48  Unsigned      4  MTRSCH_SRMWSSMP        Maximum MAXWSS percentage.
                                                      Set or defaulted by the SET
                                                      SRM MAXWSS command.
      76  4C  Unsigned      4  MTRSCH_SRML1DSP        Number of openings in the
                                                      dispatch list made available
                                                      to users in the short-running
                                                      (E1) transactions. Set or
                                                      defaulted by the SET SRM
                                                      DSPBUF command.
      80  50  Unsigned      4  MTRSCH_SRML2DSP        Number of openings in the
                                                      dispatch list made available
                                                      to users in the
                                                      medium-running (E2)
                                                      transactions. This value is a
                                                      subset of MTRSCH_SRML1DSP.
                                                      Set or defaulted by the SET
                                                      SRM DSPBUF command.
      84  54  Unsigned      4  MTRSCH_SRML3DSP        Number of openings in the
                                                      dispatch list made available
                                                      to users in the long-running
                                                      (E3) transactions. This value
                                                      is a subset of
                                                      MTRSCH_SRML1DSP. Set or
                                                      defaulted by the SET SRM
                                                      DSPBUF command.
      88  58  Unsigned      4  *                      Reserved for IBM use.
                                                      - was MTRSCH_SRMXPCTG
      92  5C  Bitstring     1  MTRSCH_SRMFLAGS        Flags from the SRMBK
              1... ....        MTRSCH_SRMAWAIT        Active wait  is in use
              .1.. ....        MTRSCH_SRMLMCNS        Guest CPU u sage is being
                                                      limited using the consumption
                                                      method.
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
      93  5D  Bitstring     1  MTRSCH_CALFLAG         Miscellaneous flags
              1... ....        MTRSCH_PFXVVMXA        When ON, system is running
                                                      second level.
              .1.. ....        MTRSCH_SYSGPRFD        This flag is not
                                                      applicable when
                                                      MTRSCH_PFXVVMXA is ON. When
                                                      MTRSCH_PFXVVMXA is OFF and
                                                      MTRSCH_SYSGPRFD is ON, global
                                                      performance data (GPD) is
                                                      enabled for this partition.
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        MTRSCH_SYSISVRT        Current polarization mode.
                                                      ON = vertical OFF =
                                                      horizontal
              .... ...1        *
      94  5E  Unsigned      1  MTRSCH_PUCMAX          Highest CPU type code
                                                      supported by z/VM. This value
                                                      defines upper boundary of a
                                                      dimension of arrays:
                                                      MTRSCH_SRXCPPAD,
                                                      MTRSCH_SRXEXUSE.
      95  5F  Unsigned      1  MTRSCH_CALWDA          Code indicating which
                                                      distribution algorithm is
                                                      currently being used.
                                                      1 - MTRSCH_RESHUFFLE
                                                      2 - MTRSCH_REBALANCE
      96  60  Unsigned      2  MTRSCH_OFFCPPAD        Offset within this record
                                                      to MTRSCH_SRXCPPAD array.
      98  62  Unsigned      2  MTRSCH_OFFEXUSE        Offset within this record
                                                      to MTRSCH_SRXEXUSE array.
     100  64  Bitstring     1  MTRSCH_SRMDSPFL        Dispatcher control settings
                                                      flags
              1... ....        MTRSCH_SRMTSAFF        Thread soft affinity is on
              .1.. ....        MTRSCH_SRMPRLCL        Local preemption is on
              ..1. ....        MTRSCH_SRMTSAFS        Thread soft affinity
                                                      requested but suppressed
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
     101  65  Unsigned      1  MTRSCH_SRMTSEPC        TSEarly Percent (hex)
     102  66  Unsigned      2  *                      Reserved for IBM use
     104  68  Unsigned      4  MTRSCH_CALCHIPB        Within-chip busy steal
                                                      threshold in microseconds
     108  6C  Unsigned      4  MTRSCH_CALCHIPD        Within-chip delay steal
                                                      threshold in microseconds
     112  70  Unsigned      4  MTRSCH_CALNODEB        Within-node busy steal
                                                      threshold in microseconds
     116  74  Unsigned      4  MTRSCH_CALNODED        Within-node delay steal
                                                      threshold in microseconds
     120  78  Unsigned      4  MTRSCH_CALSYSB         Within-system busy steal
                                                      threshold in microseconds
     124  7C  Unsigned      4  MTRSCH_CALSYSD         Within-system delay steal
                                                      threshold in microseconds
     128  80  Character     0  *                      Additional fields may be
                                                      inserted before here. Use
                                                      offsets to locate any fields
                                                      after this point.
       0   0  Unsigned      4  MTRSCH_SRXCPPAD(0:PUCMAX) Set SRM CPUPAD settings,
                                                      indexed by CPU type:
                                                        0 -- for type CP
                                                        1 -- not used
                                                        2 -- for type zAAP
                                                        3 -- for type IFL
                                                        4 -- for type ICF
                                                        5 -- for type zIIP
                                                      A scaled number where
                                                      X'00010000' represents one
                                                      CPU's worth of capacity.
                                                      MTRSCH_OFFCPPAD should be
                                                      used to locate this field.
       0   0  Unsigned      1  MTRSCH_SRXEXUSE(0:PUCMAX) Set SRM EXCESSUSE
                                                      settings, indexed by CPU type.
                                                      See MTRSCH_SRXCPPAD description
                                                      for possible type list.
                                                      MTRSCH_OFFEXUSE should be used
                                                      to locate this field.
                                                      16 - indicates the system should
                                                           be aggressive in using
                                                           unentitled CPU capacity.
                                                       8 - indicates the system should
                                                           be moderately aggressive in
                                                           using unentitled CPU capacity.
                                                       1 - indicates the system should
                                                           not be aggressive in using
                                                           unentitled CPU capacity.
       *   *  Character     0  MTRSCH_END

#### MRMTRSCH 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
    MTRSCH                     0    128+
    MTRSCH_CALCHIPB           68      4
    MTRSCH_CALCHIPD           6C      4
    MTRSCH_CALFLAG            5D      1
    MTRSCH_CALNODEB           70      4
    MTRSCH_CALNODED           74      4
    MTRSCH_CALSYSB            78      4
    MTRSCH_CALSYSD            7C      4
    MTRSCH_CALWDA             5F      1
    MTRSCH_END                 *      *
    MTRSCH_MRHDR               0      0
    MTRSCH_OFFCPPAD           60      2
    MTRSCH_OFFEXUSE           62      2
    MTRSCH_PFXVVMXA           5D           80
    MTRSCH_PUCMAX             5E      1
    MTRSCH_SRMAWAIT           5C           80
    MTRSCH_SRMBIASD           28      2
    MTRSCH_SRMBIASI           14      4
    MTRSCH_SRMDSPFL           64      1
    MTRSCH_SRMFLAGS           5C      1
    MTRSCH_SRMLDGCP           38      4
    MTRSCH_SRMLDGUS           2A      2
    MTRSCH_SRMLMCNS           5C           40
    MTRSCH_SRML1DSP           4C      4
    MTRSCH_SRML2DSP           50      4
    MTRSCH_SRML3DSP           54      4
    MTRSCH_SRMP1LDG           2C      4
    MTRSCH_SRMP1WSS           3C      4
    MTRSCH_SRMP2LDG           30      4
    MTRSCH_SRMP2WSS           40      4
    MTRSCH_SRMP3LDG           34      4
    MTRSCH_SRMP3WSS           44      4
    MTRSCH_SRMPRLCL           64           40
    MTRSCH_SRMTSAFF           64           80
    MTRSCH_SRMTSAFS           64           20
    MTRSCH_SRMTSEPC           65      1
    MTRSCH_SRMTSHOT           20      8
    MTRSCH_SRMTSLIC           18      8
    MTRSCH_SRMWSSMP           48      4
    MTRSCH_SRXCPPAD            0      4
    MTRSCH_SRXEXUSE            0      1
    MTRSCH_SYSGPRFD           5D           40
    MTRSCH_SYSISVRT           5D           02

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

    Last updated on 08 August 2020 at 21:36:09.

    Copyright IBM Corporation, 1990, 2020