|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRSCLDLL
PrologControl Block Contents
Cross Reference
MRSCLDLL Prolog
DSECT NAME - SCLDLL
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRSCLDLL
DESCRIPTIVE NAME - Monitor Event Record
Domain 2 - Scheduler domain
Record 14 - Drop VMDBK from the limit list
DESCRIPTION - Indicates conditions after user has been dropped from
the limit list. A separate record is generated for
each VMDBK in the virtual machine MP complex.
NOTE:
- 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.
MRSCLDLL Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 332 SCLDLL Start of monitor record 0 0 Character 0 SCLDLL_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 SCLDLL_VMDUSER Userid 28 1C Unsigned 2 SCLDLL_VMDCPUAD Virtual proc address 30 1E Bitstring 1 SCLDLL_DLLFLAG Flag byte 1... .... SCLDLL_DLLBASE 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 SCLDLL_VMDSCDF1 Scheduler flags 33 21 Bitstring 1 SCLDLL_VMDSCDF2 Scheduler flags byte 2 34 22 Bitstring 1 SCLDLL_VMDSCDF3 Scheduler flags byte 3 35 23 Bitstring 1 SCLDLL_VMDDLCTL Dispatch list controls 36 24 Bitstring 1 SCLDLL_VMDDLCTX Dispatch list ctls extension 37 25 Bitstring 1 SCLDLL_VMDSTATE Scheduler/dispatcher state 38 26 Bitstring 1 SCLDLL_VMDRSTAT Run blockage status 39 27 Bitstring 1 SCLDLL_VMDQSTAT Scheduling status 40 28 Bitstring 1 SCLDLL_VMDELIST Eligible list class 41 29 Bitstring 1 SCLDLL_VMDLMNDX Index to the element in the required throughput table. 42 2A Bitstring 1 * Reserved for IBM use 43 2B Bitstring 1 * Reserved for IBM use 44 2C Unsigned 4 SCLDLL_VMDRELSH VMDBK's relative share 48 30 Unsigned 4 SCLDLL_VMDABSSH VMDBK's absolute share 52 34 Unsigned 4 SCLDLL_VMDMXSHR Maximum share. Identified as absolute or relative by VMDSCDF3.VMDMXSHA 56 38 Character 8 SCLDLL_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 SCLDLL_VMDVTIME is the accumulated time in TOD clock units. 64 40 Character 8 SCLDLL_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 SCLDLL_VMDTTIME is the elapsed time in TOD clock units. 72 48 Character 8 SCLDLL_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 SCLDLL_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 SCLDLL_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 SCLDLL_VMDOPRTY This VMDBK's dispatch priority before adjustment factors such as interactive bias and paging bias 104 68 Unsigned 4 SCLDLL_VMDRTHRU This VMDBK's 'required throughput' or 'resource access' in the dispatch list 108 6C Unsigned 4 SCLDLL_VMDEDFAC This VMDBK's eligible list delay factor 112 70 Character 8 SCLDLL_VMDESLIC Elapsed time slice for d-list 120 78 Signed 4 SCLDLL_VMDCTCRT Count of critical processes this VMDBK is responsible for 124 7C Unsigned 2 SCLDLL_VMDSLCNT Count of minor time slices completed so far during this transaction 126 7E Bitstring 1 SCLDLL_VMDCFGEM Virt configuration indicators 127 7F Bitstring 1 SCLDLL_VMDPUST CPU status flags 128 80 Character 8 SCLDLL_VMDTTMP Total raw virtual and simulation time for the user on primary processor. 136 88 Character 8 SCLDLL_VMDVTMP Total raw virtual time for the user on primary processor. 144 90 Character 8 SCLDLL_VMDTTMS Total raw virtual and simulation time for the user on secondary processor. 152 98 Character 8 SCLDLL_VMDVTMS Total raw virtual time for the user on secondary processor. 160 A0 Character 8 * Reserved for IBM use 168 A8 Unsigned 4 SCLDLL_SRMCONLL Count of VMDBKs on all limit lists 172 AC Unsigned 4 * Reserved for IBM use 176 B0 Character 8 SCLDLL_SRXATOD Artificial TOD clock value 184 B8 Character 8 SCLDLL_SRXATOD2 Second ATOD -- used to decide when a VMDBK should come off of the limit list 192 C0 Unsigned 4 SCLDLL_SRXCONLL Count of VMDBKs on the limit list of this VMDBK's CPU type 196 C4 Character 8 SCLDLL_SRXTOTLS Share totals 196 C4 Character 4 SCLDLL_SRXRELDL The sum of the relative shares of all RELATIVE share holders (excluding dedicated VMDBKs) currently in the dispatch list. 200 C8 Character 4 SCLDLL_SRXABSDL The sum of the absolute shares of all VMDBKs (excluding dedicated VMDBKs) currently in the dispatch list. 204 CC Character 8 SCLDLL_SRXRTHRU Sums of the VMDRTHRU values for all the VMDBKs in the dispatch list 204 CC Character 4 SCLDLL_SRXRTHRN Total VMDRTHRU of VMDBKs in the dispatch list which are not currently hitting their max-SHAREs 208 D0 Character 4 SCLDLL_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 SCLDLL_SRXCTHRU, SCLDLL_SRXCTHRN, and SCLDLL_SRXCTHRL. 220 DC Character 8 SCLDLL_LIMPOOL CPU pool name that the user is assigned to. 228 E4 Character 8 SCLDLL_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 SCLDLL_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 SCLDLL_VMDVTMP_MT1 MT-1 Equivalent virtual time for the user on primary processor 252 FC Character 8 SCLDLL_VMDTTMP_MT1 MT-1 Equivalent total virtual and simulation time for the user on primary processor. 260 104 Character 8 SCLDLL_VMDVTMS_MT1 MT-1 Equivalent total virtual time for the user on secondary processor. 268 10C Character 8 SCLDLL_VMDTTMS_MT1 MT-1 Equivalent total virtual and simulation time for the user on secondary processor. 276 114 Character 8 SCLDLL_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 SCLDLL_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 SCLDLL_VMAVTMP_PRO Total Prorated Core virtual time for user on primary processor. See the notes above. 300 12C Character 8 SCLDLL_VMATTMP_PRO Total Prorated Core virtual and simulation time for the user on primary processor. See the notes above. 308 134 Character 8 SCLDLL_VMAVTMS_PRO Total Prorated Core virtual time for user on secondary processor. See the notes above. 316 13C Character 8 SCLDLL_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 SCLDLL_PROBITS Prorated Core Time bits needed to understand those fields. 1... .... SCLDLL_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.. .... SCLDLL_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 SCLDLL_END
MRSCLDLL 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
SCLDLL 0 332
SCLDLL_CALMRHDR 0 0
SCLDLL_DLLBASE 1E 80
SCLDLL_DLLFLAG 1E 1
SCLDLL_END 14C 0
SCLDLL_INDLMPRO 148 40
SCLDLL_LIMPOOL DC 8
SCLDLL_PROBITS 148 1
SCLDLL_SRMCONLL A8 4
SCLDLL_SRXABSDL C8 4
SCLDLL_SRXATOD B0 8
SCLDLL_SRXATOD2 B8 8
SCLDLL_SRXCONLL C0 4
SCLDLL_SRXRELDL C4 4
SCLDLL_SRXRTHRL D0 4
SCLDLL_SRXRTHRN CC 4
SCLDLL_SRXRTHRU CC 8
SCLDLL_SRXTOTLS C4 8
SCLDLL_VMAPRCAL 148 80
SCLDLL_VMATTIME_PRO 114 8
SCLDLL_VMATTMP_PRO 12C 8
SCLDLL_VMATTMS_PRO 13C 8
SCLDLL_VMAVTIME_PRO 11C 8
SCLDLL_VMAVTMP_PRO 124 8
SCLDLL_VMAVTMS_PRO 134 8
SCLDLL_VMDABSSH 30 4
SCLDLL_VMDCFGEM 7E 1
SCLDLL_VMDCPUAD 1C 2
SCLDLL_VMDCTCRT 78 4
SCLDLL_VMDDLCTL 23 1
SCLDLL_VMDDLCTX 24 1
SCLDLL_VMDDPRTY 50 8
SCLDLL_VMDEDFAC 6C 4
SCLDLL_VMDELIST 28 1
SCLDLL_VMDEPRTY 48 8
SCLDLL_VMDESLIC 70 8
SCLDLL_VMDLMNDX 29 1
SCLDLL_VMDLPRTY 58 8
SCLDLL_VMDMXSHR 34 4
SCLDLL_VMDOPRTY 60 8
SCLDLL_VMDPUST 7F 1
SCLDLL_VMDQSTAT 27 1
SCLDLL_VMDRELSH 2C 4
SCLDLL_VMDRSTAT 26 1
SCLDLL_VMDRTHRU 68 4
SCLDLL_VMDSCDF1 20 1
SCLDLL_VMDSCDF2 21 1
SCLDLL_VMDSCDF3 22 1
SCLDLL_VMDSLCNT 7C 2
SCLDLL_VMDSTATE 25 1
SCLDLL_VMDTTIME 40 8
SCLDLL_VMDTTIME_MT1 E4 8
SCLDLL_VMDTTMP 80 8
SCLDLL_VMDTTMP_MT1 FC 8
SCLDLL_VMDTTMS 90 8
SCLDLL_VMDTTMS_MT1 10C 8
SCLDLL_VMDUSER 14 8
SCLDLL_VMDVTIME 38 8
SCLDLL_VMDVTIME_MT1 EC 8
SCLDLL_VMDVTMP 88 8
SCLDLL_VMDVTMP_MT1 F4 8
SCLDLL_VMDVTMS 98 8
SCLDLL_VMDVTMS_MT1 104 8
This information is based on z/VM V7R2.0.
Last updated on 08 August 2020 at 16:10:53.
Copyright IBM Corporation, 1990, 2020