|
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
Storage Layout
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 196 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 user's RELATIVE share of
the system, as set in the user's
directory or via the SET SHARE
command. Set to zero if the user
is an ABSOLUTE share user, or this
VMDBK has a virtual processor
dedicated to it and the user is a
virtual MP user. Set to a negative
value if this VMDBK has a virtual
processor dedicated to it, and
this is a virtual UP user.
152 98 Unsigned 4 SCLADL_VMDABSSH This user'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 if
user is a RELATIVE share user.
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.
164 A4 Signed 4 SCLADL_SRMRELDL Cardinal count of total relative
shares of all VMDBKs in the
dispatch list.
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 user'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.
184 B8 Character 8 SCLADL_SRMATOD2 Artificial TOD2. This TOD only
advances with each CPU's user time
and each CPU's wait time.
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 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 196
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 C4 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_VMDAUTOL 88 02
SCLADL_VMDCPUAD 42 2
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_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_VMDUFORC 88 08
SCLADL_VMDUSER 14 8
SCLADL_VMDUSRCT 88 40
SCLADL_VMDVTIME 4C 8
SCLADL_VMDVUSCT 9C 4
SCLADL_VMDWSSPR 38 4
SCLADL_VMDXAUTO 88 01
This information is
based on z/VM V4R3.0.
Last updated on 1 May 2002 at 16:20:33.
Copyright IBM Corporation, 1990, 2002