Programming Interface Information:
The Monitor Records are intended Programming Interfaces that
allow the customer to write programs to obtain services of z/VM.
Control Block Contents
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 ContentsOffsets 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 ReferenceHex 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 V5R2.0.
Last updated on 11 Dec 2005 at 18:48:12.
Copyright IBM Corporation, 1990, 2005