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
       2   2  Unsigned      2  MRHDRZER
       4   4  Unsigned      1  MRHDRDM
       5   5  Unsigned      1  *
       6   6  Unsigned      2  MRHDRRC
       8   8  Character     8  MRHDRTOD
      16  10  Character     4  *
      20  14  Character     0  MRHDR_END
      20  14  Character     8  *                      Reserved for IBM use - used
                                                      to be SCLSTP_SRMRSCTM.
      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_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 V7R2.0.

    Last updated on 08 August 2020 at 16:16:15.

    Copyright IBM Corporation, 1990, 2020