|
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 V6R1.0.
Last updated on 8 Oct 2009 at 21:08:13.
Copyright IBM Corporation, 1990, 2009