|
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
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 196 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 Cumulative count of the
total number of resident
frames found referenced
during reorders for this
virtual system.
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'2C' = 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 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.
128 80 Unsigned 4 SCLDDL_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.
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 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 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.
Applies to real primary
processor on which user is
dispatched.
148 94 Character 8 SCLDDL_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.
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 Bitstring 1 SCLDDL_VMDCFGEM Virtual configuration
indicators. Valid in base
VMDBK only
1... .... *
.1.. .... SCLDDL_VMDCPUAF User requested CPU
Affinity
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
161 A1 Bitstring 1 SCLDDL_VMDPUST CPU Status flag
1... .... SCLDDL_VMDAFSUP CPU Affinity suppressed
.1.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
162 A2 Character 2 * Reserved for IBM use
164 A4 Character 8 SCLDDL_VMDVTMP Total virtual time for user
on primary processor
172 AC Character 8 SCLDDL_VMDTTMP Total virtual and
simulation time for the user
on primary processor
180 B4 Character 8 SCLDDL_VMDVTMS Total virtual time for user
on secondary processor
188 BC Character 8 SCLDDL_VMDTTMS Total virtual and
simulation time for the user
on secondary processor
196 C4 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 196
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 C4 0
SCLDDL_MRHDR 0 0
SCLDDL_SRMATOD 8C 8
SCLDDL_SRMATOD2 94 8
SCLDDL_VMDABSSH 80 4
SCLDDL_VMDAFSUP A1 80
SCLDDL_VMDAUTOL 6E 02
SCLDDL_VMDCFGEM A0 1
SCLDDL_VMDCFWT 6C 40
SCLDDL_VMDCPUAD 76 2
SCLDDL_VMDCPUAF A0 40
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_VMDPUST A1 1
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_VMDTTMP AC 8
SCLDDL_VMDTTMS BC 8
SCLDDL_VMDUFORC 6E 08
SCLDDL_VMDUSER 14 8
SCLDDL_VMDUSRCT 6E 40
SCLDDL_VMDVTIME 38 8
SCLDDL_VMDVTMP A4 8
SCLDDL_VMDVTMS B4 8
SCLDDL_VMDWSSPR 28 4
SCLDDL_VMDXAUTO 6E 01
This information is
based on z/VM V6R2.0.
Last updated on 23 Nov 2011 at 15:33:04.
Copyright IBM Corporation, 1990, 2011