Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRSCLADL
PrologControl Block Contents
Cross Reference
MRSCLADL Prolog
DSECT NAME - SCLADL FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor Control Area REFERENCED CONTROL BLOCKS - MRRECHDR Monitor Record Header NAME - MRSCLADL DESCRIPTIVE NAME - Monitor Event Record Domain 2 - Scheduler Domain Record 4 - Add User To Dispatch List DESCRIPTION - Indicates conditions after user has been added to dispatch 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.
MRSCLADL Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 336 SCLADL Start of monitor record 0 0 Character 0 SCLADL_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 Character 8 SCLADL_VMDUSER Userid 28 1C Unsigned 4 SCLADL_SRMTOTST Memory available to the scheduler to assign to users as they enter the dispatch list 32 20 Unsigned 4 SCLADL_SRMWSSDL Accumulated count of all dispatch list users' working set sizes. This is an instantaneous (not a smoothed) value. 36 24 Unsigned 2 SCLADL_SRMCDISP Cardinal count of users in the dispatch list. 38 26 Unsigned 2 SCLADL_SRMC1DSP Cardinal count of short, medium, and long running users in the dispatch list. 40 28 Unsigned 2 SCLADL_SRMC2DSP Cardinal count of medium and long running users in the dispatch list. This includes all Q2 and Q3 users. It includes no Q1 or Q0 users. 42 2A Unsigned 2 SCLADL_SRMC3DSP Cardinal count of long running users in the dispatch list. It includes all Q3 users. It includes no Q1, Q2, or Q0 users. 44 2C Character 8 SCLADL_VMDSVMID VMDBK name for the last successful IUCV, VMCF or APPC/VM Send for this virtual machine. Valid in base VMDBK only. 52 34 Bitstring 1 SCLADL_VMDSVMWT Service-virtual-machine (SVM) wait flag - valid in base VMDBK only. 1... .... SCLADL_VMDSVMWF VMDBK is waiting for a response from IUCV, VMCF or APPC. .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 53 35 Character 0 SCLADL_VMDSVMW2 back-up byte to the VMDSVMWT byte. Its contents will persist longer than they would in VMDSVMWT. Valid in base VMDBK only. 53 35 Bitstring 1 SCLADL_VMDSVMWT Service-virtual-machine (SVM) wait flag - valid in base VMDBK only. 1... .... SCLADL_VMDSVMWF VMDBK is waiting for a response from IUCV, VMCF or APPC. 54 36 Character 0 SCLADL_VMDRDYCM Flag byte set by IUCV, VMCF, or APPC whenever IUCV/VMCF/APPC makes an external interrupt pending in a virtual machine. It is sort of a "reference bit" that tells the scheduler that IUCV/VMCF/APPC has been active recently. Valid in base VMDBK only. 54 36 Bitstring 1 SCLADL_VMDSVMWT Service-virtual-machine (SVM) wait flag - valid in base VMDBK only. 1... .... SCLADL_VMDSVMWF VMDBK is waiting for a response from IUCV, VMCF or APPC. 55 37 Bitstring 1 SCLADL_CALFLAG1 Flag byte 1... .... SCLADL_CALBASE If on, this is base VMDBK. VMDBASE .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 56 38 Unsigned 4 SCLADL_VMDWSSPR This user's projected working set size. This is the scheduler's estimate of the amount of storage this user will require to be resident as it runs during its next stay in the dispatch list. It is based upon the user's past behavior, and in some cases, on the behavior of similar types of users. 60 3C Unsigned 4 SCLADL_VMDPGRTE Number of pages per second which this user read in during its last stay in the dispatch list 64 40 Bitstring 1 SCLADL_CALQSTAT Scheduling status of user 1... .... SCLADL_VMDHOTRQ Hot Shot scheduling requested .1.. .... SCLADL_VMDHOTST Hot Shot user scheduling granted ..1. .... SCLADL_VMDLOADU Loading user designation ...1 .... SCLADL_VMDIABIA Interactive bias is in effect .... 1... * .... .1.. SCLADL_VMDLKSHT "Lockshot" scheduling in effect for this user. Set only in the base VMDBK. .... ..1. * .... ...1 SCLADL_VMDNULL User is logging off 65 41 Unsigned 1 SCLADL_VMDELIST This user's dispatch list class. It can be 0, 1, 2, or 3. Class 1-3 relate to the time this (scheduler determined) transaction has been running. Class 1 are short-running, class 2, medium-running and class 3, long-running. 66 42 Unsigned 2 SCLADL_VMDCPUAD Virtual processor address 68 44 Unsigned 4 SCLADL_VMDRPLIM Resident page growth limit 72 48 Unsigned 4 SCLADL_VMDCTPVR Cardinal count of resident pages in private address spaces belonging to this user. This monitor field is actually the sum of VMDCTPVR + VMDCTPVG which is the resident pages above and below the 2GB line. To get the count of resident pages below the 2GB line, subtract SCLADL_VMDCTPVG from SCLADL_VMDCTPVR. 76 4C Character 8 SCLADL_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 SCLADL_VMDVTIME is the accumulated time in TOD clock units. 84 54 Character 8 SCLADL_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 SCLADL_VMDTTIME is the elapsed time in TOD clock units. 92 5C Character 8 SCLADL_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. 100 64 Character 8 SCLADL_VMDDPRTY The user'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. 108 6C Character 8 SCLADL_VMDOPRTY This user's dispatch priority before adjustment factors such as interactive bias and paging bias 116 74 Unsigned 4 SCLADL_VMDRTHRU This user's 'required throughput' or 'resource access' in the dispatch list 120 78 Unsigned 4 * Reserved for IBM use - was SCLADL_VMDCTXBK 124 7C Unsigned 4 * Reserved for IBM used - was SCLADL_VMDFLREO 128 80 Unsigned 4 * Reserved for IBM use - was SCLADL_VMDCTORF 132 84 Unsigned 4 SCLADL_CALCPPST Cumulative count of pages reclaimed from this user's addr spaces while they were private. 136 88 Bitstring 1 SCLADL_CALOSTAT Virtual machine operating status 1... .... SCLADL_VMDSYSOP User is primary system operator .1.. .... SCLADL_VMDUSRCT User is counted as being logged on ..1. .... * ...1 .... SCLADL_VMDFORCE User is to be logged off. This may be requested by CP, a forced logoff, or user's logoff command. .... 1... SCLADL_VMDUFORC User is forced to logoff the system .... .1.. SCLADL_VMDDISC User is running disconnected .... ..1. SCLADL_VMDAUTOL AUTOLOG/XAUTOLOG in progress. User has been automatically logged on. This bit is set off when the user's IPL statement is processed, or (if there is no IPL to process) when the user enters a LOGON command from a terminal to RECONNECT. .... ...1 SCLADL_VMDXAUTO The original command was XAUTOLOG. Valid for the base VMDBK only. 137 89 Bitstring 1 SCLADL_CALSHARF Set Share flags 1... .... SCLADL_VMDMXSHA Max share is Absolute if ON. Max share is Relative if OFF. .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. SCLADL_VMDLIMTH Max Share is Limithard if ON. Max Share is Limitsoft if OFF. .... ...1 * 138 8A Signed 2 SCLADL_VMDSLCNT Count of minor time slices that have expired since the start of current transaction. 140 8C Character 8 SCLADL_VMDESLIC The elapsed time slice this user will receive in the dispatch list before having to return to the eligible list. 148 94 Unsigned 4 SCLADL_VMDRELSH This virtual CPU's RELATIVE share of the system, as set in the user's directory or via the SET SHARE command. Set to zero when this VMDBK has an ABSOLUTE share value, or has a virtual processor dedicated to it, or is in the process of being logged off. 152 98 Unsigned 4 SCLADL_VMDABSSH This virtual CPU's ABSOLUTE share of the system, as set in the user's directory or via the SET SHARE command. Unit of value is a hexadecimal factor scaled 16 bits. For example, X'00010000' = 1.00(100%), X'0000C000' = 0.75(75%), X'00008000' = 0.50(50%), etc. Set to zero when this VMDBK has a RELATIVE share value. 156 9C Unsigned 4 SCLADL_VMDVUSCT Count of start requests to virtual unit record devices 160 A0 Signed 4 SCLADL_SRMABSDL Cardinal count of total absolute shares of all VMDBKs in the dispatch list. The unit of value is the same as SCLADL_VMDABSSH. Applies to real primary processor on which user is dispatched. 164 A4 Signed 4 SCLADL_SRMRELDL Cardinal count of total relative shares of all VMDBKs in the dispatch list. Applies to real primary processor on which user is dispatched. 168 A8 Unsigned 4 SCLADL_VMDCTCRT Count of CP critical-processes this VMDBK is responsible for. VMDBK must not wait in eligible list while this count is greater than 0. Valid only in base VMDBK. 172 AC Unsigned 4 SCLADL_VMDMXSHR The virtual CPU's max share of the system, as set in the user's directory or via the SET SHARE command. This value is set to zero if no Max share exists. If the Max share is Absolute, then the unit of the value is a hexadecimal factor scaled 16 bits. For example, X'00010000' = 1.00(100%), X'0000C000' = 0.75(75%), X'00008000' = 0.50(50%), etc. Check SCLADL_VMDMXSHA to determine if Max share is absolute or relative. 176 B0 Character 8 SCLADL_SRMATOD Artificial TOD. This TOD only advances at the rate the system is running user work. Applies to real primary processor on which user is dispatched. 184 B8 Character 8 SCLADL_SRMATOD2 Artificial TOD2. This TOD only advances with each CPU's user time and each CPU's wait time. Applies to real primary processor on which user is dispatched. 192 C0 Unsigned 4 SCLADL_VMDCTPVG Count of private address space resident pages in DPA owned by this virtual machine which are above the 2GB line. Valid only in base VMDBK. To get total resident pages under the 2GB line, subtract this field from SCLADL_VMDCTPVR. 196 C4 Bitstring 1 SCLADL_VMDCFGEM Virtual configuration indicators. Valid in base VMDBK only 1... .... * .1.. .... SCLADL_VMDCPUAF User requested CPU Affinity ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 197 C5 Bitstring 1 SCLADL_VMDPUST CPU Status flag 1... .... SCLADL_VMDAFSUP CPU Affinity suppressed .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 198 C6 Character 2 * Reserved for IBM use 200 C8 Character 8 SCLADL_VMDVTMP Total raw virtual time for the user on primary processor. 208 D0 Character 8 SCLADL_VMDTTMP Total raw virtual and simulation time for the user on primary processor. 216 D8 Character 8 SCLADL_VMDVTMS Total raw virtual time for the user on secondary processor. 224 E0 Character 8 SCLADL_VMDTTMS Total raw virtual and simulation time for the user on secondary processor. 232 E8 Character 8 SCLADL_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. 240 F0 Character 8 SCLADL_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. 248 F8 Character 8 SCLADL_VMDVTMP_MT1 MT-1 Equivalent virtual time for the user on primary processor 256 100 Character 8 SCLADL_VMDTTMP_MT1 MT-1 Equivalent total virtual and simulation time for the user on primary processor. 264 108 Character 8 SCLADL_VMDVTMS_MT1 MT-1 Equivalent total virtual time for the user on secondary processor. 272 110 Character 8 SCLADL_VMDTTMS_MT1 MT-1 Equivalent total virtual and simulation time for the user on secondary processor. 280 118 Character 8 SCLADL_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. 288 120 Character 8 SCLADL_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. 296 128 Character 8 SCLADL_VMAVTMP_PRO Total Prorated Core virtual time for user on primary processor. See the notes above. 304 130 Character 8 SCLADL_VMATTMP_PRO Total Prorated Core virtual and simulation time for the user on primary processor. See the notes above. 312 138 Character 8 SCLADL_VMAVTMS_PRO Total Prorated Core virtual time for user on secondary processor. See the notes above. 320 140 Character 8 SCLADL_VMATTMS_PRO Total Prorated Core virtual and simulation time for the user on secondary processor. See the notes above. 328 148 Unsigned 4 * Reserved for IBM use 332 14C Bitstring 1 SCLADL_PROBITS Prorated Core Time bits needed to understand those fields. 1... .... SCLADL_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.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 333 14D Bitstring 1 * Reserved for IBM use 334 14E Unsigned 2 * Reserved for IBM use 336 150 Character 0 SCLADL_END
MRSCLADL 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 SCLADL 0 336 SCLADL_CALBASE 37 80 SCLADL_CALCPPST 84 4 SCLADL_CALFLAG1 37 1 SCLADL_CALOSTAT 88 1 SCLADL_CALQSTAT 40 1 SCLADL_CALSHARF 89 1 SCLADL_END 150 0 SCLADL_MRHDR 0 0 SCLADL_PROBITS 14C 1 SCLADL_SRMABSDL A0 4 SCLADL_SRMATOD B0 8 SCLADL_SRMATOD2 B8 8 SCLADL_SRMCDISP 24 2 SCLADL_SRMC1DSP 26 2 SCLADL_SRMC2DSP 28 2 SCLADL_SRMC3DSP 2A 2 SCLADL_SRMRELDL A4 4 SCLADL_SRMTOTST 1C 4 SCLADL_SRMWSSDL 20 4 SCLADL_VMAPRCAL 14C 80 SCLADL_VMATTIME_PRO 118 8 SCLADL_VMATTMP_PRO 130 8 SCLADL_VMATTMS_PRO 140 8 SCLADL_VMAVTIME_PRO 120 8 SCLADL_VMAVTMP_PRO 128 8 SCLADL_VMAVTMS_PRO 138 8 SCLADL_VMDABSSH 98 4 SCLADL_VMDAFSUP C5 80 SCLADL_VMDAUTOL 88 02 SCLADL_VMDCFGEM C4 1 SCLADL_VMDCPUAD 42 2 SCLADL_VMDCPUAF C4 40 SCLADL_VMDCTCRT A8 4 SCLADL_VMDCTPVG C0 4 SCLADL_VMDCTPVR 48 4 SCLADL_VMDDISC 88 04 SCLADL_VMDDPRTY 64 8 SCLADL_VMDELIST 41 1 SCLADL_VMDEPRTY 5C 8 SCLADL_VMDESLIC 8C 8 SCLADL_VMDFORCE 88 10 SCLADL_VMDHOTRQ 40 80 SCLADL_VMDHOTST 40 40 SCLADL_VMDIABIA 40 10 SCLADL_VMDLIMTH 89 02 SCLADL_VMDLKSHT 40 04 SCLADL_VMDLOADU 40 20 SCLADL_VMDMXSHA 89 80 SCLADL_VMDMXSHR AC 4 SCLADL_VMDNULL 40 01 SCLADL_VMDOPRTY 6C 8 SCLADL_VMDPGRTE 3C 4 SCLADL_VMDPUST C5 1 SCLADL_VMDRDYCM 36 0 SCLADL_VMDRELSH 94 4 SCLADL_VMDRPLIM 44 4 SCLADL_VMDRTHRU 74 4 SCLADL_VMDSLCNT 8A 2 SCLADL_VMDSVMID 2C 8 SCLADL_VMDSVMWF 34 80 SCLADL_VMDSVMWF 35 80 SCLADL_VMDSVMWF 36 80 SCLADL_VMDSVMWT 34 1 SCLADL_VMDSVMWT 35 1 SCLADL_VMDSVMWT 36 1 SCLADL_VMDSVMW2 35 0 SCLADL_VMDSYSOP 88 80 SCLADL_VMDTTIME 54 8 SCLADL_VMDTTIME_MT1 E8 8 SCLADL_VMDTTMP D0 8 SCLADL_VMDTTMP_MT1 100 8 SCLADL_VMDTTMS E0 8 SCLADL_VMDTTMS_MT1 110 8 SCLADL_VMDUFORC 88 08 SCLADL_VMDUSER 14 8 SCLADL_VMDUSRCT 88 40 SCLADL_VMDVTIME 4C 8 SCLADL_VMDVTIME_MT1 F0 8 SCLADL_VMDVTMP C8 8 SCLADL_VMDVTMP_MT1 F8 8 SCLADL_VMDVTMS D8 8 SCLADL_VMDVTMS_MT1 108 8 SCLADL_VMDVUSCT 9C 4 SCLADL_VMDWSSPR 38 4 SCLADL_VMDXAUTO 88 01
This information is based on z/VM V6R4.0.
Last updated on 4 Oct 2016 at 15:27:13.
Copyright IBM Corporation, 1990, 2016