|
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 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 V5R1.0.
Last updated on 13 Sep 2004 at 11:25:22.
Copyright IBM Corporation, 1990, 2004