|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRSCLADL
PrologControl Block Contents
Cross Reference
MRSCLADL Prolog
DSECT NAME - SCLADL
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRSCLADL
DESCRIPTIVE NAME - Monitor Event Record
Domain 2 - Scheduler Domain
Record 4 - Add User To Dispatch List
DESCRIPTION - Indicates conditions after user has been added to
dispatch list. A separate record is generated for
each VMDBK in the virtual machine MP complex.
MRSCLADL Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 232 SCLADL Start of monitor record
0 0 Character 0 SCLADL_MRHDR 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 SCLADL_VMDUSER Userid
28 1C Unsigned 4 SCLADL_SRMTOTST Memory available to the
scheduler to assign to users as
they enter the dispatch list
32 20 Unsigned 4 SCLADL_SRMWSSDL Accumulated count of all
dispatch list users' working
set sizes. This is an
instantaneous (not a smoothed)
value.
36 24 Unsigned 2 SCLADL_SRMCDISP Cardinal count of users in
the dispatch list.
38 26 Unsigned 2 SCLADL_SRMC1DSP Cardinal count of short,
medium, and long running users
in the dispatch list.
40 28 Unsigned 2 SCLADL_SRMC2DSP Cardinal count of medium and
long running users in the
dispatch list. This includes
all Q2 and Q3 users. It
includes no Q1 or Q0 users.
42 2A Unsigned 2 SCLADL_SRMC3DSP Cardinal count of long
running users in the dispatch
list. It includes all Q3 users.
It includes no Q1, Q2, or Q0
users.
44 2C Character 8 SCLADL_VMDSVMID VMDBK name for the last
successful IUCV, VMCF or
APPC/VM Send for this virtual
machine. Valid in base VMDBK
only.
52 34 Bitstring 1 SCLADL_VMDSVMWT Service-virtual-machine (SVM)
wait flag - valid in base VMDBK
only.
1... .... SCLADL_VMDSVMWF VMDBK is waiting for a
response from IUCV, VMCF or
APPC.
.1.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
53 35 Character 0 SCLADL_VMDSVMW2 back-up byte to the VMDSVMWT
byte. Its contents will persist
longer than they would in
VMDSVMWT. Valid in base VMDBK
only.
53 35 Bitstring 1 SCLADL_VMDSVMWT Service-virtual-machine (SVM)
wait flag - valid in base VMDBK
only.
1... .... SCLADL_VMDSVMWF VMDBK is waiting for a
response from IUCV, VMCF or
APPC.
54 36 Character 0 SCLADL_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.
54 36 Bitstring 1 SCLADL_VMDSVMWT Service-virtual-machine (SVM)
wait flag - valid in base VMDBK
only.
1... .... SCLADL_VMDSVMWF VMDBK is waiting for a
response from IUCV, VMCF or
APPC.
55 37 Bitstring 1 SCLADL_CALFLAG1 Flag byte
1... .... SCLADL_CALBASE If on, this is base VMDBK.
VMDBASE
.1.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
56 38 Unsigned 4 SCLADL_VMDWSSPR This user's projected 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.
60 3C Unsigned 4 SCLADL_VMDPGRTE Number of pages per second
which this user read in during
its last stay in the dispatch
list
64 40 Bitstring 1 SCLADL_CALQSTAT Scheduling status of user
1... .... SCLADL_VMDHOTRQ Hot Shot scheduling requested
.1.. .... SCLADL_VMDHOTST Hot Shot user scheduling
granted
..1. .... SCLADL_VMDLOADU Loading user designation
...1 .... SCLADL_VMDIABIA Interactive bias is in effect
.... 1... SCLADL_VMDPGBIA Paging bias is in effect
.... .1.. SCLADL_VMDLKSHT "Lockshot" scheduling in
effect for this user. Set only
in the base VMDBK.
.... ..1. *
.... ...1 SCLADL_VMDNULL User is logging off
65 41 Unsigned 1 SCLADL_VMDELIST This user's dispatch list
class. It can be 0, 1, 2, or 3.
Class 1-3 relate to the time
this (scheduler determined)
transaction has been running.
Class 1 are short-running,
class 2, medium-running and
class 3, long-running.
66 42 Unsigned 2 SCLADL_VMDCPUAD Virtual processor address
68 44 Unsigned 4 SCLADL_VMDRPLIM Resident page growth limit
72 48 Unsigned 4 SCLADL_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 SCLADL_VMDCTPVG from
SCLADL_VMDCTPVR.
76 4C Character 8 SCLADL_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 SCLADL_VMDVTIME
is the elapsed time in TOD
clock units.
84 54 Character 8 SCLADL_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 SCLADL_VMDTTIME
is the elapsed time in TOD
clock units.
92 5C Character 8 SCLADL_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.
100 64 Character 8 SCLADL_VMDDPRTY The user'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.
108 6C Character 8 SCLADL_VMDOPRTY This user's dispatch priority
before adjustment factors such
as interactive bias and paging
bias
116 74 Unsigned 4 SCLADL_VMDRTHRU This user's 'required
throughput' or 'resource
access' in the dispatch list
120 78 Unsigned 4 SCLADL_VMDCTXBK Number of Expanded Storage
blocks allocated to a virtual
machine by CP for paging
124 7C Unsigned 4 SCLADL_VMDFLREO Number of frame list reorders
for this virtual system's list
of frames
128 80 Unsigned 4 SCLADL_VMDCTORF Total number of referenced
frames resident when reset was
done for this virtual system
132 84 Unsigned 4 SCLADL_CALCPPST Cumulative count of pages
stolen from this user's address
spaces while they were private.
136 88 Bitstring 1 SCLADL_CALOSTAT Virtual machine operating
status
1... .... SCLADL_VMDSYSOP User is primary system
operator
.1.. .... SCLADL_VMDUSRCT User is counted as being
logged on
..1. .... *
...1 .... SCLADL_VMDFORCE User is to be logged off.
This may be requested by CP, a
forced logoff, or user's logoff
command.
.... 1... SCLADL_VMDUFORC User is forced to logoff the
system
.... .1.. SCLADL_VMDDISC User is running disconnected
.... ..1. SCLADL_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 SCLADL_VMDXAUTO The original command was
XAUTOLOG. Valid for the base
VMDBK only.
137 89 Bitstring 1 SCLADL_CALSHARF Set Share flags
1... .... SCLADL_VMDMXSHA Max share is Absolute if ON.
Max share is Relative if OFF.
.1.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. SCLADL_VMDLIMTH Max Share is Limithard if ON.
Max Share is Limitsoft if OFF.
.... ...1 *
138 8A Signed 2 SCLADL_VMDSLCNT Count of minor time slices
that have expired since the
start of current transaction.
140 8C Character 8 SCLADL_VMDESLIC The elapsed time slice this
user will receive in the
dispatch list before having to
return to the eligible list.
148 94 Unsigned 4 SCLADL_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.
152 98 Unsigned 4 SCLADL_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.
156 9C Unsigned 4 SCLADL_VMDVUSCT Count of start requests to
virtual unit record devices
160 A0 Signed 4 SCLADL_SRMABSDL Cardinal count of total
absolute shares of all VMDBKs
in the dispatch list. The unit
of value is the same as
SCLADL_VMDABSSH. Applies to
real primary processor on which
user is dispatched.
164 A4 Signed 4 SCLADL_SRMRELDL Cardinal count of total
relative shares of all VMDBKs
in the dispatch list. Applies
to real primary processor on
which user is dispatched.
168 A8 Unsigned 4 SCLADL_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.
172 AC Unsigned 4 SCLADL_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 SCLADL_VMDMXSHA to
determine if Max share is
absolute or relative.
176 B0 Character 8 SCLADL_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.
184 B8 Character 8 SCLADL_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.
192 C0 Unsigned 4 SCLADL_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 SCLADL_VMDCTPVR.
196 C4 Bitstring 1 SCLADL_VMDCFGEM Virtual configuration
indicators. Valid in base VMDBK
only
1... .... *
.1.. .... SCLADL_VMDCPUAF User requested CPU Affinity
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
197 C5 Bitstring 1 SCLADL_VMDPUST CPU Status flag
1... .... SCLADL_VMDAFSUP CPU Affinity suppressed
.1.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
198 C6 Character 2 * Reserved for IBM use
200 C8 Character 8 SCLADL_VMDVTMP Total virtual time for user
on primary processor
208 D0 Character 8 SCLADL_VMDTTMP Total virtual and simulation
time for the user on primary
processor
216 D8 Character 8 SCLADL_VMDVTMS Total virtual time for user
on secondary processor
224 E0 Character 8 SCLADL_VMDTTMS Total virtual and simulation
time for the user on secondary
processor
232 E8 Character 0 SCLADL_END
MRSCLADL 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
SCLADL 0 232
SCLADL_CALBASE 37 80
SCLADL_CALCPPST 84 4
SCLADL_CALFLAG1 37 1
SCLADL_CALOSTAT 88 1
SCLADL_CALQSTAT 40 1
SCLADL_CALSHARF 89 1
SCLADL_END E8 0
SCLADL_MRHDR 0 0
SCLADL_SRMABSDL A0 4
SCLADL_SRMATOD B0 8
SCLADL_SRMATOD2 B8 8
SCLADL_SRMCDISP 24 2
SCLADL_SRMC1DSP 26 2
SCLADL_SRMC2DSP 28 2
SCLADL_SRMC3DSP 2A 2
SCLADL_SRMRELDL A4 4
SCLADL_SRMTOTST 1C 4
SCLADL_SRMWSSDL 20 4
SCLADL_VMDABSSH 98 4
SCLADL_VMDAFSUP C5 80
SCLADL_VMDAUTOL 88 02
SCLADL_VMDCFGEM C4 1
SCLADL_VMDCPUAD 42 2
SCLADL_VMDCPUAF C4 40
SCLADL_VMDCTCRT A8 4
SCLADL_VMDCTORF 80 4
SCLADL_VMDCTPVG C0 4
SCLADL_VMDCTPVR 48 4
SCLADL_VMDCTXBK 78 4
SCLADL_VMDDISC 88 04
SCLADL_VMDDPRTY 64 8
SCLADL_VMDELIST 41 1
SCLADL_VMDEPRTY 5C 8
SCLADL_VMDESLIC 8C 8
SCLADL_VMDFLREO 7C 4
SCLADL_VMDFORCE 88 10
SCLADL_VMDHOTRQ 40 80
SCLADL_VMDHOTST 40 40
SCLADL_VMDIABIA 40 10
SCLADL_VMDLIMTH 89 02
SCLADL_VMDLKSHT 40 04
SCLADL_VMDLOADU 40 20
SCLADL_VMDMXSHA 89 80
SCLADL_VMDMXSHR AC 4
SCLADL_VMDNULL 40 01
SCLADL_VMDOPRTY 6C 8
SCLADL_VMDPGBIA 40 08
SCLADL_VMDPGRTE 3C 4
SCLADL_VMDPUST C5 1
SCLADL_VMDRDYCM 36 0
SCLADL_VMDRELSH 94 4
SCLADL_VMDRPLIM 44 4
SCLADL_VMDRTHRU 74 4
SCLADL_VMDSLCNT 8A 2
SCLADL_VMDSVMID 2C 8
SCLADL_VMDSVMWF 34 80
SCLADL_VMDSVMWF 35 80
SCLADL_VMDSVMWF 36 80
SCLADL_VMDSVMWT 34 1
SCLADL_VMDSVMWT 35 1
SCLADL_VMDSVMWT 36 1
SCLADL_VMDSVMW2 35 0
SCLADL_VMDSYSOP 88 80
SCLADL_VMDTTIME 54 8
SCLADL_VMDTTMP D0 8
SCLADL_VMDTTMS E0 8
SCLADL_VMDUFORC 88 08
SCLADL_VMDUSER 14 8
SCLADL_VMDUSRCT 88 40
SCLADL_VMDVTIME 4C 8
SCLADL_VMDVTMP C8 8
SCLADL_VMDVTMS D8 8
SCLADL_VMDVUSCT 9C 4
SCLADL_VMDWSSPR 38 4
SCLADL_VMDXAUTO 88 01
This information is
based on z/VM V5R4.0.
Last updated on 5 Sep 2008 at 09:11:41.
Copyright IBM Corporation, 1990, 2008