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

#### MRSCLSTP

Prolog
Control Block Contents
Cross Reference

#### MRSCLSTP Prolog

####

####

     DSECT NAME - SCLSTP
     FUNCTION - Map a Monitor record.
     LOCATED BY -
               Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRSCLSTP
     DESCRIPTIVE NAME - Monitor Event Record
                        Domain 2 - Scheduler Domain
                        Record 8 - System Timer Pop
     DESCRIPTION - Record of changes to "smoothed" (i.e. averaged
                   over time) scheduler data. Generated at every
                   system-designated time interval. This data is
                   critical to scheduling algorithms.
     NOTE : The time interval, designated by CP, is currently set at
            30 seconds but may be subject to change in the future.

    MRSCLSTP Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)          Description

      0   0  Structure   80  SCLSTP              Start of monitor record
      0   0  Character    0  SCLSTP_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  Character    8  SCLSTP_SRMRSCTM     Reset interval size
     28  1C  Unsigned     2  SCLSTP_SYSPGRAT     Pages per second which are being
                                                 read in by the system
     30  1E  Unsigned     2  *                   Reserved for IBM use
     32  20  Unsigned     4  SCLSTP_SRMSTEAL     Instantaneous value of the STEAL
                                                 parameter reported on the INDICATE
                                                 LOAD command
     36  24  Character    8  SCLSTP_SRMSTRD      Average time to read a page.
                                                 Scheduler's estimate of how long
                                                 it is taking users to receive a
                                                 page once requested. Measured in
                                                 elapsed time.
     44  2C  Unsigned     4  SCLSTP_SRM1AVWS     Average WSS of all E1 users at
                                                 the end of their Q1 dispatch list
                                                 stay. Used by the scheduler to
                                                 assign a projected WSS to E1 users
                                                 on entry to the eligible list for
                                                 a new transaction.
     48  30  Unsigned     4  SCLSTP_SRM1AVPG     Average paging rate of all E1
                                                 users at the end of their Q1
                                                 dispatch list stay. Used by the
                                                 scheduler to assign a projected
                                                 paging rate to E1 users on entry
                                                 to the eligible list for a new
                                                 transaction
     52  34  Unsigned     4  SCLSTP_SRMSTSRW     System resource weight for
                                                 storage. This is used by the
                                                 scheduler to decide how much of a
                                                 bottleneck the storage resources
                                                 are.
     56  38  Unsigned     4  SCLSTP_SRMAPGDE     Average Paging rate of user in s
                                                 dispatch and eligible lists
     60  3C  Unsigned     4  SCLSTP_SRMAWSDE     Average WSS of users in dispatch
                                                 and eligible lists
     64  40  Unsigned     4  SCLSTP_SRMPGSRW     System resource weight for
                                                 paging. Used by the scheduler to
                                                 decide how much of a bottleneck
                                                 the paging resources are.
     68  44  Unsigned     4  SCLSTP_SRMEPNF1     Expansion factor for all E1
                                                 users. Represents the ratio of
                                                 time it is taking for a short
                                                 transaction to complete compared
                                                 with the amount of time it would
                                                 take if it were running alone on
                                                 the system.
     72  48  Unsigned     4  SCLSTP_SRMEPNF2     Expansion time for all E2 users.
                                                 Represents the ratio of time it is
                                                 taking for a medium transaction to
                                                 complete compared with the amount
                                                 of time it would take if it were
                                                 running alone on the system.
     76  4C  Unsigned     4  SCLSTP_SRMEPNF3     Expansion time for all E2 users.
                                                 Represents the ratio of time it is
                                                 taking for a long transaction to
                                                 complete compared with the amount
                                                 of time it would take if it were
                                                 running alone on the system.
     80  50  Character    0  SCLSTP_END

    MRSCLSTP 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
    SCLSTP                  0     80
    SCLSTP_END             50      0
    SCLSTP_MRHDR            0      0
    SCLSTP_SRMAPGDE        38      4
    SCLSTP_SRMAWSDE        3C      4
    SCLSTP_SRMEPNF1        44      4
    SCLSTP_SRMEPNF2        48      4
    SCLSTP_SRMEPNF3        4C      4
    SCLSTP_SRMPGSRW        40      4
    SCLSTP_SRMRSCTM        14      8
    SCLSTP_SRMSTEAL        20      4
    SCLSTP_SRMSTRD         24      8
    SCLSTP_SRMSTSRW        34      4
    SCLSTP_SRM1AVPG        30      4
    SCLSTP_SRM1AVWS        2C      4
    SCLSTP_SYSPGRAT        1C      2

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

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

    Copyright IBM Corporation, 1990, 2003