|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRUSELOF
PrologControl Block Contents
Cross Reference
MRUSELOF Prolog
DSECT NAME - USELOF
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRUSELOF
DESCRIPTIVE NAME - Monitor Event Record
Domain 4 - User Domain
Record 2 - User Logoff Data
DESCRIPTION - Records a user that has logged off. Generated for
the base VMDBK only.
NOTE - Alternate VMDBKs of the user that has logged off are
recorded in MRUSEDTC (Domain 4, Record 6).
MRUSELOF Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 308 USELOF Start of monitor record
0 0 Character 0 USELOF_MRHDR record header
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 USELOF_VMDUSER USERID
28 1C Unsigned 2 USELOF_VMDCPUAD Processor ID
30 1E Bitstring 1 USELOF_VMDMODE Guest machine mode. This is
as set for internal use by CP.
See USELOF_CALMODE for the mode
'calculated' at.
31 1F Bitstring 1 USELOF_CALMODE Architectural mode of the
virtual machine
1... .... *
.1.. .... USELOF_CALMESA ESA architecture
..1. .... USELOF_CALMXA XA architecture
...1 .... USELOF_CALM370 370 architecture
.... 1... USELOF_CALMXC XC architecture
.... .1.. USELOF_CALMESAM ESA mode machine has entered
z/Arch mode.
.... ..1. *
.... ...1 *
32 20 Bitstring 1 USELOF_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 USELOF_VMDELIST Class number (0,1,2,or 3) of
the scheduling list the user is
in
34 22 Bitstring 1 USELOF_CALFLAG1 Flag byte
1... .... *
.1.. .... USELOF_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. .... USELOF_CALDIAL This user is a dialed user
...1 .... USELOF_CALSNA This user is connected
through System Network
Architecture (SNA)
.... 1... USELOF_VMDNOINS User is prevented from
inserting any tracks into the
minidisk cache. (set when SET
MDC INS OFF command is issued)
.... .1.. USELOF_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 USELOF_VMDSTYPE Storage type this virtual
machine resides in. X'00' =>
V=V. X'80' => V=R. X'40' =>
V=F.
36 24 Character 8 USELOF_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 USELOF_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 USELOF_VMDVFVTM Amount of time, in TOD clock
units, that is consumed by the
guest using vector instructions
while in SIE
60 3C Character 8 USELOF_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 USELOF_VMDCTPVR Cardinal count of private
resident pages in the virtual
machine. This monitor field is
actually the sum of VMDCTPVR +
VMDCTPVG, which includes pages
above and below the 2GB line.
To get the count of the
resident pages below the 2GB
line, subtract USELOF_VMDCTPVG
from USELOF_VMDCTPVR.
72 48 Unsigned 4 USELOF_VMDCTPVL Cardinal count of locked
pages in private address spaces
belonging to this user.
76 4C Unsigned 4 USELOF_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 USELOF_VMDCTXBK Number of expanded storage
blocks allocated to a virtual
machine by CP for paging.
84 54 Unsigned 4 USELOF_CALXSTOR Size, in megabytes, of
expanded storage attached to
the user. If zero, no expanded
storage is attached. VMDXSTOR
88 58 Unsigned 4 USELOF_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 USELOF_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 USELOF_VMDFLREO Total number of frame list
reorders for this virtual
system's private address spaces
100 64 Unsigned 4 USELOF_VMDCTORF Total number of referenced
frames resident when reset was
done for this virtual system's
private address spaces
104 68 Unsigned 4 USELOF_CALCTPGS Cardinal count of
non-preferred paging slots for
private address spaces
belonging to this user.
108 6C Unsigned 4 USELOF_VMDCTPWT Count of outstanding paging
and spooling I/O's for this
user
112 70 Unsigned 4 USELOF_CALCPPGR Cumulative count of pages
read from DASD to main storage
for this user's address spaces
while they were private.
116 74 Unsigned 4 USELOF_CALCPPGW Cumulative count of pages
written from main storage to
DASD for this user's address
spaces while they were private.
120 78 Unsigned 4 USELOF_VMDCTSPR Number of times I/O was
issued for a spool read request
124 7C Unsigned 4 USELOF_VMDCTSPW Number of times I/O was
issued for a spool write
request
128 80 Unsigned 4 USELOF_VMDPGSPL Number of pages spooled for
this user. This includes the
pages spooled for the virtual
reader, printer, punch,
console, dump, and trace files.
132 84 Unsigned 4 USELOF_VMDVCSCT Count of start requests to
the virtual machine console
136 88 Unsigned 4 USELOF_VMDVDSCT Cumulative count of virtual
I/O requests the virtual
machine has issued to DASD
devices
140 8C Unsigned 4 USELOF_VMDVUSCT Count of Start requests to
virtual Unit Record devices
144 90 Unsigned 4 USELOF_VMDVTSCT Count of Start requests to
virtual channel-to-channel
adapters
148 94 Unsigned 4 USELOF_VMDVOSCT Count of Start requests to
devices other than console,
DASDs, CTCAs, and unit records.
(see USELOF_VMDVCSCT,
USELOF_VMDVDSCT,
USELOF_VMDVUSCT, and
USELOF_VMDVTSCT)
152 98 Unsigned 4 USELOF_CALCPPST Cumulative count of pages
stolen from this user's address
spaces while they were private.
156 9C Unsigned 4 USELOF_VMDISEVM Number of times IUCV data was
successfully transferred by
this virtual machine. (SENDs
and REPLYs with RC=0 when this
virtual machine is the source).
Valid only in base VMDBK.
160 A0 Unsigned 4 USELOF_VMDISTVM Number of times IUCV data was
successfully transferred to
this virtual machine. (SENDs
and REPLYs with RC=0 when this
virtual machine is the target).
Valid only in base VMDBK.
164 A4 Unsigned 4 USELOF_VMDISUVM Number of times IUCV data was
NOT successfully transferred by
this virtual machine. (SENDs
and REPLYs with RC^=0 when this
virtual machine is the source).
Valid only in the base VMDBK.
168 A8 Unsigned 4 USELOF_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.)
172 AC Unsigned 4 USELOF_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.)
176 B0 Unsigned 4 USELOF_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.)
180 B4 Unsigned 4 USELOF_VMDX98CT Cumulative number of times
Diagnose X'98' was issued by
this virtual machine
184 B8 Unsigned 4 USELOF_CALCPMIG Cumulative count of pages
migrated by CP from expanded
storage to DASD for this user's
address spaces while they were
private.
188 BC Unsigned 4 USELOF_CALCPXWT Cumulative count of pages
written from main storage to
expanded storage for this
user's address spaces while
they were private.
192 C0 Unsigned 4 USELOF_CALCPXRD Cumulative count of pages
read from expanded storage to
main storage for this user's
address spaces while they were
private.
196 C4 Unsigned 2 USELOF_VMDASMCT Cardinal number of non-base
address spaces owned by this
user.
198 C6 Bitstring 1 USELOF_CALSHARF Set Share flags
1... .... USELOF_VMDMXSHA Max share is Absolute if ON,
Max share is Relative if OFF.
.1.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. USELOF_VMDLIMTH Max share is Limithard if ON
Max share is Limitsoft if OFF
.... ...1 *
199 C7 Bitstring 1 USELOF_CALOSTAT Virtual machine operating
status
1... .... USELOF_VMDSYSOP User is primary system
operator
.1.. .... USELOF_VMDUSRCT User is counted as being
logged on
..1. .... *
...1 .... USELOF_VMDFORCE User is to be logged off.
This may be requested by CP, a
forced logoff, or user's logoff
command.
.... 1... USELOF_VMDUFORC User is forced to logoff the
system
.... .1.. USELOF_VMDDISC User is running disconnected
.... ..1. USELOF_VMDAUTOL AUTOLOG/XAUTOLOG in progress.
User has been automatically
logged on. This bit is set off
when the user's IPL statement
is processed, or (if there is
no IPL to process) when the
user enters a LOGON command
from a terminal to RECONNECT.
.... ...1 USELOF_VMDXAUTO The original command was
XAUTOLOG. Valid for the base
VMDBK only (see
USEINT_CALBASE).
200 C8 Unsigned 4 USELOF_VMDBLKCT Count of SSCH's issued by
BLOCKIO system service
(includes both read and write
requests)
204 CC Unsigned 4 USELOF_VMDMDCIA Count of SSCH's avoided due
to Minidisk Cache read hit
208 D0 Unsigned 4 USELOF_VMDCOPCT Number of times this virtual
CPU had to be redispatched due
to a crypto operation exception
212 D4 Unsigned 4 USELOF_VMDCTISO Number of times ISOLATE
occurred for spaces owned by
this virtual system. Valid only
in base VMDBK
216 D8 Unsigned 4 USELOF_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.
220 DC Unsigned 4 USELOF_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.
224 E0 Unsigned 4 USELOF_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
USELOF_ASCDEFSZ
228 E4 Unsigned 4 USELOF_VMDMXRVP Number of pages reserved for
the user
232 E8 Character 8 USELOF_VMDACTNO User accounting number
240 F0 Character 8 USELOF_VMDGRPN RACF ACI group name
248 F8 Character 8 USELOF_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.
256 100 Unsigned 4 USELOF_VMDVDISK Count of virtual I/Os to a
virtual disk in storage.
260 104 Unsigned 4 USELOF_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
USELOF_VMDMXSHA to determine if
Max share is absolute or
relative.
264 108 Unsigned 4 USELOF_VMDTHRCT Total number of times this
user was delayed doing I/O to a
throttled device
268 10C Character 8 USELOF_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').
268 10C Character 4 USELOF_CALDEFHI high four bytes
272 110 Character 4 USELOF_CALDEFLO low four bytes
276 114 Unsigned 4 USELOF_VMDCTPVG Count of private address
space resident pages in DPA
owned by this virtual machine
which are >= 2G. Valid only in
base VMDBK.
280 118 Unsigned 4 USELOF_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.
284 11C Unsigned 4 USELOF_VEBALERT Number of alert interruptions
Collected only for base VMDBK.
288 120 Unsigned 4 USELOF_VEBTVSCT Number of interceptions for
guest TVS instructions
Collected only for base VMDBK.
292 124 Unsigned 4 USELOF_VEBSVSCT Number of interceptions for
guest SVS instructions
Collected only for base VMDBK.
296 128 Unsigned 4 USELOF_VEBTPIAI Number of adapter
interruptions delivered via
guest TPI Collected only for
base VMDBK.
300 12C Unsigned 4 USELOF_VEBVIRAI Number of adapter
interruptions stacked for guest
by CP Collected only for base
VMDBK.
304 130 Unsigned 4 USELOF_VEBHDWAI Number of adapter
interruptions delivered to
guest inside SIE Collected only
for base VMDBK.
308 134 Character 0 USELOF_END
MRUSELOF 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
USELOF 0 308
USELOF_ASCDEFSZ 10C 8
USELOF_CALCPMIG B8 4
USELOF_CALCPPGR 70 4
USELOF_CALCPPGW 74 4
USELOF_CALCPPST 98 4
USELOF_CALCPXRD C0 4
USELOF_CALCPXWT BC 4
USELOF_CALCTPGS 68 4
USELOF_CALDEFHI 10C 4
USELOF_CALDEFLO 110 4
USELOF_CALDIAL 22 20
USELOF_CALFLAG1 22 1
USELOF_CALMESA 1F 40
USELOF_CALMESAM 1F 04
USELOF_CALMODE 1F 1
USELOF_CALMXA 1F 20
USELOF_CALMXC 1F 08
USELOF_CALM370 1F 10
USELOF_CALOSTAT C7 1
USELOF_CALSHARF C6 1
USELOF_CALSNA 22 10
USELOF_CALTODON F8 8
USELOF_CALXSTOR 54 4
USELOF_END 134 0
USELOF_MRHDR 0 0
USELOF_VEBALERT 11C 4
USELOF_VEBHDWAI 130 4
USELOF_VEBSVSCT 124 4
USELOF_VEBTPIAI 128 4
USELOF_VEBTVSCT 120 4
USELOF_VEBVIRAI 12C 4
USELOF_VMDABSSH DC 4
USELOF_VMDACTNO E8 8
USELOF_VMDASMCT C4 2
USELOF_VMDAUTOL C7 02
USELOF_VMDBLKCT C8 4
USELOF_VMDCOPCT D0 4
USELOF_VMDCPUAD 1C 2
USELOF_VMDCTFLT 58 4
USELOF_VMDCTISO D4 4
USELOF_VMDCTORF 64 4
USELOF_VMDCTPVG 114 4
USELOF_VMDCTPVL 48 4
USELOF_VMDCTPVR 44 4
USELOF_VMDCTPWT 6C 4
USELOF_VMDCTSPR 78 4
USELOF_VMDCTSPW 7C 4
USELOF_VMDCTVFL 5C 4
USELOF_VMDCTXBK 50 4
USELOF_VMDDISC C7 04
USELOF_VMDELIST 21 1
USELOF_VMDFLREO 60 4
USELOF_VMDFORCE C7 10
USELOF_VMDGRPN F0 8
USELOF_VMDISEVM 9C 4
USELOF_VMDISTVM A0 4
USELOF_VMDISUVM A4 4
USELOF_VMDLIMTH C6 02
USELOF_VMDMDCIA CC 4
USELOF_VMDMODE 1E 1
USELOF_VMDMVB2G 118 4
USELOF_VMDMXRVP E4 4
USELOF_VMDMXSHA C6 80
USELOF_VMDMXSHR 104 4
USELOF_VMDNOFSL 22 04
USELOF_VMDNOINS 22 08
USELOF_VMDPGSPL 80 4
USELOF_VMDQDSPU 22 40
USELOF_VMDRELSH D8 4
USELOF_VMDSLIST 20 1
USELOF_VMDSSIZE E0 4
USELOF_VMDSTYPE 23 1
USELOF_VMDSYSOP C7 80
USELOF_VMDTHRCT 108 4
USELOF_VMDTTIME 24 8
USELOF_VMDUFORC C7 08
USELOF_VMDUSER 14 8
USELOF_VMDUSRCT C7 40
USELOF_VMDVCSCT 84 4
USELOF_VMDVDISK 100 4
USELOF_VMDVDSCT 88 4
USELOF_VMDVFOTM 3C 8
USELOF_VMDVFVTM 34 8
USELOF_VMDVOSCT 94 4
USELOF_VMDVSEVM A8 4
USELOF_VMDVSTVM AC 4
USELOF_VMDVSUVM B0 4
USELOF_VMDVTIME 2C 8
USELOF_VMDVTSCT 90 4
USELOF_VMDVUSCT 8C 4
USELOF_VMDWSSPR 4C 4
USELOF_VMDXAUTO C7 01
USELOF_VMDX98CT B4 4
This information is
based on z/VM V5R1.0.
Last updated on 13 Sep 2004 at 11:25:22.
Copyright IBM Corporation, 1990, 2004