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   96  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               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  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  MTRSCH_SRMXPCTG        Percentage of XSTORE to use
                                                    in WSS and available memory
                                                    calculations. Defaulted or set
                                                    by the SET SRM XSTORE command.
                                                    Units 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  MTRSCH_SRMFLAGS        Flags from the SRMBK
              1... ....      MTRSCH_SRMAWAIT        Active wait is in use
              .1.. ....      MTRSCH_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  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     96
    MTRSCH_END                60      0
    MTRSCH_MRHDR               0      0
    MTRSCH_SRMAWAIT           5C           80
    MTRSCH_SRMBIASD           28      2
    MTRSCH_SRMBIASI           14      4
    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_SRMTSHOT           20      8
    MTRSCH_SRMTSLIC           18      8
    MTRSCH_SRMWSSMP           48      4
    MTRSCH_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