|
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 Sample 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.
MRSCLDLL Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 220 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 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 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 Eligible list class
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 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 SCLDLL_VMDVTIME
is the elapsed time in TOD
clock units.
64 40 Character 8 SCLDLL_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 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 virtual and simulation
time while running on a primary
136 88 Character 8 SCLDLL_VMDVTMP Total virtual time while
running on a primary
144 90 Character 8 SCLDLL_VMDTTMS Total virtual and simulation
time while running on a
secondary
152 98 Character 8 SCLDLL_VMDVTMS Total virtual time while
running on a secondary
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 SCLDLL_SRXCTHRU Sums of the VMDRTHRU values
for all the compute-bound
VMDBKs in the dispatch list
212 D4 Character 4 SCLDLL_SRXCTHRN Total VMDRTHRU of all the
compute-bound VMDBKs not
hitting max-SHARE
216 D8 Character 4 SCLDLL_SRXCTHRL Total VMDRTHRU of all the
compute-bound VMDBKs hitting
max-SHARE
220 DC 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 220
SCLDLL_CALMRHDR 0 0
SCLDLL_DLLBASE 1E 80
SCLDLL_DLLFLAG 1E 1
SCLDLL_END DC 0
SCLDLL_SRMCONLL A8 4
SCLDLL_SRXABSDL C8 4
SCLDLL_SRXATOD B0 8
SCLDLL_SRXATOD2 B8 8
SCLDLL_SRXCONLL C0 4
SCLDLL_SRXCTHRL D8 4
SCLDLL_SRXCTHRN D4 4
SCLDLL_SRXCTHRU D4 8
SCLDLL_SRXRELDL C4 4
SCLDLL_SRXRTHRL D0 4
SCLDLL_SRXRTHRN CC 4
SCLDLL_SRXRTHRU CC 8
SCLDLL_SRXTOTLS C4 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_VMDTTMP 80 8
SCLDLL_VMDTTMS 90 8
SCLDLL_VMDUSER 14 8
SCLDLL_VMDVTIME 38 8
SCLDLL_VMDVTMP 88 8
SCLDLL_VMDVTMS 98 8
This information is
based on z/VM V6R1.0.
Last updated on 8 Oct 2009 at 21:08:13.
Copyright IBM Corporation, 1990, 2009