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 - SCLDDL FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor Control Area REFERENCED CONTROL BLOCKS - MRRECHDR Monitor Record Header NAME - MRSCLDDL DESCRIPTIVE NAME - Monitor Event Record Domain 2 - Scheduler Domain Record 5 - Drop User From Dispatch List DESCRIPTION - Indicates conditions after this user has been dropped from the dispatch list. A separate record is generated for each VMDBK in the virtual 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.
MRSCLDDL Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 300 SCLDDL Start of monitor record 0 0 Character 0 SCLDDL_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 SCLDDL_VMDUSER Userid 28 1C Character 8 SCLDDL_VMDSVMID VMDBK name for the last successful IUCV, VMCF or APPC/VM Send for this virtual machine. Valid in base VMDBK only. 36 24 Bitstring 1 SCLDDL_VMDSVMWT Service-virtual-machine (SVM) wait flag - valid in base VMDBK only. 1... .... SCLDDL_VMDSVMWF VMDBK is waiting for a response from IUCV, VMCF, or APPC. .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 37 25 Character 0 SCLDDL_VMDSVMW2 back-up byte to the VMDSVMWT byte. Copied here so that they will persist longer than they would in VMDSVMWT. Valid in base VMDBK only. 37 25 Bitstring 1 SCLDDL_VMDSVMWT Service-virtual-machine (SVM) wait flag - valid in base VMDBK only. 1... .... SCLDDL_VMDSVMWF VMDBK is waiting for a response from IUCV, VMCF, or APPC. 38 26 Character 0 SCLDDL_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. 38 26 Bitstring 1 SCLDDL_VMDSVMWT Service-virtual-machine (SVM) wait flag - valid in base VMDBK only. 1... .... SCLDDL_VMDSVMWF VMDBK is waiting for a response from IUCV, VMCF, or APPC. 39 27 Bitstring 1 SCLDDL_CALFLAG1 Flag Byte 1 1... .... SCLDDL_VMDLRGST User was preemptied due to its large storage requirement .1.. .... SCLDDL_CALBASE If on, this is the base VMDBK. VMDBASE ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 40 28 Unsigned 4 SCLDDL_VMDWSSPR This user's projected working 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. 44 2C Unsigned 4 SCLDDL_VMDPGRTE Number of pages per second which this user read in during its last stay in the dispatch list. 48 30 Unsigned 4 SCLDDL_VMDRPLIM Resident page growth limit 52 34 Unsigned 4 SCLDDL_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 SCLDDL_VMDCTPVG from SCLDDL_VMDCTPVR. 56 38 Character 8 SCLDDL_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 SCLDDL_VMDVTIME is the accumulated time in TOD clock units. 64 40 Character 8 SCLDDL_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 SCLDDL_VMDTTIME is the elapsed time in TOD clock units. 72 48 Character 8 SCLDDL_VMDDPRTY The user's dispatch list priority. This is based on 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. 80 50 Character 8 SCLDDL_VMDOPRTY The user's dispatch priority before adjustment for factors such as interactive bias and paging bias 88 58 Unsigned 4 SCLDDL_VMDRTHRU This user's 'required throughput' or 'resource access' in the dispatch list. This is the amount of time while the user is in the dispatch list that it should be offered access to system resources, considering its SHARE and the time it spent in the eligible list. 92 5C Unsigned 4 * Reserved for IBM use - was SCLDDL_VMDCTXBK 96 60 Unsigned 4 * Reserved for IBM use - was SCLDDL_VMDFLREO 100 64 Unsigned 4 * Reserved for IBM use - was SCLDDL_VMDCTORF 104 68 Unsigned 4 SCLDDL_CALCPPST Cumulative count of pages reclaimed from this user's addr spaces while they were private. 108 6C Bitstring 1 SCLDDL_CALRSTAT Reason(s) the dispatched VMDBK is not being run 1... .... * .1.. .... SCLDDL_VMDCFWT VMDBK is in console function wait. Either a console function is active, or the virtual machine is waiting for the remaining VMDBKs in the configuration to enter console function mode. ..1. .... SCLDDL_VMDSIMWT CP is simulating some hardware function for the guest such as instructions, interrupts, and timer updates. Virtual machine is prevented from running to avoid potential conflicts with the simulations. ...1 .... SCLDDL_VMDIOWT Instruction waiting for I/O status for completion. (May be cancelled without loss of system integrity.) .... 1... * .... .1.. * .... ..1. * .... ...1 * 109 6D Bitstring 1 SCLDDL_VMDSTATE Scheduler/Dispatcher State. X'63' = Review-suspended. VMDBK is in transition to the suspended state. X'58' = Review-idle. VMDBK is in transition to the idle state. X'4D' = VMDBK has been selected by dispatcher for processing. X'42' = VMDBK is ready for selection by dispatcher once it goes to the dispatch list. X'37' = Test-idle. VMDBK is ready for selection by the dispatcher but should be dropped from the dispatch list when selected the next time. X'2C' = VMDBK is suspended, probably waiting for a short-term event to occur. X'00' = VMDBK is idle. No work is available. 110 6E Bitstring 1 SCLDDL_CALOSTAT Virtual machine operating status 1... .... SCLDDL_VMDSYSOP User is primary system operator .1.. .... SCLDDL_VMDUSRCT User is counted as being logged on ..1. .... * ...1 .... SCLDDL_VMDFORCE User is to be logged off. This may be requested by CP, a forced logoff, or user's logoff command. .... 1... SCLDDL_VMDUFORC User is forced to logoff the system .... .1.. SCLDDL_VMDDISC User is running disconnected .... ..1. SCLDDL_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 SCLDDL_VMDXAUTO The original command was XAUTOLOG. Valid for the base VMDBK only. 111 6F Bitstring 1 SCLDDL_VMDSACTL Dispatch list control bits. These are used to signal the dispatcher that the currently dispatched user requires scheduler intervention, either due to having reached a resource consumption limit or some other reason. At dispatch list drop time, these bits can indicate why the user was dropped. 112 70 Unsigned 4 * Reserved for IBM use. Previous field is no longer meaningful. (SCLDDL_VMDCWSS) 116 74 Unsigned 1 SCLDDL_VMDSACTX An extension byte to VMDSACTL. It describes additional reasons why the user required scheduler intervention, given that the 'other resources' bit is on in VMDSACTL. 117 75 Bitstring 1 SCLDDL_CALQSTAT Scheduling status of user 1... .... SCLDDL_VMDHOTRQ Hot Shot scheduling requested .1.. .... SCLDDL_VMDHOTST Hot Shot user scheduling granted ..1. .... SCLDDL_VMDLOADU Loading user designation ...1 .... SCLDDL_VMDIABIA Interactive bias is in effect .... 1... * .... .1.. SCLDDL_VMDLKSHT "Lockshot" scheduling in effect for this user. Set only in the base VMDBK. .... ..1. * .... ...1 SCLDDL_VMDNULL User is logging off 118 76 Unsigned 2 SCLDDL_VMDCPUAD Virtual processor address 120 78 Unsigned 4 SCLDDL_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. 124 7C Unsigned 4 SCLDDL_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. 128 80 Unsigned 4 SCLDDL_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. 132 84 Bitstring 1 SCLDDL_CALSHARF Set Share flags 1... .... SCLDDL_VMDMXSHA Max share is Absolute if ON. Max share is Relative if OFF. .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. SCLDDL_VMDLIMTH Max share is Limithard if ON. Max share is Limitsoft if OFF. .... ...1 * 133 85 Unsigned 1 * Reserved and available for IBM use. 134 86 Signed 2 SCLDDL_VMDSLCNT Count of minor time slices that have expired since the start of current transaction. 136 88 Unsigned 4 SCLDDL_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 SCLDDL_VMDMXSHA to determine if Max share is absolute or relative. 140 8C Character 8 SCLDDL_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. 148 94 Character 8 SCLDDL_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. 156 9C Unsigned 4 SCLDDL_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 SCLDDL_VMDCTPVR. 160 A0 Bitstring 1 SCLDDL_VMDCFGEM Virtual configuration indicators. Valid in base VMDBK only 1... .... * .1.. .... SCLDDL_VMDCPUAF User requested CPU Affinity ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 161 A1 Bitstring 1 SCLDDL_VMDPUST CPU Status flag 1... .... SCLDDL_VMDAFSUP CPU Affinity suppressed .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 162 A2 Character 2 * Reserved for IBM use 164 A4 Character 8 SCLDDL_VMDVTMP Total raw virtual time for the user on primary processor. 172 AC Character 8 SCLDDL_VMDTTMP Total raw virtual and simulation time for the user on primary processor. 180 B4 Character 8 SCLDDL_VMDVTMS Total raw virtual time for the user on secondary processor. 188 BC Character 8 SCLDDL_VMDTTMS Total raw virtual and simulation time for the user on secondary processor. 196 C4 Character 8 SCLDDL_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. 204 CC Character 8 SCLDDL_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. 212 D4 Character 8 SCLDDL_VMDVTMP_MT1 MT-1 Equivalent virtual time for the user on primary processor 220 DC Character 8 SCLDDL_VMDTTMP_MT1 MT-1 Equivalent total virtual and simulation time for the user on primary processor. 228 E4 Character 8 SCLDDL_VMDVTMS_MT1 MT-1 Equivalent total virtual time for the user on secondary processor. 236 EC Character 8 SCLDDL_VMDTTMS_MT1 MT-1 Equivalent total virtual and simulation time for the user on secondary processor. 244 F4 Character 8 SCLDDL_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. 252 FC Character 8 SCLDDL_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. 260 104 Character 8 SCLDDL_VMAVTMP_PRO Total Prorated Core virtual time for user on primary processor. See the notes above. 268 10C Character 8 SCLDDL_VMATTMP_PRO Total Prorated Core virtual and simulation time for the user on primary processor. See the notes above. 276 114 Character 8 SCLDDL_VMAVTMS_PRO Total Prorated Core virtual time for user on secondary processor. See the notes above. 284 11C Character 8 SCLDDL_VMATTMS_PRO Total Prorated Core virtual and simulation time for the user on secondary processor. See the notes above. 292 124 Unsigned 4 * Reserved for IBM use 296 128 Bitstring 1 SCLDDL_PROBITS Prorated Core Time bits needed to understand those fields. 1... .... SCLDDL_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 * 297 129 Bitstring 1 * Reserved for IBM use 298 12A Unsigned 2 * Reserved for IBM use 300 12C Character 0 SCLDDL_END
MRSCLDDL 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 SCLDDL 0 300 SCLDDL_CALBASE 27 40 SCLDDL_CALCPPST 68 4 SCLDDL_CALFLAG1 27 1 SCLDDL_CALOSTAT 6E 1 SCLDDL_CALQSTAT 75 1 SCLDDL_CALRSTAT 6C 1 SCLDDL_CALSHARF 84 1 SCLDDL_END 12C 0 SCLDDL_MRHDR 0 0 SCLDDL_PROBITS 128 1 SCLDDL_SRMATOD 8C 8 SCLDDL_SRMATOD2 94 8 SCLDDL_VMAPRCAL 128 80 SCLDDL_VMATTIME_PRO F4 8 SCLDDL_VMATTMP_PRO 10C 8 SCLDDL_VMATTMS_PRO 11C 8 SCLDDL_VMAVTIME_PRO FC 8 SCLDDL_VMAVTMP_PRO 104 8 SCLDDL_VMAVTMS_PRO 114 8 SCLDDL_VMDABSSH 80 4 SCLDDL_VMDAFSUP A1 80 SCLDDL_VMDAUTOL 6E 02 SCLDDL_VMDCFGEM A0 1 SCLDDL_VMDCFWT 6C 40 SCLDDL_VMDCPUAD 76 2 SCLDDL_VMDCPUAF A0 40 SCLDDL_VMDCTCRT 78 4 SCLDDL_VMDCTPVG 9C 4 SCLDDL_VMDCTPVR 34 4 SCLDDL_VMDDISC 6E 04 SCLDDL_VMDDPRTY 48 8 SCLDDL_VMDFORCE 6E 10 SCLDDL_VMDHOTRQ 75 80 SCLDDL_VMDHOTST 75 40 SCLDDL_VMDIABIA 75 10 SCLDDL_VMDIOWT 6C 10 SCLDDL_VMDLIMTH 84 02 SCLDDL_VMDLKSHT 75 04 SCLDDL_VMDLOADU 75 20 SCLDDL_VMDLRGST 27 80 SCLDDL_VMDMXSHA 84 80 SCLDDL_VMDMXSHR 88 4 SCLDDL_VMDNULL 75 01 SCLDDL_VMDOPRTY 50 8 SCLDDL_VMDPGRTE 2C 4 SCLDDL_VMDPUST A1 1 SCLDDL_VMDRDYCM 26 0 SCLDDL_VMDRELSH 7C 4 SCLDDL_VMDRPLIM 30 4 SCLDDL_VMDRTHRU 58 4 SCLDDL_VMDSACTL 6F 1 SCLDDL_VMDSACTX 74 1 SCLDDL_VMDSIMWT 6C 20 SCLDDL_VMDSLCNT 86 2 SCLDDL_VMDSTATE 6D 1 SCLDDL_VMDSVMID 1C 8 SCLDDL_VMDSVMWF 24 80 SCLDDL_VMDSVMWF 25 80 SCLDDL_VMDSVMWF 26 80 SCLDDL_VMDSVMWT 24 1 SCLDDL_VMDSVMWT 25 1 SCLDDL_VMDSVMWT 26 1 SCLDDL_VMDSVMW2 25 0 SCLDDL_VMDSYSOP 6E 80 SCLDDL_VMDTTIME 40 8 SCLDDL_VMDTTIME_MT1 C4 8 SCLDDL_VMDTTMP AC 8 SCLDDL_VMDTTMP_MT1 DC 8 SCLDDL_VMDTTMS BC 8 SCLDDL_VMDTTMS_MT1 EC 8 SCLDDL_VMDUFORC 6E 08 SCLDDL_VMDUSER 14 8 SCLDDL_VMDUSRCT 6E 40 SCLDDL_VMDVTIME 38 8 SCLDDL_VMDVTIME_MT1 CC 8 SCLDDL_VMDVTMP A4 8 SCLDDL_VMDVTMP_MT1 D4 8 SCLDDL_VMDVTMS B4 8 SCLDDL_VMDVTMS_MT1 E4 8 SCLDDL_VMDWSSPR 28 4 SCLDDL_VMDXAUTO 6E 01
This information is based on z/VM V6R4.0.
Last updated on 4 Oct 2016 at 15:27:51.
Copyright IBM Corporation, 1990, 2016