|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRUSEITE
PrologControl Block Contents
Storage Layout
Cross Reference
MRUSEITE Prolog
DSECT NAME - USEITE
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRUSEITE
DESCRIPTIVE NAME - Monitor Event Record
Domain 4 - User Domain
Record 10 - User Interaction at Transaction End
DESCRIPTION - Describes a VMDBK's interaction with other VMDBKs
during a transaction. A separate record is generated
for each VMDBK in a virtual complex that contributed
to the transaction.
NOTES:
- Fields labeled by the prefix, 'USEITE_HF', are high-frequency
counters.
- The following is the order in which the user is tested for its
wait state. If the user is in more than one state, it is
counted only in the first of the list.
USEITE_HFIOWT
USEITE_HFCFWT
USEITE_HFSIMWT
USEITE_HFWTPAG
USEITE_HFLLIST
USEITE_HFCPUWT
USEITE_HFCPURN
USEITE_HFESVM
USEITE_HFLOAD
USEITE_HFDORM
USEITE_HFDSVM
USEITE_HFIOACT
USEITE_HFTIDL
USEITE_HFTSVM
USEITE_HFPGACT
USEITE_HFOTHR
MRUSEITE Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 196 USEITE Start of monitor record
0 0 Character 0 USEITE_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 USEITE_VMDUSER User logon identification
28 1C Unsigned 2 USEITE_VMDCPUAD Processor address
30 1E Signed 2 USEITE_VMDSLCNT Count of minor time slices that
have expired since the start of
current transaction.
32 20 Unsigned 4 USEITE_VMDSVMFX Number of times the SVM wait
flag was left on at the end of a
transaction and had to be reset by
the scheduler.
36 24 Character 8 USEITE_VMDSVMID VMDBK name for the last
successful IUCV, VMCF or APPC/VM
Send for this virtual machine.
Valid in base VMDBK only.
44 2C Bitstring 1 USEITE_VMDSVMWT Service-virtual-machine (SVM)
wait flag byte - valid in base
VMDBK only.
1... .... USEITE_VMDSVMWF VMDBK is waiting for a response
from IUCV, VMCF, or APPC.
.1.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
45 2D Character 0 USEITE_VMDSVMW2 Back-up byte to the VMDSVMWT
byte. Its contents will persist
longer than they would in
VMDSVMWT. Valid in base VMDBK
only.
45 2D Bitstring 1 USEITE_VMDSVMWT Service-virtual-machine (SVM)
wait flag byte - valid in base
VMDBK only.
1... .... USEITE_VMDSVMWF VMDBK is waiting for a response
from IUCV, VMCF, or APPC.
46 2E Character 0 USEITE_VMDRDYCM Flag byte set by IUCV, VMCF, or
APPC whenever IUCV/VMCF/APPC makes
an external interrupt. It is sort
of a "reference bit" that tells
the scheduler that IUCV/VMCF/APPC
has been active recently. Valid in
base VMDBK only.
46 2E Bitstring 1 USEITE_VMDSVMWT Service-virtual-machine (SVM)
wait flag byte - valid in base
VMDBK only.
1... .... USEITE_VMDSVMWF VMDBK is waiting for a response
from IUCV, VMCF, or APPC.
47 2F Bitstring 1 USEITE_CALFLAG1 Flag byte
1... .... USEITE_CALBASE If on, this is the base VMDBK.
VMDBASE
.1.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
48 30 Unsigned 4 USEITE_HFQUCT Number of times VMDBK was
sampled for high-frequency data
52 34 Unsigned 4 USEITE_HFDISP0 Number of times the VMDBK was in
Q0. VMDSLIST = VMDDISPL and
VMDELIST = 0.
56 38 Unsigned 4 USEITE_HFDISP1 Number of times the VMDBK was in
Q1. VMDSLIST = VMDDISPL and
VMDELIST = 1.
60 3C Unsigned 4 USEITE_HFDISP2 Number of times the VMDBK was in
Q2. VMDSLIST = VMDDISPL and
VMDELIST = 2.
64 40 Unsigned 4 USEITE_HFDISP3 Number of times the VMDBK was in
Q3. VMDSLIST = VMDDISPL and
VMDELIST = 3.
68 44 Unsigned 4 USEITE_HFELIG0 Number of times the VMDBK was in
E0. VMDSLIST = VMDELIG and
VMDELIST = 0.
72 48 Unsigned 4 USEITE_HFELIG1 Number of times the VMDBK was in
E1. VMDSLIST = VMDELIG and
VMDELIST = 1.
76 4C Unsigned 4 USEITE_HFELIG2 Number of times the VMDBK was in
E2. VMDSLIST = VMDELIG and
VMDELIST = 2.
80 50 Unsigned 4 USEITE_HFELIG3 Number of times the VMDBK was in
E3. VMDSLIST = VMDELIG and
VMDELIST = 3.
84 54 Unsigned 4 USEITE_HFSTCT Number of times VMDBK was
high-frequency sampled. This was
once distinguishable from
USEITE_HFQUCT but is now the same
and is retained for migration and
compatibility purposes.
88 58 Unsigned 4 USEITE_HFTIDL Number of times this user was
found in test idle and not in SVM
wait
92 5C Unsigned 4 USEITE_HFTSVM Number of times this user was
found in test idle and in SVM wait
96 60 Unsigned 4 USEITE_HFIOWT Number of times this user was in
I/O wait. I/O wait indicates that
a guest is waiting for I/O
completion status and thus is
prevented from running. VMDIOWT
100 64 Unsigned 4 USEITE_HFCFWT Number of times this user was
found in console-function wait.
During such a wait, the virtual
cpu is not permitted to run.
VMDCFWT
104 68 Unsigned 4 USEITE_HFSIMWT Number of times this user was
found in 'simulation wait,' in
which the CPU is simulating some
hardware functions such as
instructions, interrupts, or timer
updates, and the virtual machine
is thus prevented from running to
avoid potential conflicts with the
simulations. VMDSIMWT
108 6C Unsigned 4 USEITE_HFWTPAG Number of times this user was
found in page wait. Page wait is
when the current guest instruction
refers to a guest page which is
not present in host storage and
must be brought in from auxiliary
storage. Page wait prevents the
virtual CPU from running, however
it is a "soft wait" condition, and
as such can be cleared by a guest
PSW swap. VMDWTPAG
112 70 Unsigned 4 USEITE_HFCPUWT Number of times this user was
found waiting to run on the real
CPU. VMDSTATE = VMDREADY
116 74 Unsigned 4 USEITE_HFCPURN Number of times this user was
found running on the real CPU.
VMDSTATE = VMDISPCH
120 78 Unsigned 4 USEITE_HFESVM Number of times this user was
found in SVM wait and in the
eligible list.
124 7C Unsigned 4 USEITE_HFLOAD Number of times this user was
considered a loading user.
VMDLOADU is on and VMDSLIST ^=
VMDDORM.
128 80 Unsigned 4 USEITE_HFDORM Number of times this user was
found dormant. VMDSLIST = VMDDORM
132 84 Signed 4 USEITE_HFDSVM Number of times this user was
found in SVM wait and in the
dormant list. Note: this count is
also included in USEITE_HFDORM.
VMDSVMWF of VMDSVMWT = on and
VMDSLIST = VMDDORM
136 88 Unsigned 4 USEITE_HFOTHR Number of times this user was
not found in any of the above
states
140 8C Unsigned 2 USEITE_VMDCNTID Number of times user was not
granted a test idle time when it
went idle in the dispatch list
142 8E Unsigned 2 USEITE_VMDCTIDL Number of times this user was
granted a test idle time when it
went idle in the dispatch list
144 90 Unsigned 4 USEITE_VMDDFRWK Count of 'deferred' work items
for the VMDBK. A 'deferred' work
item is an asynchronous task that
has yet to run. This VMDBK shall
be prevented from completing its
logoff until this count is zero,
i.e., when all such work items
have been run.
148 94 Bitstring 1 USEITE_VMDSTATE Scheduler/Dispatcher State.
X'63' = Review-suspended. VMDBK is
in transition to the suspended
state. X'58' = Review-idle. VMDBK
is in transition to the idle
state. X'4D' = VMDBK has been
selected by dispatcher for
processing. X'42' = VMDBK is ready
for selection by dispatcher once
it goes to the dispatch list.
X'37' = Test-idle. VMDBK is ready
for selection by the dispatcher
but should be dropped from the
dispatch list when selected the
next time. X'08' = VMDBK is
suspended, probably waiting for a
short-term event to occur. X'00' =
VMDBK is idle. No work is
available.
149 95 Bitstring 1 USEITE_CALOSTAT Virtual machine operating status
1... .... USEITE_VMDSYSOP User is primary system operator
.1.. .... USEITE_VMDUSRCT User is counted as being logged
on
..1. .... *
...1 .... USEITE_VMDFORCE User is to be logged off. This
may be requested by CP, a forced
logoff, or user's logoff command.
.... 1... USEITE_VMDUFORC User is forced to logoff the
system
.... .1.. USEITE_VMDDISC User is running disconnected
.... ..1. USEITE_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 USEITE_VMDXAUTO The original command was
XAUTOLOG. Valid for the base VMDBK
only.
150 96 Bitstring 1 USEITE_CALRSTAT Reason(s) the dispatched VMDBK
is not being run
1... .... *
.1.. .... USEITE_VMDCFWT VMDBK is in console function
wait. Either a console function is
active, or the virtual machine is
waiting for the remaining VMDBKs
in the configuration to enter
console function mode.
..1. .... USEITE_VMDSIMWT CP is simulating some hardware
function for the guest such as
instructions, interrupts, and
timer updates. Virtual machine is
prevented from running to avoid
potential conflicts with the
simulations.
...1 .... USEITE_VMDIOWT Instruction waiting for I/O
status for completion. (May be
cancelled without loss of system
integrity.)
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
151 97 Unsigned 1 * Reserved for IBM use
152 98 Unsigned 2 USEITE_VMDCPRMD(4) Number of times this user was
pre-emptied from the dispatch list
(Q0, Q1, Q2, Q3) due to a
requirement for storage for E1
users.
160 A0 Unsigned 2 USEITE_VMDCWSGD(4) Number of times this user was
removed from the dispatch list
(Q0, Q1, Q2, Q3) because it
reached its working set size
growth limit, and its new working
set size would no longer fit into
available storage.
168 A8 Unsigned 2 USEITE_VMDCETSD(4) Number of times this user was
removed from the dispatch list
(Q0, Q1, Q2, Q3) because it
reached elapsed time slice end.
176 B0 Unsigned 2 USEITE_VMDCIDLD(4) Number of times this user was
removed from the dispatch list
(Q0, Q1, Q2, Q3) because its test
idle time had expired or because
it was granted no test idle time.
184 B8 Unsigned 4 USEITE_HFIOACT High Frequency Count. Cardinal
number of times the user had an
asynchronous I/O outstanding,
causing the user to be left in the
dispatch list. VMDIOACT
188 BC Unsigned 4 USEITE_HFLLIST High Frequency Count. Number of
times the user was in dispatch
list waiting for CPU but was on
the Limit List, prevented from
running by max share.
192 C0 Unsigned 4 USEITE_HFPGACT High Frequency Count. Number of
times the virtual machine had page
fault requests active, but was not
in page wait (VMDWTPAG was not
set). This would occur if
asynchronous page fault was being
used and there was an outstanding
page fault, but the virtual
machine loaded a wait state
because it had no other work to
do. A virtual machine can have
page faults handled asynchronously
if using the PAGEX feature or the
Page-Fault Handshaking CP services
via the CP PFAULT MACRO.
196 C4 Character 0 USEITE_END
MRUSEITE 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
USEITE 0 196
USEITE_CALBASE 2F 80
USEITE_CALFLAG1 2F 1
USEITE_CALOSTAT 95 1
USEITE_CALRSTAT 96 1
USEITE_END C4 0
USEITE_HFCFWT 64 4
USEITE_HFCPURN 74 4
USEITE_HFCPUWT 70 4
USEITE_HFDISP0 34 4
USEITE_HFDISP1 38 4
USEITE_HFDISP2 3C 4
USEITE_HFDISP3 40 4
USEITE_HFDORM 80 4
USEITE_HFDSVM 84 4
USEITE_HFELIG0 44 4
USEITE_HFELIG1 48 4
USEITE_HFELIG2 4C 4
USEITE_HFELIG3 50 4
USEITE_HFESVM 78 4
USEITE_HFIOACT B8 4
USEITE_HFIOWT 60 4
USEITE_HFLLIST BC 4
USEITE_HFLOAD 7C 4
USEITE_HFOTHR 88 4
USEITE_HFPGACT C0 4
USEITE_HFQUCT 30 4
USEITE_HFSIMWT 68 4
USEITE_HFSTCT 54 4
USEITE_HFTIDL 58 4
USEITE_HFTSVM 5C 4
USEITE_HFWTPAG 6C 4
USEITE_MRHDR 0 0
USEITE_VMDAUTOL 95 02
USEITE_VMDCETSD A8 8
USEITE_VMDCFWT 96 40
USEITE_VMDCIDLD B0 8
USEITE_VMDCNTID 8C 2
USEITE_VMDCPRMD 98 8
USEITE_VMDCPUAD 1C 2
USEITE_VMDCTIDL 8E 2
USEITE_VMDCWSGD A0 8
USEITE_VMDDFRWK 90 4
USEITE_VMDDISC 95 04
USEITE_VMDFORCE 95 10
USEITE_VMDIOWT 96 10
USEITE_VMDRDYCM 2E 0
USEITE_VMDSIMWT 96 20
USEITE_VMDSLCNT 1E 2
USEITE_VMDSTATE 94 1
USEITE_VMDSVMFX 20 4
USEITE_VMDSVMID 24 8
USEITE_VMDSVMWF 2C 80
USEITE_VMDSVMWF 2D 80
USEITE_VMDSVMWF 2E 80
USEITE_VMDSVMWT 2C 1
USEITE_VMDSVMWT 2D 1
USEITE_VMDSVMWT 2E 1
USEITE_VMDSVMW2 2D 0
USEITE_VMDSYSOP 95 80
USEITE_VMDUFORC 95 08
USEITE_VMDUSER 14 8
USEITE_VMDUSRCT 95 40
USEITE_VMDXAUTO 95 01
This information is
based on z/VM V4R2.0.
Last updated on 15 Oct 2001 at 08:04:23.
Copyright IBM Corporation, 1990, 2001