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  Bitstring     1  SCLSRM_CALWRNTK        Warning-track setting
          1... ....        SCLSRM_CALWTVAL         Validity indicator for
                                                   SCLSRM_CALWTAVL,
                                                   SCLSRM_CALWTREG,
                                                   and SCLSRM_CALWTON
          .1.. ....        SCLSRM_CALWTAVL         WTIF is available
          ..1. ....        SCLSRM_CALWTREG         Registered for WTIF
          ...1 ....        SCLSRM_CALWTON          WTIF support is ON
          .... 1...        *
          .... .1..        *
          .... ..1.        *
          .... ...1        *
 130  82  Character     2  *                      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_CALWRNTK           81      1
SCLSRM_CALWTAVL           81           40
SCLSRM_CALWTON            81           10
SCLSRM_CALWTREG           81           20
SCLSRM_CALWTVAL           81           80
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 V7R3.0.

Last updated on 10 November 2023 at 14:41:05.
Copyright IBM Corporation, 1990, 2023