Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRSCLALL
PrologControl Block Contents
Cross Reference
MRSCLALL Prolog
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 Sample 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.
MRSCLALL Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 220 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 record length in bytes 2 2 Unsigned 2 MRHDRZER field of zeros 4 4 Unsigned 1 MRHDRDM domain identifier 5 5 Unsigned 1 * 6 6 Unsigned 2 MRHDRRC record identifier 8 8 Character 8 MRHDRTOD Time at which this record was built. In time-of-day (TOD) clock format. See IBM System 370 XA Principle of Operation for explanation of format. 16 10 Character 4 * 20 14 Character 0 MRHDR_END End of header 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 Eligible list class 42 2A Bitstring 1 * Reserved for IBM use 43 2B Bitstring 1 * Reserved for IBM use 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 time that this user was 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 elapsed time in TOD clock units. 64 40 Character 8 SCLALL_VMDTTIME Total 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 virtual and simulation time while running on a primary 136 88 Character 8 SCLALL_VMDVTMP Total virtual time while running on a primary 144 90 Character 8 SCLALL_VMDTTMS Total virtual and simulation time while running on a secondary 152 98 Character 8 SCLALL_VMDVTMS Total virtual time while running on a secondary 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 SCLALL_SRXCTHRU Sums of the VMDRTHRU values for all the compute-bound VMDBKs in the dispatch list 212 D4 Character 4 SCLALL_SRXCTHRN Total VMDRTHRU of all the compute-bound VMDBKs not hitting max-SHARE 216 D8 Character 4 SCLALL_SRXCTHRL Total VMDRTHRU of all the compute-bound VMDBKs hitting max-SHARE 220 DC 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 220 SCLALL_ALLBASE 1E 80 SCLALL_ALLFLAG 1E 1 SCLALL_CALMRHDR 0 0 SCLALL_END DC 0 SCLALL_SRMCONLL A8 4 SCLALL_SRXABSDL C8 4 SCLALL_SRXATOD B0 8 SCLALL_SRXATOD2 B8 8 SCLALL_SRXCONLL C0 4 SCLALL_SRXCTHRL D8 4 SCLALL_SRXCTHRN D4 4 SCLALL_SRXCTHRU D4 8 SCLALL_SRXRELDL C4 4 SCLALL_SRXRTHRL D0 4 SCLALL_SRXRTHRN CC 4 SCLALL_SRXRTHRU CC 8 SCLALL_SRXTOTLS C4 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_VMDTTMP 80 8 SCLALL_VMDTTMS 90 8 SCLALL_VMDUSER 14 8 SCLALL_VMDVTIME 38 8 SCLALL_VMDVTMP 88 8 SCLALL_VMDVTMS 98 8
This information is based on z/VM V5R4.0.
Last updated on 5 Sep 2008 at 09:11:41.
Copyright IBM Corporation, 1990, 2008