|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRSCLAEL
PrologControl Block Contents
Storage Layout
Cross Reference
MRSCLAEL Prolog
DSECT NAME - SCLAEL
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRSCLAEL
DESCRIPTIVE NAME - Monitor Event Record
Domain 2 - Scheduler
Record 6 - Add User To Eligible List
DESCRIPTION - Indicates conditions after this user has been
added to the eligible list. A separate
record is generated for each VMDBK in the
virtual MP complex.
MRSCLAEL Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 132 SCLAEL Start of monitor record
0 0 Character 0 SCLAEL_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 SCLAEL_VMDUSER Userid
28 1C Unsigned 2 SCLAEL_SRMC1ELG Cardinal count of short, medium
and long-running users in the
eligible list. This includes all
E1, E2 and E3 users. It includes
no E0 users.
30 1E Unsigned 2 SCLAEL_SRMC2ELG Cardinal count of short, medium
and long-running users in the
eligible list. This includes all
E2 and E3 users. It includes no E0
or E1 users.
32 20 Unsigned 2 SCLAEL_SRMC3ELG Cardinal count of short, medium
and long-running users in the
eligible list. This includes all
E3 users. It includes no no E0,
E1, or E2 users.
34 22 Unsigned 2 SCLAEL_VMDCPUAD Virtual processor address
36 24 Character 8 SCLAEL_VMDSVMID VMDBK name for the last
successful IUCV, VMCF or APPC/VM
Send for this virtual machine.
Valid in base VMDBK only.
44 2C Bitstring 1 SCLAEL_VMDSVMWT Service-virtual-machine (SVM)
wait flag byte - valid in base
VMDBK only.
1... .... SCLAEL_VMDSVMWF VMDBK is waiting for a response
from IUCV, VMCF or APPC.
.1.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
45 2D Character 0 SCLAEL_VMDSVMW2 Back-up byte to the VMDSVMWT
byte. Its contents will persist
longer than they would in
VMDSVMWT. Valid in base VMDBK
only.
45 2D Bitstring 1 SCLAEL_VMDSVMWT Service-virtual-machine (SVM)
wait flag byte - valid in base
VMDBK only.
1... .... SCLAEL_VMDSVMWF VMDBK is waiting for a response
from IUCV, VMCF or APPC.
46 2E Character 0 SCLAEL_VMDRDYCM Flag byte set by IUCV, VMCF, or
APPC whenever IUCV/VMCF/APPC makes
an external interrupt. It is sort
of a "reference byte" that tells
the scheduler that IUCV/VMCF/APPC
had been active recently. Valid in
base VMDBK only.
46 2E Bitstring 1 SCLAEL_VMDSVMWT Service-virtual-machine (SVM)
wait flag byte - valid in base
VMDBK only.
1... .... SCLAEL_VMDSVMWF VMDBK is waiting for a response
from IUCV, VMCF or APPC.
47 2F Bitstring 1 SCLAEL_CALFLAG1 Flag byte
1... .... SCLAEL_CALBASE If on, this is the base VMDBK.
VMDBASE
.1.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
48 30 Unsigned 4 SCLAEL_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.
52 34 Unsigned 4 SCLAEL_VMDPGRTE Number of pages per second which
this user read in during its last
stay in the dispatch list
56 38 Bitstring 1 SCLAEL_CALQSTAT Scheduling status of user
1... .... SCLAEL_VMDHOTRQ Hot Shot scheduling requested
.1.. .... SCLAEL_VMDHOTST Hot Shot user scheduling granted
..1. .... SCLAEL_VMDLOADU Loading user designation
...1 .... SCLAEL_VMDIABIA Interactive bias is in effect
.... 1... SCLAEL_VMDPGBIA Paging bias is in effect
.... .1.. SCLAEL_VMDLKSHT "Lockshot" scheduling in effect
for this user. Set only in the
base VMDBK.
.... ..1. *
.... ...1 SCLAEL_VMDNULL User is logging off
57 39 Unsigned 1 SCLAEL_VMDELIST This user's eligible list class.
It can be 0, 1, 2, or 3. Classes
1-3 relate to the time this
(scheduler-determined) transaction
has been running. Class 1 is
short-running, class 2,
medium-running and class 3,
long-running.
58 3A Bitstring 1 SCLAEL_VMDWRKCS Type of work which must be done
on the VMDBK
59 3B Bitstring 1 SCLAEL_CALOSTAT Virtual machine operating status
1... .... SCLAEL_VMDSYSOP User is primary system operator
.1.. .... SCLAEL_VMDUSRCT User is counted as being logged
on
..1. .... *
...1 .... SCLAEL_VMDFORCE User is to be logged off. This
may be requested by CP, a forced
logoff, or user's logoff command.
.... 1... SCLAEL_VMDUFORC User is forced to logoff the
system
.... .1.. SCLAEL_VMDDISC User is running disconnected
.... ..1. SCLAEL_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 SCLAEL_VMDXAUTO The original command was
XAUTOLOG. Valid for the base VMDBK
only.
60 3C Character 8 SCLAEL_VMDEPRTY Eligible list priority. This
represents 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.
68 44 Unsigned 4 SCLAEL_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 SCLAEL_VMDCTPVG from
SCLAEL_VMDCTPVR.
72 48 Unsigned 4 SCLAEL_VMDCTXBK Number of Expanded Storage
blocks allocated to a virtual
machine by CP for paging
76 4C Unsigned 4 SCLAEL_CALCPPST Cumulative count of pages stolen
from this user's address spaces
while they were private.
80 50 Unsigned 4 SCLAEL_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 this 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.
84 54 Unsigned 4 SCLAEL_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.
88 58 Signed 4 SCLAEL_VMDURRSP User's resource requirement for
storage and paging
92 5C Signed 4 SCLAEL_SRMABSDE Cardinal count of total absolute
shares of all VMDBKs in the
dispatch and eligible lists. Unit
of value is same as
SCLAEL_VMDABSSH.
96 60 Signed 4 SCLAEL_SRMRELDE Cardinal count of total relative
shares of all VMDBKs in the
dispatch and eligible lists.
100 64 Unsigned 4 SCLAEL_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.
104 68 Bitstring 1 SCLAEL_CALSHARF Set Share flags
1... .... SCLAEL_VMDMXSHA Max share is Absolute if ON. Max
share is Relative if OFF.
.1.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. SCLAEL_VMDLIMTH Max Share is Limithard if ON.
Max Share is Limitsoft if OFF.
.... ...1 *
105 69 Unsigned 3 * Reserved and available for IBM
use.
108 6C Unsigned 4 SCLAEL_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 SCLAEL_VMDMXSHA to determine
if Max share is absolute or
relative.
112 70 Character 8 SCLAEL_SRMATOD Artificial TOD. This TOD only
advances at the rate the system is
running user work.
120 78 Character 8 SCLAEL_SRMATOD2 Artificial TOD2. This TOD only
advances with each CPU's user time
and each CPU's wait time.
128 80 Unsigned 4 SCLAEL_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 SCLAEL_VMDCTPVR.
132 84 Character 0 SCLAEL_END
MRSCLAEL 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
SCLAEL 0 132
SCLAEL_CALBASE 2F 80
SCLAEL_CALCPPST 4C 4
SCLAEL_CALFLAG1 2F 1
SCLAEL_CALOSTAT 3B 1
SCLAEL_CALQSTAT 38 1
SCLAEL_CALSHARF 68 1
SCLAEL_END 84 0
SCLAEL_MRHDR 0 0
SCLAEL_SRMABSDE 5C 4
SCLAEL_SRMATOD 70 8
SCLAEL_SRMATOD2 78 8
SCLAEL_SRMC1ELG 1C 2
SCLAEL_SRMC2ELG 1E 2
SCLAEL_SRMC3ELG 20 2
SCLAEL_SRMRELDE 60 4
SCLAEL_VMDABSSH 54 4
SCLAEL_VMDAUTOL 3B 02
SCLAEL_VMDCPUAD 22 2
SCLAEL_VMDCTCRT 64 4
SCLAEL_VMDCTPVG 80 4
SCLAEL_VMDCTPVR 44 4
SCLAEL_VMDCTXBK 48 4
SCLAEL_VMDDISC 3B 04
SCLAEL_VMDELIST 39 1
SCLAEL_VMDEPRTY 3C 8
SCLAEL_VMDFORCE 3B 10
SCLAEL_VMDHOTRQ 38 80
SCLAEL_VMDHOTST 38 40
SCLAEL_VMDIABIA 38 10
SCLAEL_VMDLIMTH 68 02
SCLAEL_VMDLKSHT 38 04
SCLAEL_VMDLOADU 38 20
SCLAEL_VMDMXSHA 68 80
SCLAEL_VMDMXSHR 6C 4
SCLAEL_VMDNULL 38 01
SCLAEL_VMDPGBIA 38 08
SCLAEL_VMDPGRTE 34 4
SCLAEL_VMDRDYCM 2E 0
SCLAEL_VMDRELSH 50 4
SCLAEL_VMDSVMID 24 8
SCLAEL_VMDSVMWF 2C 80
SCLAEL_VMDSVMWF 2D 80
SCLAEL_VMDSVMWF 2E 80
SCLAEL_VMDSVMWT 2C 1
SCLAEL_VMDSVMWT 2D 1
SCLAEL_VMDSVMWT 2E 1
SCLAEL_VMDSVMW2 2D 0
SCLAEL_VMDSYSOP 3B 80
SCLAEL_VMDUFORC 3B 08
SCLAEL_VMDURRSP 58 4
SCLAEL_VMDUSER 14 8
SCLAEL_VMDUSRCT 3B 40
SCLAEL_VMDWRKCS 3A 1
SCLAEL_VMDWSSPR 30 4
SCLAEL_VMDXAUTO 3B 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