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   96  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  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  Character    3  *                      Reserved for IBM use
     96  60  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     96
    SCLSRM_END                60      0
    SCLSRM_MRHDR               0      0
    SCLSRM_SRMAWAIT           5C           80
    SCLSRM_SRMBIASD           18      2
    SCLSRM_SRMBIASI           14      4
    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_SRMTSHOT           22      8
    SCLSRM_SRMTSLIC           1A      8
    SCLSRM_SRMWSSMP           48      4
    SCLSRM_SRMXPCTG           58      4

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

    Last updated on 23 October 2009 at 15:02:41.

    Copyright IBM Corporation, 1990, 2009