|
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 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 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 V6R2.0.
Last updated on 23 Nov 2011 at 15:33:04.
Copyright IBM Corporation, 1990, 2011