|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRUSEINT
PrologControl Block Contents
Cross Reference
MRUSEINT Prolog
DSECT NAME - USEINT
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRUSEINT
DESCRIPTIVE NAME - Monitor Sample Record
Domain 4 - User Domain
Record 4 - User Interaction Data
DESCRIPTION - Describes a VMDBK's use of the system. Included
are such things as its use of IUCV, APPC and the
number of times it occupied various queues. A
separate record is generated for each VMDBK defined
in the user's virtual complex.
NOTES:
- Fields labeled by the prefix, 'USEINT_HF', are high-frequency
counters.
- The following is the order of high-frequency counters 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.
USEINT_HFIOWT
USEINT_HFCFWT
USEINT_HFSIMWT
USEINT_HFWTPAG
USEINT_HFLLIST
USEINT_HFCPUWT
USEINT_HFCPURN
USEINT_HFESVM
USEINT_HFLOAD
USEINT_HFDORM
USEINT_HFDSVM
USEINT_HFIOACT
USEINT_HFTIDL
USEINT_HFTSVM
USEINT_HFPGACT
USEINT_HFOTHR
MRUSEINT Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 248 USEINT Start of monitor record
0 0 Character 0 USEINT_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 USEINT_VMDUSER User logon identification
28 1C Unsigned 2 USEINT_VMDCPUAD Processor address
30 1E Bitstring 1 USEINT_CALFLAG Flag byte
1... .... USEINT_CALBASE If on, this is the base
VMDBK. VMDBASE
.1.. .... USEINT_CALTRQFL If on, there is a TRQ
block set to either time the
user in a sleep state for a
limited period of time or to
time 15 minutes before
logging off a disconnected
user following an attempted
display I/O (time bomb
logoff).
..1. .... USEINT_RELO1 Indicates this is first
record since a live guest
relocation occurred
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
31 1F Unsigned 1 * Reserved for IBM use
32 20 Character 4 USEINT_CALINTRN 'YES ' = this VMDBK is
currently contributing to a
transaction. 'NO ' = this
VMDBK is not currently
contributing to a
transaction. 'UNDE' = this
VMDBK is currently idle and
may or may not contribute to
a transaction.
36 24 Unsigned 4 USEINT_VMDSVMFX Number of times the
SVM-wait flag was left on at
the end of a transaction and
had to be corrected by the
scheduler by resetting it.
40 28 Character 8 USEINT_VMDSVMID VMDBK name for the last
successful IUCV, VMCF, or
APPC/VM Send for this virtual
machine. Valid in base VMDBK
only.
48 30 Bitstring 1 USEINT_VMDSVMWT Service-virtual-machine
(SVM) wait flag byte - valid
in base VMDBK only.
1... .... USEINT_VMDSVMWF VMDBK is waiting for a
response from IUCV, VMCF, or
APPC.
.1.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
49 31 Character 0 USEINT_VMDSVMW2 Back-up byte to the
VMDSVMWT byte. Its contents
will persist longer than they
would in VMDSVMWT. Valid in
base VMDBK only.
49 31 Bitstring 1 USEINT_VMDSVMWT Service-virtual-machine
(SVM) wait flag byte - valid
in base VMDBK only.
1... .... USEINT_VMDSVMWF VMDBK is waiting for a
response from IUCV, VMCF, or
APPC.
50 32 Character 0 USEINT_VMDRDYCM Flag byte set by IUCV,
VMCF, or APPC whenever
IUCV/VMCF/APPC makes an
external interrupt. It is
sort of a "reference byte"
that tells the scheduler that
IUCV/VMCF/APPC had been
active recently. Valid in
base VMDBK only.
50 32 Bitstring 1 USEINT_VMDSVMWT Service-virtual-machine
(SVM) wait flag byte - valid
in base VMDBK only.
1... .... USEINT_VMDSVMWF VMDBK is waiting for a
response from IUCV, VMCF, or
APPC.
51 33 Unsigned 1 * Reserved for IBM use
52 34 Unsigned 4 USEINT_HFQUCT Number of times VMDBK was
high frequency sampled.
56 38 Unsigned 4 USEINT_HFDISP0 Number of times the VMDBK
was in Q0. VMDSLIST =
VMDDISPL and VMDELIST = 0.
60 3C Unsigned 4 USEINT_HFDISP1 Number of times the VMDBK
was in Q1. VMDSLIST =
VMDDISPL and VMDELIST = 1.
64 40 Unsigned 4 USEINT_HFDISP2 Number of times the VMDBK
was in Q2. VMDSLIST =
VMDDISPL and VMDELIST = 2.
68 44 Unsigned 4 USEINT_HFDISP3 Number of times the VMDBK
was in Q3. VMDSLIST =
VMDDISPL and VMDELIST = 3.
72 48 Unsigned 4 USEINT_HFELIG0 Number of times the VMDBK
was in E0. VMDSLIST = VMDELIG
and VMDELIST = 0.
76 4C Unsigned 4 USEINT_HFELIG1 Number of times the VMDBK
was in E1. VMDSLIST = VMDELIG
and VMDELIST = 1.
80 50 Unsigned 4 USEINT_HFELIG2 Number of times the VMDBK
was in E2. VMDSLIST = VMDELIG
and VMDELIST = 2.
84 54 Unsigned 4 USEINT_HFELIG3 Number of times the VMDBK
was in E3. VMDSLIST = VMDELIG
and VMDELIST = 3.
88 58 Unsigned 4 USEINT_HFSTCT Number of times VMDBK was
high frequency sampled. This
was once distinguishable from
USEINT_HFQUCT but is now the
same and is retained for
migration or compatibility
purposes.
92 5C Unsigned 4 USEINT_HFTIDL Count of times user was
found in test idle and not in
SVM wait
96 60 Unsigned 4 USEINT_HFTSVM Count of times user was
found in test idle and in SVM
wait
100 64 Unsigned 4 USEINT_HFIOWT Number of times this user
was in synchronous I/O wait.
This I/O wait indicates that
a guest is waiting for I/O
completion status and thus is
prevented from running.
VMDIOWT
104 68 Unsigned 4 USEINT_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
108 6C Unsigned 4 USEINT_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
112 70 Unsigned 4 USEINT_HFWTPAG Count 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
116 74 Unsigned 4 USEINT_HFCPUWT Count of times this user
was found waiting to run on
the real processor. VMDSTATE
= VMDREADY
120 78 Unsigned 4 USEINT_HFCPURN Count of times this user
was found running on the real
processor. VMDSTATE =
VMDISPCH
124 7C Unsigned 4 USEINT_HFESVM Count of times this user
was found in SVM wait and in
the eligible list
128 80 Unsigned 4 USEINT_HFLOAD Count of times this user
was considered a loading
user. VMDLOADU = on and
VMDSLIST ^= VMDDORM
132 84 Unsigned 4 USEINT_HFDORM Count of times this user
was found dormant. VMDSLIST =
VMDDORM
136 88 Signed 4 USEINT_HFDSVM Count of times this user
was found in SVM wait and in
the dormant list. Note: this
count is also included in
USEINT_HFDORM. VMDSVMWF of
VMDSVMWT = on and VMDSLIST =
VMDDORM
140 8C Unsigned 4 USEINT_HFOTHR Count of times this user
was not found in any of the
above states
144 90 Unsigned 2 USEINT_VMDCNTID Number of times user was
not granted a test idle time
when it went idle in the
dispatch list
146 92 Unsigned 2 USEINT_VMDCTIDL Number of times this user
was granted a test idle time
when it went idle in the
dispatch list
148 94 Unsigned 4 USEINT_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.
152 98 Bitstring 1 USEINT_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.
153 99 Bitstring 1 USEINT_CALOSTAT Virtual machine operating
status
1... .... USEINT_VMDSYSOP User is primary system
operator
.1.. .... USEINT_VMDUSRCT User is counted as being
logged on
..1. .... *
...1 .... USEINT_VMDFORCE User is to be logged off.
This may be requested by CP,
a forced logoff, or user's
logoff command.
.... 1... USEINT_VMDUFORC User is forced to logoff
the system
.... .1.. USEINT_VMDDISC User is running
disconnected
.... ..1. USEINT_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 USEINT_VMDXAUTO The original command was
XAUTOLOG. Valid for the base
VMDBK only (see
USEINT_CALBASE).
154 9A Bitstring 1 USEINT_CALRSTAT Reason(s) the dispatched
VMDBK is not being run
1... .... *
.1.. .... USEINT_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. .... USEINT_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 .... USEINT_VMDIOWT Instruction waiting for
I/O status for completion.
(May be cancelled without
loss of system integrity.)
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
155 9B Bitstring 1 USEINT_CALCWAIT Console Function Wait
control flags.
1... .... USEINT_VMDSTOP virtual machine in stop
state.
.1.. .... USEINT_VMDSLEEP virtual machine is
sleeping.
..1. .... USEINT_VMDCKST virtual cpu in check stop
state.
...1 .... USEINT_VMDDSCWT virtual machine is in
disconnected wait mode. I/O
was attempted to the display
and the user was
disconnected, so a timer is
set to log the user off if
not reconnected within 15
minutes.
.... 1... USEINT_VMDSTOPD This virtual CPU is
stopped
.... .1.. *
.... ..1. *
.... ...1 *
156 9C Unsigned 2 USEINT_VMDCPRMD(4) Number of times this user
was was pre-emptied from the
dispatch list (Q0, Q1, Q2,
Q3) due to a requirement for
storage for E1 users
164 A4 Unsigned 2 USEINT_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 available storage.
172 AC Unsigned 2 USEINT_VMDCETSD(4) Number of times this user
was removed from the dispatch
list (Q0, Q1, Q2, Q3) because
it reached elapsed time slice
end.
180 B4 Unsigned 2 USEINT_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
188 BC Character 8 USEINT_VMDDQTOD Time of day clock at the
time that the VMDBK was
dropped from the dispatch
list
196 C4 Character 8 USEINT_VMDSUSCK Time of day clock at the
time the VMDBK was last
marked suspended
204 CC Character 8 USEINT_VMDMTTOD Time of day clock when the
last transaction started.
Valid for the base VMDBK only
(see USEINT_CALBASE).
212 D4 Unsigned 4 USEINT_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
216 D8 Unsigned 4 USEINT_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.
220 DC Unsigned 4 USEINT_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.
224 E0 Signed 2 USEINT_VMDSLCNT Count of minor time slices
that have expired since the
start of current transaction.
226 E2 Unsigned 2 * Reserved and available for
IBM use.
228 E4 Unsigned 1 USEINT_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)
229 E5 Bitstring 1 USEINT_VMDCFGEM Virtual configuration
indicators. Valid in base
VMDBK only
1... .... *
.1.. .... USEINT_VMDCPUAF User requested CPU
Affinity
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
230 E6 Bitstring 1 USEINT_VMDPUST CPU Status flag
1... .... USEINT_VMDAFSUP CPU Affinity suppressed
.1.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
231 E7 Character 1 * Reserved for IBM use
232 E8 Unsigned 4 USEINT_VMDCTSTA Count of times this virtual
CPU has been started by one
of the following methods:
-SIGP START -SIGP RESTART
-Begin Command
236 EC Unsigned 4 USEINT_VMDCTSTO Count of times this virtual
CPU has been stopped by one
of the following methods:
-SIGP STOP -SIGP STOP AND
STORE STATUS -SIGP INITIAL
CPU RESET -SIGP CPU RESET
-STOP Command
240 F0 Character 8 USEINT_VMDRLLST Time stamp of last
relocation of this user. Only
valid if USEINT_RELO1 is ON.
248 F8 Character 0 USEINT_END
MRUSEINT 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
USEINT 0 248
USEINT_CALBASE 1E 80
USEINT_CALCWAIT 9B 1
USEINT_CALFLAG 1E 1
USEINT_CALINTRN 20 4
USEINT_CALOSTAT 99 1
USEINT_CALRSTAT 9A 1
USEINT_CALTRQFL 1E 40
USEINT_END F8 0
USEINT_HFCFWT 68 4
USEINT_HFCPURN 78 4
USEINT_HFCPUWT 74 4
USEINT_HFDISP0 38 4
USEINT_HFDISP1 3C 4
USEINT_HFDISP2 40 4
USEINT_HFDISP3 44 4
USEINT_HFDORM 84 4
USEINT_HFDSVM 88 4
USEINT_HFELIG0 48 4
USEINT_HFELIG1 4C 4
USEINT_HFELIG2 50 4
USEINT_HFELIG3 54 4
USEINT_HFESVM 7C 4
USEINT_HFIOACT D4 4
USEINT_HFIOWT 64 4
USEINT_HFLLIST D8 4
USEINT_HFLOAD 80 4
USEINT_HFOTHR 8C 4
USEINT_HFPGACT DC 4
USEINT_HFQUCT 34 4
USEINT_HFSIMWT 6C 4
USEINT_HFSTCT 58 4
USEINT_HFTIDL 5C 4
USEINT_HFTSVM 60 4
USEINT_HFWTPAG 70 4
USEINT_MRHDR 0 0
USEINT_RELO1 1E 20
USEINT_VMDAFSUP E6 80
USEINT_VMDAUTOL 99 02
USEINT_VMDCETSD AC 8
USEINT_VMDCFGEM E5 1
USEINT_VMDCFWT 9A 40
USEINT_VMDCIDLD B4 8
USEINT_VMDCKST 9B 20
USEINT_VMDCNTID 90 2
USEINT_VMDCPRMD 9C 8
USEINT_VMDCPUAD 1C 2
USEINT_VMDCPUAF E5 40
USEINT_VMDCTIDL 92 2
USEINT_VMDCTSTA E8 4
USEINT_VMDCTSTO EC 4
USEINT_VMDCWSGD A4 8
USEINT_VMDDFRWK 94 4
USEINT_VMDDISC 99 04
USEINT_VMDDQTOD BC 8
USEINT_VMDDSCWT 9B 10
USEINT_VMDFORCE 99 10
USEINT_VMDIOWT 9A 10
USEINT_VMDMTTOD CC 8
USEINT_VMDPUST E6 1
USEINT_VMDPUTYP E4 1
USEINT_VMDRDYCM 32 0
USEINT_VMDRLLST F0 8
USEINT_VMDSIMWT 9A 20
USEINT_VMDSLCNT E0 2
USEINT_VMDSLEEP 9B 40
USEINT_VMDSTATE 98 1
USEINT_VMDSTOP 9B 80
USEINT_VMDSTOPD 9B 08
USEINT_VMDSUSCK C4 8
USEINT_VMDSVMFX 24 4
USEINT_VMDSVMID 28 8
USEINT_VMDSVMWF 30 80
USEINT_VMDSVMWF 31 80
USEINT_VMDSVMWF 32 80
USEINT_VMDSVMWT 30 1
USEINT_VMDSVMWT 31 1
USEINT_VMDSVMWT 32 1
USEINT_VMDSVMW2 31 0
USEINT_VMDSYSOP 99 80
USEINT_VMDUFORC 99 08
USEINT_VMDUSER 14 8
USEINT_VMDUSRCT 99 40
USEINT_VMDXAUTO 99 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