|
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
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 316 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
z/Arch 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 * Reserved for IBM use Previous
field is no longer meaningful.
(USEATE_VMDVFVTM)
56 38 Character 8 * Reserved for IBM use Previous
field is no longer meaningful.
(USEATE_VMDVFOTM)
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
<2G belonging to this user. See
USEATE_VMDCTPVLA for the >2G
value.
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 * Reserved for IBM use Previous
field is no longer meaningful.
(USEATE_VMDCTVFL)
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' => Reserved and no
longer available. 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 z/Arch
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 Unsigned 4 USEATE_VEBALERT Number of alert interruptions
Collected only for base VMDBK.
276 114 Unsigned 4 USEATE_VEBTVSCT Number of interceptions for
guest TVS instructions
Collected only for base VMDBK.
280 118 Unsigned 4 USEATE_VEBSVSCT Number of interceptions for
guest SVS instructions
Collected only for base VMDBK.
284 11C Unsigned 4 USEATE_VEBTPIAI Number of adapter
interruptions delivered via
guest TPI Collected only for
base VMDBK.
288 120 Unsigned 4 USEATE_VEBVIRAI Number of adapter
interruptions stacked for guest
by CP Collected only for base
VMDBK.
292 124 Unsigned 4 USEATE_VEBHDWAI Number of adapter
interruptions delivered to
guest inside SIE Collected only
for base VMDBK.
296 128 Character 8 USEATE_VMDCTPVLA Cardinal count of locked
pages in private address spaces
>2G belonging to this user. See
USEATE_VMDCTPVL for the <2G
value.
304 130 Unsigned 4 USEATE_VMDCTSHL Count of shared address space
resident pages <2G. Valid only
in the SYSTEM VMDBK.
308 134 Character 8 USEATE_VMDCTSHLA Count of shared address space
resident pages >2G. Valid only
in the SYSTEM VMDBK.
316 13C 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 316
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 13C 0
USEATE_MRHDR 0 0
USEATE_VEBALERT 110 4
USEATE_VEBHDWAI 124 4
USEATE_VEBSVSCT 118 4
USEATE_VEBTPIAI 11C 4
USEATE_VEBTVSCT 114 4
USEATE_VEBVIRAI 120 4
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_VMDCTPVLA 128 8
USEATE_VMDCTPVR 40 4
USEATE_VMDCTPWT 64 4
USEATE_VMDCTSHL 130 4
USEATE_VMDCTSHLA 134 8
USEATE_VMDCTSPR 70 4
USEATE_VMDCTSPW 74 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_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 V5R2.0.
Last updated on 11 Dec 2005 at 18:48:12.
Copyright IBM Corporation, 1990, 2005