|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRUSEATE
PrologControl Block Contents
Storage Layout
Cross Reference
MRUSEATE Prolog
DSECT NAME - USEATE
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRUSEATE
DESCRIPTIVE NAME - Monitor Event Record
Domain 4 - User Domain
Record 9 - User Activity Data at Transaction End
DESCRIPTION - Provides information relating to a VMDBK's
consumption of system resources for a transaction.
A separate record is generated for each VMDBK in a
virtual complex that contributed to the transaction.
MRUSEATE Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 272 USEATE Start of monitor record
0 0 Character 0 USEATE_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 USEATE_VMDUSER Userid
28 1C Unsigned 2 USEATE_VMDCPUAD Processor ID
30 1E Bitstring 1 USEATE_VMDMODE Guest machine mode. This is as
set for internal use by CP. See
USEATE_CALMODE for the mode
'calculated' at.
31 1F Bitstring 1 USEATE_CALMODE Architectural mode of the
virtual machine
1... .... *
.1.. .... USEATE_CALMESA ESA architecture
..1. .... USEATE_CALMXA XA architecture
...1 .... USEATE_CALM370 370 architecture
.... 1... USEATE_CALMXC XC architecture
.... .1.. USEATE_CALMESAM ESA mode machine has entered
ESAME mode
.... ..1. *
.... ...1 *
32 20 Character 8 USEATE_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
this field is the elapsed time in
TOD clock units.
40 28 Character 8 USEATE_VMDVTIME 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 this field is the
elapsed time in TOD clock units.
48 30 Character 8 USEATE_VMDVFVTM Amount of time, in TOD clock
units, that is consumed by the
guest using vector instructions
while in SIE
56 38 Character 8 USEATE_VMDVFOTM Amount of time, in TOD clock
units, consumed by the system to
support this guest's loading and
unloading of its virtual vector
facility.
64 40 Unsigned 4 USEATE_VMDCTPVR Cardinal count of resident pages
in private address spaces
belonging to this user. This
monitor field is actually the sum
of VMDCTPVR + VMDCTPVG. To get the
count of resident pages below the
2GB line, subtract USEATE_VMDCTPVG
from USEATE_VMDCTPVR.
68 44 Unsigned 4 USEATE_VMDCTPVL Cardinal count of locked pages
in private address spaces
belonging to this user.
72 48 Unsigned 4 USEATE_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.
76 4C Unsigned 4 USEATE_VMDCTXBK The number of expanded storage
blocks allocated to a virtual
machine by CP for paging
80 50 Unsigned 4 USEATE_VMDCTFLT Count of host segment and page
faults on guest pages which
occurred while running this
virtual CPU. It does not include
faults on RCP pages.
84 54 Unsigned 4 USEATE_VMDCTVFL Number of times this virtual
system's vector facility was
loaded into a real vector
facility. If the virtual vector
facility is currently loaded, this
count would be approximately equal
to the number of saves.
88 58 Unsigned 4 USEATE_VMDCTORF Total number of referenced
frames resident when reset was
done for this virtual system's
private address spaces
92 5C Unsigned 4 USEATE_CALCTPGS Cardinal count of non-preferred
paging slots for private address
spaces belonging to this user.
96 60 Unsigned 4 * Reserved for IBM use
100 64 Unsigned 4 USEATE_VMDCTPWT Count of outstanding paging and
spooling I/O's for this user
104 68 Unsigned 4 USEATE_CALCPPGR Cumulative count of pages read
from DASD to main storage for this
user's address spaces while they
were private.
108 6C Unsigned 4 USEATE_CALCPPGW Cumulative count of pages
written from main storage to DASD
for this user's address spaces
while they were private.
112 70 Unsigned 4 USEATE_VMDCTSPR Number of times I/O was issued
for a spool read request
116 74 Unsigned 4 USEATE_VMDCTSPW Number of times I/O was issued
for a spool write request
120 78 Unsigned 4 USEATE_VMDPGSPL Number of pages spooled for this
user. This includes the pages
spooled for the virtual reader,
printer, punch, console, dump, and
trace files.
124 7C Unsigned 4 USEATE_VMDVCSCT Number of start requests to the
virtual machine console
128 80 Unsigned 4 USEATE_VMDVDSCT Cumulative count of virtual I/O
requests the virtual machine has
issued to DASD devices
132 84 Unsigned 4 USEATE_VMDVUSCT Count of Start requests to
virtual Unit Record devices
136 88 Unsigned 4 USEATE_VMDVTSCT Count of Start requests to
virtual channel-to-channel
adapters
140 8C Unsigned 4 USEATE_VMDVOSCT Count of Start requests to
devices other than console, DASDs,
CTCAs, and unit records. (see
USEATE_VMDVCSCT, USEATE_VMDVDSCT,
USEATE_VMDVUSCT, and
USEATE_VMDVTSCT.)
144 90 Unsigned 4 USEATE_CALCPPST Cumulative count of pages stolen
from this user's address spaces
while they were private.
148 94 Unsigned 4 USEATE_VMDISEVM Number of times IUCV/APPC data
was successfully transferred from
this virtual complex. (SENDs and
REPLYs with RC=0 when this virtual
machine is the source). Not valid
in the SYSTEM VMDBK. Valid only in
base VMDBK.
152 98 Unsigned 4 USEATE_VMDISTVM Number of times IUCV/APPC data
was successfully transferred to
this virtual complex. (SENDs and
REPLYs with RC=0 when this virtual
machine is the target). Not valid
in the SYSTEM VMDBK. Valid only in
base VMDBK.
156 9C Unsigned 4 USEATE_VMDISUVM Number of times IUCV/APPC data
was not successfully transferred
from this virtual complex. (SENDs
and REPLYs with RC=0 when this
virtual machine is the source).
Not valid in the SYSTEM VMDBK.
Valid only in base VMDBK.
160 A0 Unsigned 4 USEATE_VMDVSEVM Number of times VMCF data was
successfully transferred by this
virtual machine. (SENDs SENDXs,
SEND/RECEIVEs, and REPLYs with
RC=0 and this virtual machine is
source.)
164 A4 Unsigned 4 USEATE_VMDVSTVM Number of times VMCF data was
successfully transferred to this
virtual machine. (SENDs SENDXs,
SEND/RECEIVEs, and REPLYs with
RC=0 and this virtual machine is
target.)
168 A8 Unsigned 4 USEATE_VMDVSUVM Number of times VMCF data was
not successfully transferred by
this virtual machine. (SENDs
SENDXs, SEND/RECEIVEs, and REPLYs
with RC^=0 and this virtual
machine is source.)
172 AC Unsigned 4 USEATE_VMDX98CT Cumulative number of times
Diagnose X'98' was issued by this
virtual machine
176 B0 Unsigned 4 USEATE_CALCPMIG Cumulative count of pages
migrated by CP from expanded
storage to DASD for this user's
address spaces while they were
private.
180 B4 Unsigned 4 USEATE_CALCPXWT Cumulative count of pages
written from main storage to
expanded storage for this user's
address spaces while they were
private.
184 B8 Unsigned 4 USEATE_CALCPXRD Cumulative count of pages read
from expanded storage to main
storage for this user's address
spaces while they were private.
188 BC Bitstring 1 USEATE_CALFLAG1 Flag byte
1... .... USEATE_CALBASE If on, this is the base VMDBK.
VMDBASE
.1.. .... USEATE_VMDQDSPU This user has the QUICKDSP
designation, either by default or
as set by the SET QUICKDSP
command. When the user has work to
do, it will be added to the
dispatch list immediately without
waiting in the eligible list.
..1. .... USEATE_CALDIAL This user is a dialed user
...1 .... USEATE_CALSNA This user is connected through
System Network Architecture (SNA)
.... 1... USEATE_VMDNOINS User is prevented from inserting
any tracks into the minidisk
cache. (set when SET MDC INS OFF
command is issued)
.... .1.. USEATE_VMDNOFSL No MDC fair share limit applies.
Set at LOGON if the NOMDCFS option
is specified on the OPTIONS
statement in the user's directory.
.... ..1. *
.... ...1 *
189 BD Bitstring 1 USEATE_VMDSTYPE Storage type this virtual
machine resides in. X'00' => V=V.
X'80' => V=R. X'40' => V=F.
190 BE Bitstring 1 USEATE_CALSHARF Set Share flags
1... .... USEATE_VMDMXSHA Max share is Absolute if ON. Max
share is Relative if OFF.
.1.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. USEATE_VMDLIMTH Max share is Limithard if ON.
Max share is Limitsoft if OFF.
.... ...1 *
191 BF Unsigned 1 * Reserved and available for IBM
use.
192 C0 Unsigned 4 USEATE_VMDBLKCT Count of SSCH's issued by
BLOCKIO system service (includes
both read and write requests)
196 C4 Unsigned 4 USEATE_VMDMDCIA Count of SSCH's avoided due to
Minidisk Cache read hit
200 C8 Unsigned 4 USEATE_VMDCOPCT Number of times this virtual CPU
had to be redispatched due to a
crypto operation exception
204 CC Unsigned 4 USEATE_VMDCTISO Number of times ISOLATE occurred
for spaces owned by this virtual
system. Valid only in base VMDBK
208 D0 Unsigned 4 USEATE_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 the user 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.
212 D4 Unsigned 4 USEATE_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.
216 D8 Unsigned 4 USEATE_VMDSSIZE Virtual machine size, in bytes.
This field is kept for
compatability reasons, but may not
be accurate for ESAME systems
where larger virtual machines are
valid. The preferred field is
USEATE_ASCDEFSZ
220 DC Unsigned 4 USEATE_VMDMXRVP Number of pages reserved for the
user
224 E0 Character 8 USEATE_VMDACTNO User accounting number
232 E8 Character 8 USEATE_VMDGRPN RACF ACI group name
240 F0 Character 8 USEATE_CALTODON Time at which the user logged on
for this session. In time-of-day
(TOD) clock format. To get the
user's connect time, subtract this
time value from the time stamp in
the record header's MRHDRTOD.
248 F8 Unsigned 4 USEATE_VMDVDISK Count of virtual I/Os to a
virtual disk in storage.
252 FC Unsigned 4 USEATE_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 USEATE_VMDMXSHA to determine
if Max share is absolute or
relative.
256 100 Character 8 USEATE_ASCDEFSZ Defined storage size in
addressable bytes, minus one. If
DEF STOR CONFIG was used to define
multiple discontiguous extents of
addressable defined storage, this
field contains the sum of the
sizes in bytes of all of the
individual extents (minus one).
The minus one notation is used so
that a total size of 16 Exabytes
may be represented without
ambiguity (as
x'FFFFFFFF_FFFFFFFF').
256 100 Character 4 USEATE_CALDEFHI high four bytes
260 104 Character 4 USEATE_CALDEFLO low four bytes
264 108 Unsigned 4 USEATE_VMDCTPVG Count of private address space
resident pages in DPA owned by
this virtual machine which are >=
2G. Valid only in base VMDBK.
268 10C Unsigned 4 USEATE_VMDMVB2G Number of times page translation
moved a page on behalf of this us
user from a frame with address >=
2GB to one < 2GB. This field is
only valid in the base VMDBK.
272 110 Character 0 USEATE_END
MRUSEATE 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
USEATE 0 272
USEATE_ASCDEFSZ 100 8
USEATE_CALBASE BC 80
USEATE_CALCPMIG B0 4
USEATE_CALCPPGR 68 4
USEATE_CALCPPGW 6C 4
USEATE_CALCPPST 90 4
USEATE_CALCPXRD B8 4
USEATE_CALCPXWT B4 4
USEATE_CALCTPGS 5C 4
USEATE_CALDEFHI 100 4
USEATE_CALDEFLO 104 4
USEATE_CALDIAL BC 20
USEATE_CALFLAG1 BC 1
USEATE_CALMESA 1F 40
USEATE_CALMESAM 1F 04
USEATE_CALMODE 1F 1
USEATE_CALMXA 1F 20
USEATE_CALMXC 1F 08
USEATE_CALM370 1F 10
USEATE_CALSHARF BE 1
USEATE_CALSNA BC 10
USEATE_CALTODON F0 8
USEATE_END 110 0
USEATE_MRHDR 0 0
USEATE_VMDABSSH D4 4
USEATE_VMDACTNO E0 8
USEATE_VMDBLKCT C0 4
USEATE_VMDCOPCT C8 4
USEATE_VMDCPUAD 1C 2
USEATE_VMDCTFLT 50 4
USEATE_VMDCTISO CC 4
USEATE_VMDCTORF 58 4
USEATE_VMDCTPVG 108 4
USEATE_VMDCTPVL 44 4
USEATE_VMDCTPVR 40 4
USEATE_VMDCTPWT 64 4
USEATE_VMDCTSPR 70 4
USEATE_VMDCTSPW 74 4
USEATE_VMDCTVFL 54 4
USEATE_VMDCTXBK 4C 4
USEATE_VMDGRPN E8 8
USEATE_VMDISEVM 94 4
USEATE_VMDISTVM 98 4
USEATE_VMDISUVM 9C 4
USEATE_VMDLIMTH BE 02
USEATE_VMDMDCIA C4 4
USEATE_VMDMODE 1E 1
USEATE_VMDMVB2G 10C 4
USEATE_VMDMXRVP DC 4
USEATE_VMDMXSHA BE 80
USEATE_VMDMXSHR FC 4
USEATE_VMDNOFSL BC 04
USEATE_VMDNOINS BC 08
USEATE_VMDPGSPL 78 4
USEATE_VMDQDSPU BC 40
USEATE_VMDRELSH D0 4
USEATE_VMDSSIZE D8 4
USEATE_VMDSTYPE BD 1
USEATE_VMDTTIME 20 8
USEATE_VMDUSER 14 8
USEATE_VMDVCSCT 7C 4
USEATE_VMDVDISK F8 4
USEATE_VMDVDSCT 80 4
USEATE_VMDVFOTM 38 8
USEATE_VMDVFVTM 30 8
USEATE_VMDVOSCT 8C 4
USEATE_VMDVSEVM A0 4
USEATE_VMDVSTVM A4 4
USEATE_VMDVSUVM A8 4
USEATE_VMDVTIME 28 8
USEATE_VMDVTSCT 88 4
USEATE_VMDVUSCT 84 4
USEATE_VMDWSSPR 48 4
USEATE_VMDX98CT AC 4
This information is
based on z/VM V4R3.0.
Last updated on 1 May 2002 at 16:20:33.
Copyright IBM Corporation, 1990, 2002