|
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 352 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 Cumulative count of the
total number of resident
frames found referenced
during reorders 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. USEATE_VMDMASST Collaborative Memory
Management assist enabled.
.... ...1 USEATE_VMDMAACT Collaborative Memory
Management assist is active,
i.e. in use by this virtual
machine. Note: This guest may
be in a pending off state if
either a global or per-user
SET MEMASSIST OFF has been
issued (SYSMASST or VMDMASST
is off). This indicates that
the system or user setting
was turned off after the
guest started using the
assist. The assist will
remain active
(USEATE_VMDMAACT=1) and
available to this guest until
the next virtual machine
reset or IPL.
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.. .... USEATE_VMDSTOP This virtual CPU is in
soft stop
..1. .... USEATE_VMDSTOPD This virtual CPU is
stopped
...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 * Reserved for IBM use
Previous field is no longer
meaningful. (USEATE_VMDCOPCT)
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 virtual CPU's RELATIVE
share of the system, as set
in the user's directory or
via the SET SHARE command.
Set to zero when this VMDBK
has an ABSOLUTE share value,
or has a virtual processor
dedicated to it, or is in the
process of being logged off.
212 D4 Unsigned 4 USEATE_VMDABSSH This virtual CPU'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 when this VMDBK
has a RELATIVE share value.
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 virtual CPU'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. This
field should not be used if
USEATE_VMDSTOP is on.
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 Unsigned 1 USEATE_VMDPUTYP CPU Type. Valid values:
X'00' - General Purpose (CP)
X'02' - zSeries Application
Assist (zAAP) X'03' -
Integrated Facility for Linux
(IFL) X'04' - Internal
Coupling Facility (ICF) X'05'
- zSeries Integrated
Information (zIIP)
317 13D Bitstring 1 USEATE_VMDCFGEM Virtual configuration
indicators. Valid in base
VMDBK only
1... .... *
.1.. .... USEATE_VMDCPUAF User requested CPU
Affinity
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
318 13E Bitstring 1 USEATE_VMDPUST CPU Status flag
1... .... USEATE_VMDAFSUP CPU Affinity suppressed
.1.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
319 13F Character 1 * Reserved for IBM use
320 140 Character 8 USEATE_VMDVTMP Total virtual time for user
on primary processor
328 148 Character 8 USEATE_VMDTTMP Total virtual and
simulation time for the user
on primary processor
336 150 Character 8 USEATE_VMDVTMS Total virtual time for user
on secondary processor
344 158 Character 8 USEATE_VMDTTMS Total virtual and
simulation time for the user
on secondary processor
352 160 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 352
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 160 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_VMDAFSUP 13E 80
USEATE_VMDBLKCT C0 4
USEATE_VMDCFGEM 13D 1
USEATE_VMDCPUAD 1C 2
USEATE_VMDCPUAF 13D 40
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_VMDMAACT BC 01
USEATE_VMDMASST BC 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_VMDPUST 13E 1
USEATE_VMDPUTYP 13C 1
USEATE_VMDQDSPU BC 40
USEATE_VMDRELSH D0 4
USEATE_VMDSSIZE D8 4
USEATE_VMDSTOP BE 40
USEATE_VMDSTOPD BE 20
USEATE_VMDSTYPE BD 1
USEATE_VMDTTIME 20 8
USEATE_VMDTTMP 148 8
USEATE_VMDTTMS 158 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_VMDVTMP 140 8
USEATE_VMDVTMS 150 8
USEATE_VMDVTSCT 88 4
USEATE_VMDVUSCT 84 4
USEATE_VMDWSSPR 48 4
USEATE_VMDX98CT AC 4
This information is
based on z/VM V6R2.0.
Last updated on 23 Nov 2011 at 15:33:04.
Copyright IBM Corporation, 1990, 2011