|
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 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 V5R1.0.
Last updated on 13 Sep 2004 at 11:25:22.
Copyright IBM Corporation, 1990, 2004