|
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
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 200 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'2C' = 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 Unsigned 1 USEITE_VMDPUTYP CPU Type. Valid values:
X'00' - General Purpose (CP)
X'02' - zSeries Application
Assist (zAAP) X'03' -
Integrated Facility for Linux
(IFL) X'04' - Internal
Coupling Facility (ICF) X'05'
- zSeries Integrated
Information (zIIP)
197 C5 Bitstring 1 USEITE_VMDCFGEM Virtual configuration
indicators. Valid in base
VMDBK only
1... .... *
.1.. .... USEITE_VMDCPUAF User requested CPU
Affinity
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
198 C6 Bitstring 1 USEITE_VMDPUST CPU Status flag
1... .... USEITE_VMDAFSUP CPU Affinity suppressed
.1.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
199 C7 Character 1 * Reserved for IBM use
200 C8 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 200
USEITE_CALBASE 2F 80
USEITE_CALFLAG1 2F 1
USEITE_CALOSTAT 95 1
USEITE_CALRSTAT 96 1
USEITE_END C8 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_VMDAFSUP C6 80
USEITE_VMDAUTOL 95 02
USEITE_VMDCETSD A8 8
USEITE_VMDCFGEM C5 1
USEITE_VMDCFWT 96 40
USEITE_VMDCIDLD B0 8
USEITE_VMDCNTID 8C 2
USEITE_VMDCPRMD 98 8
USEITE_VMDCPUAD 1C 2
USEITE_VMDCPUAF C5 40
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_VMDPUST C6 1
USEITE_VMDPUTYP C4 1
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 V6R2.0.
Last updated on 23 Nov 2011 at 15:33:04.
Copyright IBM Corporation, 1990, 2011