|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRUSEACT
PrologControl Block Contents
Storage Layout
Cross Reference
MRUSEACT Prolog
DSECT NAME - USEACT
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRUSEACT
DESCRIPTIVE NAME - Monitor Sample Record
Domain 4 - User Domain
Record 3 - User Activity Data
DESCRIPTION - User activity data. Generated for each virtual
processor in a virtual configuration.
MRUSEACT Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 320 USEACT Start of monitor record
0 0 Character 0 USEACT_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 USEACT_VMDUSER Userid
28 1C Unsigned 2 USEACT_VMDCPUAD Processor ID/CPU address of
virtual processor
30 1E Bitstring 1 USEACT_VMDMODE Guest machine mode. This is as
set for internal use by CP. See
USEACT_CALMODE for the mode
'calculated' at.
31 1F Bitstring 1 USEACT_CALMODE Architectural mode of the
virtual machine
1... .... *
.1.. .... USEACT_CALMESA ESA architecture
..1. .... USEACT_CALMXA XA architecture
...1 .... USEACT_CALM370 370 architecture
.... 1... USEACT_CALMXC XC architecture
.... .1.. USEACT_CALMESAM ESA mode machine has entered
64-bit mode.
.... ..1. *
.... ...1 *
32 20 Bitstring 1 USEACT_VMDSLIST Scheduling list that the user is
in: X'37' = Dispatch List. X'21' =
Eligible List. X'0B' = Dormant
List. X'00' = user is not in any
list.
33 21 Unsigned 1 USEACT_VMDELIST Class number (0,1,2,or 3) of the
scheduling list the user is in
34 22 Bitstring 1 USEACT_CALFLAG1 Flag byte
1... .... USEACT_CALBASE If on, this is the base VMDBK.
VMDBASE
.1.. .... USEACT_VMDQDSPU This user has the QUICKDSP
designation, as set or defaulted
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. .... USEACT_CALDIAL This user is a dialed user
...1 .... USEACT_CALSNA This user is connected through
System Network Architecture (SNA)
.... 1... USEACT_VMDNOINS User is prevented from inserting
any tracks into the minidisk
cache. (set when SET MDC INS OFF
command is issued)
.... .1.. USEACT_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 *
35 23 Bitstring 1 USEACT_VMDSTYPE Storage type this virtual
machine resides in. X'00' => V=V.
X'80' => V=R. X'40' => V=F.
36 24 Character 8 USEACT_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.
44 2C Character 8 USEACT_VMDVTIME Total time that this user was
running and 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.
52 34 Character 8 USEACT_VMDVFVTM Amount of time, in TOD clock
units, that is consumed by the
guest using vector instructions
while in SIE
60 3C Character 8 USEACT_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.
68 44 Unsigned 4 USEACT_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 USEACT_VMDCTPVG
from USEACT_VMDCTPVR.
72 48 Unsigned 4 USEACT_VMDCTPVL Cardinal count of locked pages
in private address spaces
belonging to this user.
76 4C Unsigned 4 USEACT_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.
80 50 Unsigned 4 USEACT_VMDCTXBK Number of expanded storage
blocks allocated to a virtual
machine by CP for paging.
84 54 Unsigned 4 USEACT_CALXSTOR Size, in megabytes, of expanded
storage attached to the user. If
zero, no expanded storage is
attached. VMDXSTOR
88 58 Unsigned 4 USEACT_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.
92 5C Unsigned 4 USEACT_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.
96 60 Unsigned 4 USEACT_VMDFLREO Total number of frame list
reorders for this virtual system's
private address spaces
100 64 Unsigned 4 USEACT_VMDCTORF Total number of referenced
frames resident when reset was
done for this virtual system's
private address spaces
104 68 Unsigned 4 USEACT_CALCTPGS Cardinal count of non-preferred
paging slots for private address
spaces belonging to this user.
108 6C Unsigned 4 * Reserved for IBM use
112 70 Unsigned 4 USEACT_VMDCTPWT Count of outstanding paging and
spooling I/O's for this user
116 74 Unsigned 4 USEACT_CALCPPGR Cumulative count of pages read
from DASD to main storage for this
user's address spaces while they
were private.
120 78 Unsigned 4 USEACT_CALCPPGW Cumulative count of pages
written from main storage to DASD
for this user's address spaces
while they were private.
124 7C Unsigned 4 USEACT_VMDCTSPR Number of times I/O was issued
for a spool read request
128 80 Unsigned 4 USEACT_VMDCTSPW Number of times I/O was issued
for a spool write request
132 84 Unsigned 4 USEACT_VMDPGSPL Number of pages spooled for this
user. This includes the pages
spooled for the virtual reader,
printer, punch, console, dump, and
trace files.
136 88 Unsigned 4 USEACT_VMDVCSCT Count of start requests to the
virtual machine console
140 8C Unsigned 4 USEACT_VMDVDSCT Cumulative count of virtual I/O
requests the virtual machine has
issued to DASD devices
144 90 Unsigned 4 USEACT_VMDVUSCT Count of Start requests to
virtual Unit Record devices
148 94 Unsigned 4 USEACT_VMDVTSCT Count of Start requests to
virtual channel-to-channel
adapters
152 98 Unsigned 4 USEACT_VMDVOSCT Count of Start requests to
devices other than console, DASDs,
CTCAs, and unit records. (see
USEACT_VMDVCSCT, USEACT_VMDVDSCT,
USEACT_VMDVUSCT, and
USEACT_VMDVTSCT)
156 9C Unsigned 4 USEACT_CALCPPST Cumulative count of pages stolen
from this user's address spaces
while they were private.
160 A0 Unsigned 4 USEACT_VMDISEVM Number of times IUCV data was
successfully transferred by 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.
164 A4 Unsigned 4 USEACT_VMDISTVM Number of times IUCV 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.
168 A8 Unsigned 4 USEACT_VMDISUVM Number of times IUCV data was
NOT successfully transferred by
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.
172 AC Unsigned 4 USEACT_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.)
176 B0 Unsigned 4 USEACT_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.)
180 B4 Unsigned 4 USEACT_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.)
184 B8 Signed 4 USEACT_CALIUCVS Cardinal count of messages on
the IUCV SEND queue. The SEND
queue consists of messages sent to
this user either by another user
or by a CP System Service. Note: A
zero value may mean that the data
could not be obtained as well as
that there weren't any messages.
188 BC Signed 4 USEACT_CALIUCVR Cardinal count of messages on
the IUCV RECEIVE queue which
consists of messages this user has
received from other users or CP
System Services, but has not yet
replied to. Note: A zero value may
mean that the data could not be
obtained as well as that there
were not any messages.
192 C0 Signed 4 USEACT_CALIUCVY Cardinal count of messages on
the IUCV REPLY queue which
consists of replies to messages
this user sent either to other
users or to CP System Services.
Note: A zero value may mean that
the data could not be obtained as
well as that there were not any
messages.
196 C4 Signed 4 USEACT_CALVMCF Cardinal count of messages on
the VMCF queue. Note: A zero value
may mean that the data could not
be obtained as well as that there
were not any messages.
200 C8 Unsigned 4 USEACT_VMDX98CT Cumulative number of times
Diagnose X'98' was issued by this
virtual machine
204 CC Unsigned 4 USEACT_CALCPMIG Cumulative count of pages
migrated by CP from expanded
storage to DASD for this user's
address spaces while they were
private.
208 D0 Unsigned 4 USEACT_CALCPXWT Cumulative count of pages
written from main storage to
expanded storage for this user's
address spaces while they were
private.
212 D4 Unsigned 4 USEACT_CALCPXRD Cumulative count of pages read
from expanded storage to main
storage for this user's address
spaces while they were private.
216 D8 Unsigned 2 USEACT_VMDASMCT Cardinal number of non-base
address spaces owned by this user.
218 DA Bitstring 1 USEACT_CALSHARF Set Share flags
1... .... USEACT_VMDMXSHA Max share is Absolute if ON. Max
share is Relative if OFF.
.1.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. USEACT_VMDLIMTH Max Share is Limithard if ON.
Max Share is Limitsoft if OFF.
.... ...1 *
219 DB Unsigned 1 * Reserved and available for IBM
use.
220 DC Unsigned 4 USEACT_VMDBLKCT Count of SSCH's issued by
BLOCKIO system service (includes
both read and write requests)
224 E0 Unsigned 4 USEACT_VMDMDCIA Count of SSCH's avoided due to
Minidisk Cache read hit
228 E4 Unsigned 4 USEACT_VMDCOPCT Number of times this virtual CPU
had to be redispatched due to a
crypto operation exception
232 E8 Unsigned 4 USEACT_VMDCTISO Number of times ISOLATE occurred
for spaces owned by this virtual
system. Valid only in base VMDBK
236 EC Unsigned 4 USEACT_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.
240 F0 Unsigned 4 USEACT_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.
244 F4 Unsigned 4 USEACT_VMDSSIZE Virtual machine size, in bytes.
This field is kept for
compatability reasons, but may not
be accurate for 64-bit systems
where larger virtual machines are
valid. The preferred field is
USEACT_ASCDEFSZ
248 F8 Unsigned 4 USEACT_VMDMXRVP Number of pages reserved for the
user
252 FC Character 8 USEACT_VMDACTNO User accounting number
260 104 Character 8 USEACT_VMDGRPN RACF ACI group name
268 10C Character 8 USEACT_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.
276 114 Unsigned 4 USEACT_VMDVDISK Count of virtual I/Os to a
virtual disk in storage.
280 118 Unsigned 4 USEACT_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 USEACT_VMDMXSHA to determine
if Max share is absolute or
relative.
284 11C Unsigned 4 USEACT_VMDTHRCT Total number of times this user
was delayed doing I/O to a
throttled device
288 120 Unsigned 2 USEACT_IUCTOTCN Total number of connections for
IUCV. Valid only for base VMDKBK
290 122 Unsigned 2 USEACT_IUCMXCN Maximum number of connections
from the MAXCONN directory option
or the system default.
292 124 Unsigned 4 USEACT_VMDCTPVG Count of private address space
resident pages in DPA owned by
this virtual machine which are >=
2G. Valid only in base VMDBK.
296 128 Character 8 USEACT_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').
296 128 Character 4 USEACT_CALDEFHI high four bytes
300 12C Character 4 USEACT_CALDEFLO low four bytes
304 130 Unsigned 4 USEACT_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.
308 134 Bitstring 1 USEACT_IPQF0 I/O priority flag byte. See CP
SET IOPRIORITY command for
description of absolute and
relative ranges. Valid only in
base VMDBK.
1... .... USEACT_IPQRELRG Using a relative range. Valid
only in base VMDBK.
.1.. .... USEACT_IPQABSRG Using an absolute range. Valid
only in base VMDBK.
..1. .... USEACT_IPQGSSC Guest requested I/O subsystem
details which includes I/O
priority facility status. This
usually indicates that the guest
is I/O priority aware. Valid only
in base VMDBK.
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
309 135 Unsigned 1 USEACT_IPQRQLO I/O priority requested range low
value. See CP SET IOPRIORITY
command for description of
requested and effective I/O
priority values. Valid only in
base VMDBK.
310 136 Unsigned 1 USEACT_IPQRQHI I/O priority requested range
high value. Valid only in base
VMDBK.
311 137 Unsigned 1 USEACT_IPQEFLO I/O priority effective range low
value. Valid only in base VMDBK.
312 138 Unsigned 1 USEACT_IPQEFHI I/O priority effective range
high value. Valid only in base
VMDBK.
313 139 Character 3 * Reserved and available for IBM
use.
316 13C Unsigned 4 USEACT_IPQDSKIP Count of times that a DASD I/O
request was out-prioritized by
another virtual machine's I/O.
Valid only in base VMDBK.
320 140 Character 0 USEACT_END
MRUSEACT 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
USEACT 0 320
USEACT_ASCDEFSZ 128 8
USEACT_CALBASE 22 80
USEACT_CALCPMIG CC 4
USEACT_CALCPPGR 74 4
USEACT_CALCPPGW 78 4
USEACT_CALCPPST 9C 4
USEACT_CALCPXRD D4 4
USEACT_CALCPXWT D0 4
USEACT_CALCTPGS 68 4
USEACT_CALDEFHI 128 4
USEACT_CALDEFLO 12C 4
USEACT_CALDIAL 22 20
USEACT_CALFLAG1 22 1
USEACT_CALIUCVR BC 4
USEACT_CALIUCVS B8 4
USEACT_CALIUCVY C0 4
USEACT_CALMESA 1F 40
USEACT_CALMESAM 1F 04
USEACT_CALMODE 1F 1
USEACT_CALMXA 1F 20
USEACT_CALMXC 1F 08
USEACT_CALM370 1F 10
USEACT_CALSHARF DA 1
USEACT_CALSNA 22 10
USEACT_CALTODON 10C 8
USEACT_CALVMCF C4 4
USEACT_CALXSTOR 54 4
USEACT_END 140 0
USEACT_IPQABSRG 134 40
USEACT_IPQDSKIP 13C 4
USEACT_IPQEFHI 138 1
USEACT_IPQEFLO 137 1
USEACT_IPQF0 134 1
USEACT_IPQGSSC 134 20
USEACT_IPQRELRG 134 80
USEACT_IPQRQHI 136 1
USEACT_IPQRQLO 135 1
USEACT_IUCMXCN 122 2
USEACT_IUCTOTCN 120 2
USEACT_MRHDR 0 0
USEACT_VMDABSSH F0 4
USEACT_VMDACTNO FC 8
USEACT_VMDASMCT D8 2
USEACT_VMDBLKCT DC 4
USEACT_VMDCOPCT E4 4
USEACT_VMDCPUAD 1C 2
USEACT_VMDCTFLT 58 4
USEACT_VMDCTISO E8 4
USEACT_VMDCTORF 64 4
USEACT_VMDCTPVG 124 4
USEACT_VMDCTPVL 48 4
USEACT_VMDCTPVR 44 4
USEACT_VMDCTPWT 70 4
USEACT_VMDCTSPR 7C 4
USEACT_VMDCTSPW 80 4
USEACT_VMDCTVFL 5C 4
USEACT_VMDCTXBK 50 4
USEACT_VMDELIST 21 1
USEACT_VMDFLREO 60 4
USEACT_VMDGRPN 104 8
USEACT_VMDISEVM A0 4
USEACT_VMDISTVM A4 4
USEACT_VMDISUVM A8 4
USEACT_VMDLIMTH DA 02
USEACT_VMDMDCIA E0 4
USEACT_VMDMODE 1E 1
USEACT_VMDMVB2G 130 4
USEACT_VMDMXRVP F8 4
USEACT_VMDMXSHA DA 80
USEACT_VMDMXSHR 118 4
USEACT_VMDNOFSL 22 04
USEACT_VMDNOINS 22 08
USEACT_VMDPGSPL 84 4
USEACT_VMDQDSPU 22 40
USEACT_VMDRELSH EC 4
USEACT_VMDSLIST 20 1
USEACT_VMDSSIZE F4 4
USEACT_VMDSTYPE 23 1
USEACT_VMDTHRCT 11C 4
USEACT_VMDTTIME 24 8
USEACT_VMDUSER 14 8
USEACT_VMDVCSCT 88 4
USEACT_VMDVDISK 114 4
USEACT_VMDVDSCT 8C 4
USEACT_VMDVFOTM 3C 8
USEACT_VMDVFVTM 34 8
USEACT_VMDVOSCT 98 4
USEACT_VMDVSEVM AC 4
USEACT_VMDVSTVM B0 4
USEACT_VMDVSUVM B4 4
USEACT_VMDVTIME 2C 8
USEACT_VMDVTSCT 94 4
USEACT_VMDVUSCT 90 4
USEACT_VMDWSSPR 4C 4
USEACT_VMDX98CT C8 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