|
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 Cumulative count of the
total number of resident
frames found referenced
during reorders 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 V6R2.0.
Last updated on 23 Nov 2011 at 15:33:04.
Copyright IBM Corporation, 1990, 2011