Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRSCLSRM
PrologControl Block Contents
Cross Reference
MRSCLSRM Prolog
DSECT NAME - SCLSRM FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor Control Area REFERENCED CONTROL BLOCKS - MRRECHDR Monitor Record Header NAME - MRSCLSRM DESCRIPTIVE NAME - Monitor Event Record Domain 2 - Scheduler Domain Record 7 - SET SRM Changes DESCRIPTION - Indicates that the SET SRM command has been issued. The record is created regardless of which users are being monitored for the scheduler domain. System-wide fields are set, depending on the nature of the SET SRM command. All potential fields pertaining to that command will be set while others will remain unchanged (they may be zero or contain data set by prior SET SRM commands).
MRSCLSRM Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 132+ SCLSRM Start of monitor record 0 0 Character 0 SCLSRM_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 Unsigned 4 SCLSRM_SRMBIASI Interactive bias intensity. Set by the SET SRM IAB command. 24 18 Unsigned 2 SCLSRM_SRMBIASD Interactive bias duration. Set by the SET SRM IAB command. 26 1A Character 8 SCLSRM_SRMTSLIC Minor time slice size. Set by the SET SRM DSPSLICE command. 34 22 Character 8 SCLSRM_SRMTSHOT The minor time slice used for 'hotshot' users. 42 2A Unsigned 2 SCLSRM_SRMLDGUS Number of page reads a user must do in a minor time slice to be classified as a 'loading user'. 44 2C Unsigned 4 SCLSRM_SRMP1LDG Percentage of 'LOAD CAPACITY' which can be taken by Q1, Q2 and Q3 users. Set by the SET SRM LDUBUF command. 48 30 Unsigned 4 SCLSRM_SRMP2LDG Percentage of 'LOAD CAPACITY' which can be taken by Q2 and Q3 users. Set by SET SRM LDUBUF command. 52 34 Unsigned 4 SCLSRM_SRMP3LDG Percentage of 'LOAD CAPACITY' which can be taken by Q3 users. Set by the SET SRM LDUBUF command. It relates to Q3 users. 56 38 Unsigned 4 SCLSRM_SRMLDGCP Loading user capacity of the system 60 3C Unsigned 4 SCLSRM_SRMP1WSS Percentage of available memory which is assignable to E1, E2 and E3 user. May be set by the SET SRM STORBUF command. 64 40 Unsigned 4 SCLSRM_SRMP2WSS Percentage of available memory which is assignable to E2 and E3 users. May be set by the SET SRM STORBUF command. 68 44 Unsigned 4 SCLSRM_SRMP3WSS Percentage of available memory which is assignable to E3 users. May be set by the SET SRM STORBUF command. 72 48 Unsigned 4 SCLSRM_SRMWSSMP Maximum MAXWSS percentage as specified by the SET SRM MAXWSS command 76 4C Unsigned 4 SCLSRM_SRML1DSP Number of openings in the dispatch list made available to users in the short-running (E1) transactions 80 50 Unsigned 4 SCLSRM_SRML2DSP Number of openings in the dispatch list made available to users in the medium-running (E2) transactions. This value is a subset of SCLSRM_SRML1DSP. 84 54 Unsigned 4 SCLSRM_SRML3DSP Number of openings in the dispatch list made available to users in the long-running (E3) transactions. This value is a subset of SCLSRM_SRML2DSP. 88 58 Unsigned 4 * Reserved for IBM use. - was SCLSRM_SRMXPCTG 92 5C Bitstring 1 SCLSRM_SRMFLAGS Flags from the SRMBK 1... .... SCLSRM_SRMAWAIT Active wait is in use .1.. .... SCLSRM_SRMLMCNS Guest CPU usage is being limited using the consumption method. ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 93 5D Bitstring 1 SCLSRM_CALFLAG Miscellaneous flags 1... .... SCLSRM_PFXVVMXA When ON, system is running second level. .1.. .... SCLSRM_SYSGPRFD This flag is not applicabl when SCLSRM_PFXVVMXA is ON. When SCLSRM_PFXVVMXA is OFF and GCLSRM_SYSGPRFD is ON, global performance data (GPD) is enabled for this partition. ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. SCLSRM_SYSISVRT Current polarization mode. ON = vertical OFF = horizontal .... ...1 * 94 5E Unsigned 1 SCLSRM_PUCMAX Highest CPU type code supported by z/VM. This value defines the upper boundary of a dimension of arrays: SCLSRM_SRXCPPAD, SCLSRM_SRXEXUSE. 95 5F Unsigned 1 SCLSRM_CALWDA Code indicating which work distribution algorithm is currently being used. 1 - SCLSRM_RESHUFFLE 2 - SCLSRM_REBALANCE 96 60 Unsigned 2 SCLSRM_OFFCPPAD Offset within this record to SCLSRM_SRXCPPAD array. 98 62 Unsigned 2 SCLSRM_OFFEXUSE Offset within this record to SCLSRM_SRXEXUSE array. 100 64 Bitstring 1 SCLSRM_SRMDSPFL Dispatcher control settings flags 1... .... SCLSRM_SRMTSAFF Thread soft affinity is on .1.. .... SCLSRM_SRMPRLCL Local preemption is on ..1. .... SCLSRM_SRMTSAFS Thread soft affinity requested but suppressed ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 101 65 Unsigned 1 SCLSRM_SRMTSEPC TSEarly PerCent (hex) 102 66 Unsigned 2 * Reserved for IBM use 104 68 Unsigned 4 SCLSRM_CALCHIPB Within-chip busy steal threshold in microseconds 108 6C Unsigned 4 SCLSRM_CALCHIPD Within-chip delay steal threshold in microseconds 112 70 Unsigned 4 SCLSRM_CALNODEB Within-node busy steal threshold in microseconds 116 74 Unsigned 4 SCLSRM_CALNODED Within-node delay steal threshold in microseconds 120 78 Unsigned 4 SCLSRM_CALSYSB Within-system busy steal threshold in microseconds 124 7C Unsigned 4 SCLSRM_CALSYSD Within-system delay steal threshold in microseconds 128 80 Unsigned 1 SCLSRM_SYSPRKFG SRM UNPARKing setting 0: large 1: medium 2: small 129 81 Character 3 * Reserved for IBM use 132 84 Character 0 * Additional fields may be inserted before here. Use offsets to locate any fields after this point. 0 0 Unsigned 4 SCLSRM_SRXCPPAD(0:PUCMAX) SET SRM CPUPAD settings, indexed by CPU type: 0 -- for type CP 1 -- not used 2 -- for type zAAP 3 -- for type IFL 4 -- for type ICF 5 -- for type zIIP A scaled number where X'00010000' represents one CPU's worth of capacity. SCLSRM_OFFCPPAD should be used to locate this field. 0 0 Unsigned 1 SCLSRM_SRXEXUSE(0:PUCMAX) SET SRM EXCESSUSE settings, indexed by CPU type. See SCLSRM_SRXCPPAD description for possible type list. SCLSRM_OFFEXUSE should be used to locate this field. 16 - indicates the system should be aggressive in using unentitled CPU capacity. 8 - indicates the system should be moderately aggressive in using unentitled CPU capacity. 1 - indicates the system should not be aggressive in using unentitled CPU capacity. 2 - indicates the system should not use unentitled CPU capacity. * * Character 0 SCLSRM_END
MRSCLSRM 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 SCLSRM 0 132+ SCLSRM_CALCHIPB 68 4 SCLSRM_CALCHIPD 6C 4 SCLSRM_CALFLAG 5D 1 SCLSRM_CALNODEB 70 4 SCLSRM_CALNODED 74 4 SCLSRM_CALSYSB 78 4 SCLSRM_CALSYSD 7C 4 SCLSRM_CALWDA 5F 1 SCLSRM_END * * SCLSRM_MRHDR 0 0 SCLSRM_OFFCPPAD 60 2 SCLSRM_OFFEXUSE 62 2 SCLSRM_PFXVVMXA 5D 80 SCLSRM_PUCMAX 5E 1 SCLSRM_SRMAWAIT 5C 80 SCLSRM_SRMBIASD 18 2 SCLSRM_SRMBIASI 14 4 SCLSRM_SRMDSPFL 64 1 SCLSRM_SRMFLAGS 5C 1 SCLSRM_SRMLDGCP 38 4 SCLSRM_SRMLDGUS 2A 2 SCLSRM_SRMLMCNS 5C 40 SCLSRM_SRML1DSP 4C 4 SCLSRM_SRML2DSP 50 4 SCLSRM_SRML3DSP 54 4 SCLSRM_SRMP1LDG 2C 4 SCLSRM_SRMP1WSS 3C 4 SCLSRM_SRMP2LDG 30 4 SCLSRM_SRMP2WSS 40 4 SCLSRM_SRMP3LDG 34 4 SCLSRM_SRMP3WSS 44 4 SCLSRM_SRMPRLCL 64 40 SCLSRM_SRMTSAFF 64 80 SCLSRM_SRMTSAFS 64 20 SCLSRM_SRMTSEPC 65 1 SCLSRM_SRMTSHOT 22 8 SCLSRM_SRMTSLIC 1A 8 SCLSRM_SRMWSSMP 48 4 SCLSRM_SRXCPPAD 0 4 SCLSRM_SRXEXHGH 7C 80 SCLSRM_SRXEXLOW 7C 20 SCLSRM_SRXEXMED 7C 40 SCLSRM_SRXEXUSE 0 1 SCLSRM_SYSGPRFD 5D 40 SCLSRM_SYSISVRT 5D 02 SCLSRM_SRYPRKFG 80 1
This information is based on z/VM V6R4.0.
Last updated on 31 Oct 2017 at 11:04:22.
Copyright IBM Corporation, 1990, 2017