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

#### MRSCLSRM

Prolog
Control Block Contents
Cross Reference

#### MRSCLSRM Prolog

     DSECT NAME - SCLSRM
     FUNCTION - Map a Monitor record.
     LOCATED BY -
               Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRSCLSRM
     DESCRIPTIVE NAME - Monitor Event Record
                        Domain 2 - Scheduler Domain
                        Record 7 - SET SRM Changes
     DESCRIPTION - Indicates that the SET SRM command has been issued.
                   The record is created regardless of which users
                   are being monitored for the scheduler domain.
                   System-wide fields are set, depending on the
                   nature of the SET SRM command. All potential fields
                   pertaining to that command will be set while others
                   will remain unchanged (they may be zero or contain
                   data set by prior SET SRM commands).

#### MRSCLSRM Control Block Contents

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure   132+ SCLSRM                 Start of monitor record
       0   0  Character     0  SCLSRM_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  SCLSRM_SRMBIASI        Interactive bias intensity.
                                                      Set by the SET SRM IAB
                                                      command.
      24  18  Unsigned      2  SCLSRM_SRMBIASD        Interactive bias duration.
                                                      Set by the SET SRM IAB
                                                      command.
      26  1A  Character     8  SCLSRM_SRMTSLIC        Minor time slice size. Set
                                                      by the SET SRM DSPSLICE
                                                      command.
      34  22  Character     8  SCLSRM_SRMTSHOT        The minor time slice used
                                                      for 'hotshot' users.
      42  2A  Unsigned      2  SCLSRM_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  SCLSRM_SRMP1LDG        Percentage of 'LOAD
                                                      CAPACITY' which can be taken
                                                      by Q1, Q2 and Q3 users. Set
                                                      by the SET SRM LDUBUF
                                                      command.
      48  30  Unsigned      4  SCLSRM_SRMP2LDG        Percentage of 'LOAD
                                                      CAPACITY' which can be taken
                                                      by Q2 and Q3 users. Set by
                                                      SET SRM LDUBUF command.
      52  34  Unsigned      4  SCLSRM_SRMP3LDG        Percentage of 'LOAD
                                                      CAPACITY' which can be taken
                                                      by Q3 users. Set by the SET
                                                      SRM LDUBUF command. It
                                                      relates to Q3 users.
      56  38  Unsigned      4  SCLSRM_SRMLDGCP        Loading user capacity of
                                                      the system
      60  3C  Unsigned      4  SCLSRM_SRMP1WSS        Percentage of available
                                                      memory which is assignable to
                                                      E1, E2 and E3 user. May be
                                                      set by the SET SRM STORBUF
                                                      command.
      64  40  Unsigned      4  SCLSRM_SRMP2WSS        Percentage of available
                                                      memory which is assignable to
                                                      E2 and E3 users. May be set
                                                      by the SET SRM STORBUF
                                                      command.
      68  44  Unsigned      4  SCLSRM_SRMP3WSS        Percentage of available
                                                      memory which is assignable to
                                                      E3 users. May be set by the
                                                      SET SRM STORBUF command.
      72  48  Unsigned      4  SCLSRM_SRMWSSMP        Maximum MAXWSS percentage
                                                      as specified by the SET SRM
                                                      MAXWSS command
      76  4C  Unsigned      4  SCLSRM_SRML1DSP        Number of openings in the
                                                      dispatch list made available
                                                      to users in the short-running
                                                      (E1) transactions
      80  50  Unsigned      4  SCLSRM_SRML2DSP        Number of openings in the
                                                      dispatch list made available
                                                      to users in the
                                                      medium-running (E2)
                                                      transactions. This value is a
                                                      subset of SCLSRM_SRML1DSP.
      84  54  Unsigned      4  SCLSRM_SRML3DSP        Number of openings in the
                                                      dispatch list made available
                                                      to users in the long-running
                                                      (E3) transactions. This value
                                                      is a subset of
                                                      SCLSRM_SRML2DSP.
      88  58  Unsigned      4  *                      Reserved for IBM use.
                                                      - was SCLSRM_SRMXPCTG
      92  5C  Bitstring     1  SCLSRM_SRMFLAGS        Flags from the SRMBK
              1... ....        SCLSRM_SRMAWAIT         Active wait is in use
              .1.. ....        SCLSRM_SRMLMCNS         Guest CPU usage is being
                                                      limited using the consumption
                                                      method.
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
      93  5D  Bitstring     1  SCLSRM_CALFLAG         Miscellaneous flags
              1... ....        SCLSRM_PFXVVMXA         When ON, system is running
                                                      second level.
              .1.. ....        SCLSRM_SYSGPRFD         This flag is not applicabl
                                                      when SCLSRM_PFXVVMXA is ON.
                                                      When SCLSRM_PFXVVMXA is OFF and
                                                      GCLSRM_SYSGPRFD is ON, global
                                                      performance data (GPD) is enabled
                                                      for this partition.
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        SCLSRM_SYSISVRT         Current polarization mode.
                                                      ON = vertical OFF =
                                                      horizontal
              .... ...1        *
      94  5E  Unsigned      1  SCLSRM_PUCMAX          Highest CPU type code
                                                      supported by z/VM. This value
                                                      defines the upper boundary
                                                      of a dimension of arrays:
                                                      SCLSRM_SRXCPPAD,
                                                      SCLSRM_SRXEXUSE.
      95  5F  Unsigned      1  SCLSRM_CALWDA          Code indicating which work
                                                      distribution algorithm is
                                                      currently being used.
                                                      1 - SCLSRM_RESHUFFLE
                                                      2 - SCLSRM_REBALANCE
      96  60  Unsigned      2  SCLSRM_OFFCPPAD        Offset within this record
                                                      to SCLSRM_SRXCPPAD array.
      98  62  Unsigned      2  SCLSRM_OFFEXUSE        Offset within this record
                                                      to SCLSRM_SRXEXUSE array.
     100  64  Bitstring     1  SCLSRM_SRMDSPFL        Dispatcher control settings
                                                      flags
              1... ....        SCLSRM_SRMTSAFF        Thread soft affinity is on
              .1.. ....        SCLSRM_SRMPRLCL        Local preemption is on
              ..1. ....        SCLSRM_SRMTSAFS        Thread soft affinity
                                                      requested but suppressed
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
     101  65  Unsigned      1  SCLSRM_SRMTSEPC        TSEarly PerCent (hex)
     102  66  Unsigned      2  *                      Reserved for IBM use
     104  68  Unsigned      4  SCLSRM_CALCHIPB        Within-chip busy steal
                                                      threshold in microseconds
     108  6C  Unsigned      4  SCLSRM_CALCHIPD        Within-chip delay steal
                                                      threshold in microseconds
     112  70  Unsigned      4  SCLSRM_CALNODEB        Within-node busy steal
                                                      threshold in microseconds
     116  74  Unsigned      4  SCLSRM_CALNODED        Within-node delay steal
                                                      threshold in microseconds
     120  78  Unsigned      4  SCLSRM_CALSYSB         Within-system busy steal
                                                      threshold in microseconds
     124  7C  Unsigned      4  SCLSRM_CALSYSD         Within-system delay steal
                                                      threshold in microseconds
     128  80  Unsigned      1  SCLSRM_SYSPRKFG        SRM UNPARKing setting
                                                      0:  large
                                                      1:  medium
                                                      2:  small
     129  81  Character     3  *                      Reserved for IBM use
     132  84  Character     0  *                      Additional fields may be
                                                      inserted before here. Use
                                                      offsets to locate any fields
                                                      after this point.
       0   0  Unsigned      4  SCLSRM_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. SCLSRM_OFFCPPAD
                                                      should be used to locate this
                                                      field.
       0   0  Unsigned      1  SCLSRM_SRXEXUSE(0:PUCMAX) SET SRM EXCESSUSE
                                                      settings, indexed by CPU type.
                                                      See SCLSRM_SRXCPPAD description
                                                      for possible type list.
                                                      SCLSRM_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.
                                                       2 - indicates the system should
                                                           not use
                                                           unentitled CPU capacity.
       *   *  Character     0  SCLSRM_END

#### MRSCLSRM 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
    SCLSRM                     0    132+
    SCLSRM_CALCHIPB           68      4
    SCLSRM_CALCHIPD           6C      4
    SCLSRM_CALFLAG            5D      1
    SCLSRM_CALNODEB           70      4
    SCLSRM_CALNODED           74      4
    SCLSRM_CALSYSB            78      4
    SCLSRM_CALSYSD            7C      4
    SCLSRM_CALWDA             5F      1
    SCLSRM_END                 *      *
    SCLSRM_MRHDR               0      0
    SCLSRM_OFFCPPAD           60      2
    SCLSRM_OFFEXUSE           62      2
    SCLSRM_PFXVVMXA           5D           80
    SCLSRM_PUCMAX             5E      1
    SCLSRM_SRMAWAIT           5C           80
    SCLSRM_SRMBIASD           18      2
    SCLSRM_SRMBIASI           14      4
    SCLSRM_SRMDSPFL           64      1
    SCLSRM_SRMFLAGS           5C      1
    SCLSRM_SRMLDGCP           38      4
    SCLSRM_SRMLDGUS           2A      2
    SCLSRM_SRMLMCNS           5C           40
    SCLSRM_SRML1DSP           4C      4
    SCLSRM_SRML2DSP           50      4
    SCLSRM_SRML3DSP           54      4
    SCLSRM_SRMP1LDG           2C      4
    SCLSRM_SRMP1WSS           3C      4
    SCLSRM_SRMP2LDG           30      4
    SCLSRM_SRMP2WSS           40      4
    SCLSRM_SRMP3LDG           34      4
    SCLSRM_SRMP3WSS           44      4
    SCLSRM_SRMPRLCL           64           40
    SCLSRM_SRMTSAFF           64           80
    SCLSRM_SRMTSAFS           64           20
    SCLSRM_SRMTSEPC           65      1
    SCLSRM_SRMTSHOT           22      8
    SCLSRM_SRMTSLIC           1A      8
    SCLSRM_SRMWSSMP           48      4
    SCLSRM_SRXCPPAD            0      4
    SCLSRM_SRXEXHGH           7C           80
    SCLSRM_SRXEXLOW           7C           20
    SCLSRM_SRXEXMED           7C           40
    SCLSRM_SRXEXUSE            0      1
    SCLSRM_SYSGPRFD           5D           40
    SCLSRM_SYSISVRT           5D           02
    SCLSRM_SRYPRKFG           80      1

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

    Last updated on 08 August 2020 at 16:15:22.

    Copyright IBM Corporation, 1990, 2020