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