|
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
Storage Layout
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 228 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. .... *
...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'00' =
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... *
.... .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 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 228
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 E4 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_VMDAUTOL 99 02
USEINT_VMDCETSD AC 8
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_VMDCTIDL 92 2
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_VMDRDYCM 32 0
USEINT_VMDSIMWT 9A 20
USEINT_VMDSLCNT E0 2
USEINT_VMDSLEEP 9B 40
USEINT_VMDSTATE 98 1
USEINT_VMDSTOP 9B 80
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 V4R3.0.
Last updated on 1 May 2002 at 16:20:33.
Copyright IBM Corporation, 1990, 2002