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 V5R1.0.
Last updated on 13 Sep 2004 at 11:25:22.
Copyright IBM Corporation, 1990, 2004