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