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 - SCLALL FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor Control Area REFERENCED CONTROL BLOCKS - MRRECHDR Monitor Record Header NAME - MRSCLALL DESCRIPTIVE NAME - Monitor Event Record Domain 2 - Scheduler domain Record 13 - Add VMDBK to the limit list DESCRIPTION - Indicates conditions after user has been added to the limit list. A separate record is generated for each VMDBK in the virtual machine MP complex. NOTES: - To give a fuller picture of time consumed, three sets of used processor time are reported in this monitor record. When multithreading is enabled on the system, all three are also reported in the Type 1 and F accounting records. Timer field names ending with _MT1 are MT-1 Equivalent times. Timer field names ending with _PRO are Prorated Core Times. Timer field names without an _MT1 or _PRO suffix contain Raw Time values. - Raw Time is tracked for ALL users for their entire session. Raw Time is the CPU time each virtual CPU spent dispatched on a thread and is the CPU Timer information provided directly by the hardware. - MT-1 Equivalent Time is tracked for ALL users for their entire session. This calculated CPU time approximates the time that would have been spent if the workload had been run with multithreading disabled, that is, with all core resources available to one thread. When a user is running on a system where multithreading is not installed or not enabled, MT-1 Equivalent Time consumed will be identical to Raw Time. However, if a guest has relocated from an MT-enabled system to an MT-disabled system, the cumulative raw and MT-1 Equivalent times reported in monitor records may differ due to the prior execution in the MT environment. - Prorated Core Time charges for core utilization in a way suitable to core-based software licensing. Time is charged by dividing the time the core was dispatched evenly among the threads dispatched in that interval. Since Prorated Core Time is not always calculated, additional information is reported regarding the Prorated Core Time values: * The _VMAPRCAL bit indicates whether the Prorated Core Time values in this record are valid. When the user is relocated to any other system (even a Multithreading aware/enabled system), Prorated Core Time is reset. This means: * the _VMAPRCAL bit is set based on whether the source system will be calculating prorated core time or not. * all _VMAxxxxx_PRO fields are reset to PFXTMMAX.
MRSCLALL Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 332 SCLALL Start of monitor record 0 0 Character 0 SCLALL_CALMRHDR 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 SCLALL_VMDUSER Userid 28 1C Unsigned 2 SCLALL_VMDCPUAD Virtual proc address 30 1E Bitstring 1 SCLALL_ALLFLAG Flag byte 1... .... SCLALL_ALLBASE If on, this is base VMDBK .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 31 1F Bitstring 1 * Reserved for IBM use 32 20 Bitstring 1 SCLALL_VMDSCDF1 Scheduler flags 33 21 Bitstring 1 SCLALL_VMDSCDF2 Scheduler flags byte 2 34 22 Bitstring 1 SCLALL_VMDSCDF3 Scheduler flags byte 3 35 23 Bitstring 1 SCLALL_VMDDLCTL Dispatch list controls 36 24 Bitstring 1 SCLALL_VMDDLCTX Dispatch list ctls extension 37 25 Bitstring 1 SCLALL_VMDSTATE Scheduler/dispatcher state 38 26 Bitstring 1 SCLALL_VMDRSTAT Run blockage status 39 27 Bitstring 1 SCLALL_VMDQSTAT Scheduling status 40 28 Bitstring 1 SCLALL_VMDELIST Eligible list class 41 29 Bitstring 1 SCLALL_VMDLMNDX Index to the element in the required throughput table. 42 2A Bitstring 1 * Reserved for IBM use 43 2B Unsigned 1 SCLALL_LIMITHIT Reason why user is being added to the limit list. Valid values: X'00' - Individual limit hit X'01' - CPU pool limit hit 44 2C Unsigned 4 SCLALL_VMDRELSH VMDBK's relative share 48 30 Unsigned 4 SCLALL_VMDABSSH VMDBK's absolute share 52 34 Unsigned 4 SCLALL_VMDMXSHR Maximum share. Identified as absolute or relative by VMDSCDF3.VMDMXSHA 56 38 Character 8 SCLALL_VMDVTIME Total Raw Time that this user was running, doing productive work. It does not include any time that CP spends on behalf of that user doing such things as instruction simulation or page translation. This is in CPU timer format. The complement of SCLALL_VMDVTIME is the accumulated time in TOD clock units. 64 40 Character 8 SCLALL_VMDTTIME Total Raw Time which has been expended on this VMDBK. This includes time which the VMDBK spent doing its own work and also time which CP spent doing work on behalf of the VMDBK. It is in CPU timer format. The complement of SCLALL_VMDTTIME is the elapsed time in TOD clock units. 72 48 Character 8 SCLALL_VMDEPRTY The eligible list priority, in TOD clock units. This is the the scheduler's estimate of the latest time this VMDBK should be selected to go into the dispatch list from the eligible list. It is used to order users in the eligible list. 80 50 Character 8 SCLALL_VMDDPRTY The VMDBK's dispatch list priority. This is based upon the user's SHARE, its time spent in the eligible list and SHARES of all other dispatch list users. It is then adjusted by such factors as interactive bias, paging bias and limits on how large or small this priority is allowed to be. It represents the relative order in which this user will be selected to be dispatched. 88 58 Character 8 SCLALL_VMDLPRTY This VMDBK's limit list priority. It is used to decide when to take the VMDBK off the limit list 96 60 Character 8 SCLALL_VMDOPRTY This VMDBK's dispatch priority before adjustment factors such as interactive bias and paging bias 104 68 Unsigned 4 SCLALL_VMDRTHRU This VMDBK's 'required throughput' or 'resource access' in the dispatch list 108 6C Unsigned 4 SCLALL_VMDEDFAC This VMDBK's eligible list delay factor 112 70 Character 8 SCLALL_VMDESLIC Elapsed time slice for d-list 120 78 Signed 4 SCLALL_VMDCTCRT Count of critical processes this VMDBK is responsible for 124 7C Unsigned 2 SCLALL_VMDSLCNT Count of minor time slices completed so far during this transaction 126 7E Bitstring 1 SCLALL_VMDCFGEM Virt configuration indicators 127 7F Bitstring 1 SCLALL_VMDPUST CPU status flags 128 80 Character 8 SCLALL_VMDTTMP Total raw virtual and simulation time for the user on primary processor. 136 88 Character 8 SCLALL_VMDVTMP Total raw virtual time for the user on primary processor. 144 90 Character 8 SCLALL_VMDTTMS Total raw virtual and simulation time for the user on secondary processor. 152 98 Character 8 SCLALL_VMDVTMS Total raw virtual time for the user on secondary processor. 160 A0 Character 8 * Reserved for IBM use 168 A8 Unsigned 4 SCLALL_SRMCONLL Count of VMDBKs on all limit lists 172 AC Unsigned 4 * Reserved for IBM use 176 B0 Character 8 SCLALL_SRXATOD Artificial TOD clock value 184 B8 Character 8 SCLALL_SRXATOD2 Second ATOD -- used to decide when a VMDBK should come off of the limit list 192 C0 Unsigned 4 SCLALL_SRXCONLL Count of VMDBKs on the limit list of this VMDBK's CPU type 196 C4 Character 8 SCLALL_SRXTOTLS Share totals 196 C4 Character 4 SCLALL_SRXRELDL The sum of the relative shares of all RELATIVE share holders (excluding dedicated VMDBKs) currently in the dispatch list. 200 C8 Character 4 SCLALL_SRXABSDL The sum of the absolute shares of all VMDBKs (excluding dedicated VMDBKs) currently in the dispatch list. 204 CC Character 8 SCLALL_SRXRTHRU Sums of the VMDRTHRU values for all the VMDBKs in the dispatch list 204 CC Character 4 SCLALL_SRXRTHRN Total VMDRTHRU of VMDBKs in the dispatch list which are not currently hitting their max-SHAREs 208 D0 Character 4 SCLALL_SRXRTHRL Total VMDRTHRU of VMDBKs in the dispatch list which are currently hitting their max-SHAREs (LIMITed and hitting the limit) 212 D4 Character 8 * Reserved for IBM use. Formerly SCLALL_SRXCTHRU, SCLALL_SRXCTHRN, and SCLALL_SRXCTHRL. 220 DC Character 8 SCLALL_LIMPOOL CPU pool name that the user is assigned to. 228 E4 Character 8 SCLALL_VMDTTIME_MT1 Total MT-1 Equivalent time which has been expended on this VMDBK. This includes time which the VMDBK spent doing its own work and also time which CP spent doing work on behalf of the VMDBK. It is in CPU timer format. 236 EC Character 8 SCLALL_VMDVTIME_MT1 Total MT-1 Equivalent time that this user was running and doing productive work. It does NOT include any time that CP spends on behalf of that user doing such things as instruction simulation or page translation. This is in CPU timer format. 244 F4 Character 8 SCLALL_VMDVTMP_MT1 MT-1 Equivalent virtual time for the user on primary processor 252 FC Character 8 SCLALL_VMDTTMP_MT1 MT-1 Equivalent total virtual and simulation time for the user on primary processor. 260 104 Character 8 SCLALL_VMDVTMS_MT1 MT-1 Equivalent total virtual time for the user on secondary processor. 268 10C Character 8 SCLALL_VMDTTMS_MT1 MT-1 Equivalent total virtual and simulation time for the user on secondary processor. 276 114 Character 8 SCLALL_VMATTIME_PRO Total Prorated Core Time which has been expended on this VMDBK. This includes time which the VMDBK spent doing its own work and also time which CP spent doing work on behalf of the VMDBK. It is in CPU timer format. See the notes above. 284 11C Character 8 SCLALL_VMAVTIME_PRO Total Prorated Core Time that this user was running and doing productive work. It does NOT include any time that CP spends on behalf of that user doing such things as instruction simulation or page translation. This is in CPU timer format. See the notes above. 292 124 Character 8 SCLALL_VMAVTMP_PRO Total Prorated Core virtual time for user on primary processor. See the notes above. 300 12C Character 8 SCLALL_VMATTMP_PRO Total Prorated Core virtual and simulation time for the user on primary processor. See the notes above. 308 134 Character 8 SCLALL_VMAVTMS_PRO Total Prorated Core virtual time for user on secondary processor. See the notes above. 316 13C Character 8 SCLALL_VMATTMS_PRO Total Prorated Core virtual and simulation time for the user on secondary processor. See the notes above. 324 144 Unsigned 4 * Reserved for IBM use 328 148 Bitstring 1 SCLALL_PROBITS Prorated Core Time bits needed to understand those fields. 1... .... SCLALL_VMAPRCAL Indicates whether the Prorated Core Time values in this record are valid (only use if valid): 0 = values not valid 1 = values are valid .1.. .... SCLALL_INDLMPRO Indicates basis for individual limiting: 0 = raw CPU time 1 = prorated core time ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 329 149 Bitstring 1 * Reserved for IBM use 330 14A Unsigned 2 * Reserved for IBM use 332 14C Character 0 SCLALL_END
MRSCLALL 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 SCLALL 0 332 SCLALL_ALLBASE 1E 80 SCLALL_ALLFLAG 1E 1 SCLALL_CALMRHDR 0 0 SCLALL_END 14C 0 SCLALL_INDLMPRO 148 40 SCLALL_LIMITHIT 2B 1 SCLALL_LIMPOOL DC 8 SCLALL_PROBITS 148 1 SCLALL_SRMCONLL A8 4 SCLALL_SRXABSDL C8 4 SCLALL_SRXATOD B0 8 SCLALL_SRXATOD2 B8 8 SCLALL_SRXCONLL C0 4 SCLALL_SRXRELDL C4 4 SCLALL_SRXRTHRL D0 4 SCLALL_SRXRTHRN CC 4 SCLALL_SRXRTHRU CC 8 SCLALL_SRXTOTLS C4 8 SCLALL_VMAPRCAL 148 80 SCLALL_VMATTIME_PRO 114 8 SCLALL_VMATTMP_PRO 12C 8 SCLALL_VMATTMS_PRO 13C 8 SCLALL_VMAVTIME_PRO 11C 8 SCLALL_VMAVTMP_PRO 124 8 SCLALL_VMAVTMS_PRO 134 8 SCLALL_VMDABSSH 30 4 SCLALL_VMDCFGEM 7E 1 SCLALL_VMDCPUAD 1C 2 SCLALL_VMDCTCRT 78 4 SCLALL_VMDDLCTL 23 1 SCLALL_VMDDLCTX 24 1 SCLALL_VMDDPRTY 50 8 SCLALL_VMDEDFAC 6C 4 SCLALL_VMDELIST 28 1 SCLALL_VMDEPRTY 48 8 SCLALL_VMDESLIC 70 8 SCLALL_VMDLMNDX 29 1 SCLALL_VMDLPRTY 58 8 SCLALL_VMDMXSHR 34 4 SCLALL_VMDOPRTY 60 8 SCLALL_VMDPUST 7F 1 SCLALL_VMDQSTAT 27 1 SCLALL_VMDRELSH 2C 4 SCLALL_VMDRSTAT 26 1 SCLALL_VMDRTHRU 68 4 SCLALL_VMDSCDF1 20 1 SCLALL_VMDSCDF2 21 1 SCLALL_VMDSCDF3 22 1 SCLALL_VMDSLCNT 7C 2 SCLALL_VMDSTATE 25 1 SCLALL_VMDTTIME 40 8 SCLALL_VMDTTIME_MT1 E4 8 SCLALL_VMDTTMP 80 8 SCLALL_VMDTTMP_MT1 FC 8 SCLALL_VMDTTMS 90 8 SCLALL_VMDTTMS_MT1 10C 8 SCLALL_VMDUSER 14 8 SCLALL_VMDVTIME 38 8 SCLALL_VMDVTIME_MT1 EC 8 SCLALL_VMDVTMP 88 8 SCLALL_VMDVTMP_MT1 F4 8 SCLALL_VMDVTMS 98 8 SCLALL_VMDVTMS_MT1 104 8
This information is based on z/VM V6R4.0.
Last updated on 4 Oct 2016 at 15:33:58.
Copyright IBM Corporation, 1990, 2016