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   84  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  *                      Reserved for IBM use - used
                                                    to be SCLSTP_SYSPGRAT.
     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  Unsigned     4  SCLSTP_SYSFPGRAT       Pages per second which are
                                                    being read in by the system
     84  54  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     84
    SCLSTP_END                54      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_SYSFPGRAT          50      4

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

    Last updated on 8 Oct 2009 at 21:08:13.

    Copyright IBM Corporation, 1990, 2009