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
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