Programming Interface Information:
The Monitor Records are intended Programming Interfaces that
allow the customer to write programs to obtain services of z/VM.

MRSYTUWT

Prolog
Control Block Contents
Storage Layout
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 V4R3.0.
Last updated on 1 May 2002 at 16:20:33.
Copyright IBM Corporation, 1990, 2002