|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRSYTUWT
PrologControl Block Contents
Cross Reference
MRSYTUWT Prolog
DSECT NAME - SYTUWT
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor control area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRSYTUWT
DESCRIPTIVE NAME - Monitor Sample Record
Domain 0 - System Domain
Record 12 - User wait states
DESCRIPTION - User wait state. All VMDBKs in the dispatch
list are tested for their wait states.
NOTES:
- The following list is the order in which the user state is
tested in the VMDBK. If the user is in more than one state,
it is counted only in the first of the list.
SYTUWT_CALTIDL
SYTUWT_CALSVMWT
SYTUWT_CALIOWT
SYTUWT_CALCFWT
SYTUWT_CALSIMWT
SYTUWT_CALWTPAG
SYTUWT_CALCPUWT
SYTUWT_CALCPURN
SYTUWT_CALIOACT
SYTUWT_CALOTHR
MRSYTUWT Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 80 SYTUWT Start of monitor record
0 0 Character 0 SYTUWT_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 Unsigned 4 SYTUWT_CALTIDL Cardinal count of VMDBKs that
were found in test idle, but
not in SVM wait. VMDSVMWF of
VMDSVMWT=off and VMDSTATE =
VMDTIDLE.
24 18 Unsigned 4 SYTUWT_CALTSVM Cardinal count of VMDBKs that
were found in both test idle
and SVM wait. VMDSVMWF of
VMDSVMWT = on and VMDSTATE =
VMDTIDLE.
28 1C Signed 4 SYTUWT_CALIOWT Cardinal count of VMDBKs in
the dispatch list that were in
I/O wait state. A guest is
waiting for an I/O completion
and is thus prevented from
running. VMDIOWT
32 20 Signed 4 SYTUWT_CALWTPAG Cardinal count of VMDBKs in
the dispatch list that were in
'page wait,' a state in which
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
36 24 Signed 4 SYTUWT_CALCFWT Cardinal count of VMDBKs in
the dispatch list that were in
console-function wait. During
such a wait, the virtual CPU is
not permitted to run. VMDCFWT
40 28 Signed 4 SYTUWT_CALSIMWT Cardinal count of VMDBKs in
the dispatch list that were in
'simulation wait.' 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
44 2C Signed 4 SYTUWT_CALCPUWT Cardinal count of VMDBKs in
the dispatch list that are
waiting for a real processor
(i.e. CPU WAIT)
48 30 Signed 4 SYTUWT_CALCPURN Cardinal count of VMDBKs in
the dispatch list that are
running on a real processor
52 34 Signed 4 SYTUWT_CALOTHR Cardinal count of VMDBKs in
the dispatch list that are not
in any of the above states
56 38 Signed 4 SYTUWT_CALQDISP Cardinal count of VMDBKs in
the dispatch list that are
QUICK DISP users.
60 3C Signed 4 SYTUWT_CALELSVM Cardinal count of VMDBKs in
the eligible list that are in
SVM wait
64 40 Unsigned 2 SYTUWT_SRMCELIG Cardinal count of VMDBKs in
the eligible list
66 42 Unsigned 2 * Reserved for IBM use
68 44 Signed 4 SYTUWT_SRMDSVMW Cardinal count of VMDBKs in
the dormant list and in SVM
wait.
72 48 Unsigned 4 SYTUWT_CALIOACT Cardinal count of VMDBKs that
had asynchronous I/O's
outstanding, causing them to be
left in the dispatch list
76 4C Unsigned 4 SYTUWT_CALLLIST Number of VMDBKs that were in
dispatch list waiting for CPU
but were also on the Limit
List, prevented from running by
max share.
80 50 Character 0 SYTUWT_END
MRSYTUWT 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
SYTUWT 0 80
SYTUWT_CALCFWT 24 4
SYTUWT_CALCPURN 30 4
SYTUWT_CALCPUWT 2C 4
SYTUWT_CALELSVM 3C 4
SYTUWT_CALIOACT 48 4
SYTUWT_CALIOWT 1C 4
SYTUWT_CALLLIST 4C 4
SYTUWT_CALOTHR 34 4
SYTUWT_CALQDISP 38 4
SYTUWT_CALSIMWT 28 4
SYTUWT_CALTIDL 14 4
SYTUWT_CALTSVM 18 4
SYTUWT_CALWTPAG 20 4
SYTUWT_END 50 0
SYTUWT_MRHDR 0 0
SYTUWT_SRMCELIG 40 2
SYTUWT_SRMDSVMW 44 4
This information is
based on z/VM V5R2.0.
Last updated on 11 Dec 2005 at 18:48:12.
Copyright IBM Corporation, 1990, 2005