|
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
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 364 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
z/Arch 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' => Reserved and no
longer available. 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 * Reserved for IBM use Previous
field is no longer meaningful.
(USEACT_VMDVFVTM)
60 3C Character 8 * Reserved for IBM use Previous
field is no longer meaningful.
(USEACT_VMDVFOTM)
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
<2G belonging to this user. See
USEACT_VMDCTPVLA for the >2G
value.
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 * Reserved for IBM use Previous
field is no longer meaningful.
(USEACT_VMDCTVFL)
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 z/Arch
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 Unsigned 4 USEACT_VEBALERT Number of alert interruptions
Collected only for base VMDBK.
324 144 Unsigned 4 USEACT_VEBTVSCT Number of interceptions for
guest TVS instructions
Collected only for base VMDBK.
328 148 Unsigned 4 USEACT_VEBSVSCT Number of interceptions for
guest SVS instructions
Collected only for base VMDBK.
332 14C Unsigned 4 USEACT_VEBTPIAI Number of adapter
interruptions delivered via
guest TPI Collected only for
base VMDBK.
336 150 Unsigned 4 USEACT_VEBVIRAI Number of adapter
interruptions stacked for guest
by CP Collected only for base
VMDBK.
340 154 Unsigned 4 USEACT_VEBHDWAI Number of adapter
interruptions delivered to
guest inside SIE Collected only
for base VMDBK.
344 158 Character 8 USEACT_VMDCTPVLA Cardinal count of locked
pages in private address spaces
>2G belonging to this user. See
USEACT_VMDCTPVL for the <2G
value.
352 160 Unsigned 4 USEACT_VMDCTSHL Count of shared address space
resident pages <2G. Valid only
in the SYSTEM VMDBK.
356 164 Character 8 USEACT_VMDCTSHLA Count of shared address space
resident pages >2G. Valid only
in the SYSTEM VMDBK.
364 16C 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 364
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 16C 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_VEBALERT 140 4
USEACT_VEBHDWAI 154 4
USEACT_VEBSVSCT 148 4
USEACT_VEBTPIAI 14C 4
USEACT_VEBTVSCT 144 4
USEACT_VEBVIRAI 150 4
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_VMDCTPVLA 158 8
USEACT_VMDCTPVR 44 4
USEACT_VMDCTPWT 70 4
USEACT_VMDCTSHL 160 4
USEACT_VMDCTSHLA 164 8
USEACT_VMDCTSPR 7C 4
USEACT_VMDCTSPW 80 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_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 V5R2.0.
Last updated on 11 Dec 2005 at 18:48:12.
Copyright IBM Corporation, 1990, 2005