|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRSCLDDL
PrologControl Block Contents
Storage Layout
Cross Reference
MRSCLDDL Prolog
DSECT NAME - SCLDDL
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRSCLDDL
DESCRIPTIVE NAME - Monitor Event Record
Domain 2 - Scheduler Domain
Record 5 - Drop User From Dispatch List
DESCRIPTION - Indicates conditions after this user has been
dropped from the dispatch list. A separate
record is generated for each VMDBK in the
virtual MP complex.
MRSCLDDL Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 160 SCLDDL Start of monitor record
0 0 Character 0 SCLDDL_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 SCLDDL_VMDUSER Userid
28 1C Character 8 SCLDDL_VMDSVMID VMDBK name for the last
successful IUCV, VMCF or APPC/VM
Send for this virtual machine.
Valid in base VMDBK only.
36 24 Bitstring 1 SCLDDL_VMDSVMWT Service-virtual-machine (SVM)
wait flag - valid in base VMDBK
only.
1... .... SCLDDL_VMDSVMWF VMDBK is waiting for a response
from IUCV, VMCF, or APPC.
.1.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
37 25 Character 0 SCLDDL_VMDSVMW2 back-up byte to the VMDSVMWT
byte. Copied here so that they
will persist longer than they
would in VMDSVMWT. Valid in base
VMDBK only.
37 25 Bitstring 1 SCLDDL_VMDSVMWT Service-virtual-machine (SVM)
wait flag - valid in base VMDBK
only.
1... .... SCLDDL_VMDSVMWF VMDBK is waiting for a response
from IUCV, VMCF, or APPC.
38 26 Character 0 SCLDDL_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.
38 26 Bitstring 1 SCLDDL_VMDSVMWT Service-virtual-machine (SVM)
wait flag - valid in base VMDBK
only.
1... .... SCLDDL_VMDSVMWF VMDBK is waiting for a response
from IUCV, VMCF, or APPC.
39 27 Bitstring 1 SCLDDL_CALFLAG1 Flag Byte 1
1... .... SCLDDL_VMDLRGST User was preemptied due to its
large storage requirement
.1.. .... SCLDDL_CALBASE If on, this is the base VMDBK.
VMDBASE
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
40 28 Unsigned 4 SCLDDL_VMDWSSPR This user's projected working
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.
44 2C Unsigned 4 SCLDDL_VMDPGRTE Number of pages per second which
this user read in during its last
stay in the dispatch list.
48 30 Unsigned 4 SCLDDL_VMDRPLIM Resident page growth limit
52 34 Unsigned 4 SCLDDL_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 SCLDDL_VMDCTPVG from
SCLDDL_VMDCTPVR.
56 38 Character 8 SCLDDL_VMDVTIME The total time that this user
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
SCLDDL_VMDVTIME is the elapsed
time in TOD clock units.
64 40 Character 8 SCLDDL_VMDTTIME The 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
SCLDDL_VMDTTIME is the elapsed
time in TOD clock units.
72 48 Character 8 SCLDDL_VMDDPRTY The user's dispatch list
priority. This is based on 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.
80 50 Character 8 SCLDDL_VMDOPRTY The user's dispatch priority
before adjustment for factors such
as interactive bias and paging
bias
88 58 Unsigned 4 SCLDDL_VMDRTHRU This user's 'required
throughput' or 'resource access'
in the dispatch list. This is the
amount of time while the user is
in the dispatch list that it
should be offered access to system
resources, considering its SHARE
and the time it spent in the
eligible list.
92 5C Unsigned 4 SCLDDL_VMDCTXBK Number of Expanded Storage
blocks allocated to a virtual
machine by CP for paging
96 60 Unsigned 4 SCLDDL_VMDFLREO Number of frame list reorders
for this virtual system's list of
frames
100 64 Unsigned 4 SCLDDL_VMDCTORF Total number of referenced
frames resident when reset was
done for this virtual system or
shared frame list resident frames.
104 68 Unsigned 4 SCLDDL_CALCPPST Cumulative count of pages stolen
from this user's address spaces
while they were private.
108 6C Bitstring 1 SCLDDL_CALRSTAT Reason(s) the dispatched VMDBK
is not being run
1... .... *
.1.. .... SCLDDL_VMDCFWT VMDBK is in console function
wait. Either a console function is
active, or the virtual machine is
waiting for the remaining VMDBKs
in the configuration to enter
console function mode.
..1. .... SCLDDL_VMDSIMWT CP is simulating some hardware
function for the guest such as
instructions, interrupts, and
timer updates. Virtual machine is
prevented from running to avoid
potential conflicts with the
simulations.
...1 .... SCLDDL_VMDIOWT Instruction waiting for I/O
status for completion. (May be
cancelled without loss of system
integrity.)
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
109 6D Bitstring 1 SCLDDL_VMDSTATE Scheduler/Dispatcher State.
X'63' = Review-suspended. VMDBK is
in transition to the suspended
state. X'58' = Review-idle. VMDBK
is in transition to the idle
state. X'4D' = VMDBK has been
selected by dispatcher for
processing. X'42' = VMDBK is ready
for selection by dispatcher once
it goes to the dispatch list.
X'37' = Test-idle. VMDBK is ready
for selection by the dispatcher
but should be dropped from the
dispatch list when selected the
next time. X'08' = VMDBK is
suspended, probably waiting for a
short-term event to occur. X'00' =
VMDBK is idle. No work is
available.
110 6E Bitstring 1 SCLDDL_CALOSTAT Virtual machine operating status
1... .... SCLDDL_VMDSYSOP User is primary system operator
.1.. .... SCLDDL_VMDUSRCT User is counted as being logged
on
..1. .... *
...1 .... SCLDDL_VMDFORCE User is to be logged off. This
may be requested by CP, a forced
logoff, or user's logoff command.
.... 1... SCLDDL_VMDUFORC User is forced to logoff the
system
.... .1.. SCLDDL_VMDDISC User is running disconnected
.... ..1. SCLDDL_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 SCLDDL_VMDXAUTO The original command was
XAUTOLOG. Valid for the base VMDBK
only.
111 6F Bitstring 1 SCLDDL_VMDSACTL Dispatch list control bits.
These are used to signal the
dispatcher that the currently
dispatched user requires scheduler
intervention, either due to having
reached a resource consumption
limit or some other reason. At
dispatch list drop time, these
bits can indicate why the user was
dropped.
112 70 Unsigned 4 SCLDDL_VMDCWSS This user's core working set
size.
116 74 Unsigned 1 SCLDDL_VMDSACTX An extension byte to VMDSACTL.
It describes additional reasons
why the user required scheduler
intervention, given that the
'other resources' bit is on in
VMDSACTL.
117 75 Bitstring 1 SCLDDL_CALQSTAT Scheduling status of user
1... .... SCLDDL_VMDHOTRQ Hot Shot scheduling requested
.1.. .... SCLDDL_VMDHOTST Hot Shot user scheduling granted
..1. .... SCLDDL_VMDLOADU Loading user designation
...1 .... SCLDDL_VMDIABIA Interactive bias is in effect
.... 1... SCLDDL_VMDPGBIA Paging bias is in effect
.... .1.. SCLDDL_VMDLKSHT "Lockshot" scheduling in effect
for this user. Set only in the
base VMDBK.
.... ..1. *
.... ...1 SCLDDL_VMDNULL User is logging off
118 76 Unsigned 2 SCLDDL_VMDCPUAD Virtual processor address
120 78 Unsigned 4 SCLDDL_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.
124 7C Unsigned 4 SCLDDL_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 if
this VMDBK has a virtual processor
dedicated to it, and the user is a
virtual MP user. Set to a negative
value if VMDBK has a virtual
processor dedicated to it, and the
user is a virtual UP user.
128 80 Unsigned 4 SCLDDL_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.
132 84 Bitstring 1 SCLDDL_CALSHARF Set Share flags
1... .... SCLDDL_VMDMXSHA Max share is Absolute if ON. Max
share is Relative if OFF.
.1.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. SCLDDL_VMDLIMTH Max share is Limithard if ON.
Max share is Limitsoft if OFF.
.... ...1 *
133 85 Unsigned 1 * Reserved and available for IBM
use.
134 86 Signed 2 SCLDDL_VMDSLCNT Count of minor time slices that
have expired since the start of
current transaction.
136 88 Unsigned 4 SCLDDL_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 SCLDDL_VMDMXSHA to determine
if Max share is absolute or
relative.
140 8C Character 8 SCLDDL_SRMATOD Artificial TOD. This TOD only
advances at the rate the system is
running user work.
148 94 Character 8 SCLDDL_SRMATOD2 Artificial TOD2. This TOD only
advances with each CPU's user time
and each CPU's wait time.
156 9C Unsigned 4 SCLDDL_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 SCLDDL_VMDCTPVR.
160 A0 Character 0 SCLDDL_END
MRSCLDDL 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
SCLDDL 0 160
SCLDDL_CALBASE 27 40
SCLDDL_CALCPPST 68 4
SCLDDL_CALFLAG1 27 1
SCLDDL_CALOSTAT 6E 1
SCLDDL_CALQSTAT 75 1
SCLDDL_CALRSTAT 6C 1
SCLDDL_CALSHARF 84 1
SCLDDL_END A0 0
SCLDDL_MRHDR 0 0
SCLDDL_SRMATOD 8C 8
SCLDDL_SRMATOD2 94 8
SCLDDL_VMDABSSH 80 4
SCLDDL_VMDAUTOL 6E 02
SCLDDL_VMDCFWT 6C 40
SCLDDL_VMDCPUAD 76 2
SCLDDL_VMDCTCRT 78 4
SCLDDL_VMDCTORF 64 4
SCLDDL_VMDCTPVG 9C 4
SCLDDL_VMDCTPVR 34 4
SCLDDL_VMDCTXBK 5C 4
SCLDDL_VMDCWSS 70 4
SCLDDL_VMDDISC 6E 04
SCLDDL_VMDDPRTY 48 8
SCLDDL_VMDFLREO 60 4
SCLDDL_VMDFORCE 6E 10
SCLDDL_VMDHOTRQ 75 80
SCLDDL_VMDHOTST 75 40
SCLDDL_VMDIABIA 75 10
SCLDDL_VMDIOWT 6C 10
SCLDDL_VMDLIMTH 84 02
SCLDDL_VMDLKSHT 75 04
SCLDDL_VMDLOADU 75 20
SCLDDL_VMDLRGST 27 80
SCLDDL_VMDMXSHA 84 80
SCLDDL_VMDMXSHR 88 4
SCLDDL_VMDNULL 75 01
SCLDDL_VMDOPRTY 50 8
SCLDDL_VMDPGBIA 75 08
SCLDDL_VMDPGRTE 2C 4
SCLDDL_VMDRDYCM 26 0
SCLDDL_VMDRELSH 7C 4
SCLDDL_VMDRPLIM 30 4
SCLDDL_VMDRTHRU 58 4
SCLDDL_VMDSACTL 6F 1
SCLDDL_VMDSACTX 74 1
SCLDDL_VMDSIMWT 6C 20
SCLDDL_VMDSLCNT 86 2
SCLDDL_VMDSTATE 6D 1
SCLDDL_VMDSVMID 1C 8
SCLDDL_VMDSVMWF 24 80
SCLDDL_VMDSVMWF 25 80
SCLDDL_VMDSVMWF 26 80
SCLDDL_VMDSVMWT 24 1
SCLDDL_VMDSVMWT 25 1
SCLDDL_VMDSVMWT 26 1
SCLDDL_VMDSVMW2 25 0
SCLDDL_VMDSYSOP 6E 80
SCLDDL_VMDTTIME 40 8
SCLDDL_VMDUFORC 6E 08
SCLDDL_VMDUSER 14 8
SCLDDL_VMDUSRCT 6E 40
SCLDDL_VMDVTIME 38 8
SCLDDL_VMDWSSPR 28 4
SCLDDL_VMDXAUTO 6E 01
This information is
based on z/VM V4R2.0.
Last updated on 15 Oct 2001 at 08:04:23.
Copyright IBM Corporation, 1990, 2001