|
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 284 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 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 284
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 11C 0
USELOF_MRHDR 0 0
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 V4R4.0.
Last updated on 22 Jul 2003 at 15:04:23.
Copyright IBM Corporation, 1990, 2003