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   92  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            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     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  SCLSRM_SRMXPCTG     Percentage of XSTORE to use in
                                                 WSS and available memory
                                                 calculations. Set or defaulted by
                                                 the SET SRM XSTORE command. Unit
                                                 of value is a hexadecimal factor
                                                 scaled 8 bits. Examples-
                                                 X'00000200'=2.00(200%),
                                                 X'00000100'=1.00(100%),
                                                 X'000000C0'=0.75(75%), etc.
     92  5C  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     92
    SCLSRM_END             5C      0
    SCLSRM_MRHDR            0      0
    SCLSRM_SRMBIASD        18      2
    SCLSRM_SRMBIASI        14      4
    SCLSRM_SRMLDGCP        38      4
    SCLSRM_SRMLDGUS        2A      2
    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_SRMTSHOT        22      8
    SCLSRM_SRMTSLIC        1A      8
    SCLSRM_SRMWSSMP        48      4
    SCLSRM_SRMXPCTG        58      4

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

    Last updated on 22 Jul 2003 at 15:04:23.

    Copyright IBM Corporation, 1990, 2003