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   180  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
       2   2  Unsigned      2  MRHDRZER
       4   4  Unsigned      1  MRHDRDM
       5   5  Unsigned      1  *
       6   6  Unsigned      2  MRHDRRC
       8   8  Character     8  MRHDRTOD
      16  10  Character     4  *
      20  14  Character     0  MRHDR_END
      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. Includes possible
                                                      live guest relocation quiesce
                                                      time. This count includes all
                                                      processor types. 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. This
                                                      count includes all processor
                                                      types. 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). This count
                                                      includes all processor types.
      48  30  Signed        4  SYTUWT_CALCPURN        Cardinal count of VMDBKs in
                                                      the dispatch list that are
                                                      running on a real processor.
                                                      This count includes all
                                                      processor types.
      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  Unsigned      4  SYTUWT_CALLLCP         Number of VMDBKs that were
                                                      in dispatch list waiting for
                                                      CPU, will be dispatched on a
                                                      central processor, and were
                                                      also on the Limit List but
                                                      prevented from running by max
                                                      share.
      84  54  Unsigned      4  SYTUWT_CALLLZAP        Number of VMDBKs that were
                                                      in dispatch list waiting for
                                                      CPU, will be dispatched on a
                                                      zAAP processor, and were also
                                                      on the Limit List but
                                                      prevented from running by max
                                                      share.
      88  58  Unsigned      4  SYTUWT_CALLLIFL        Number of VMDBKs that were
                                                      in dispatch list waiting for
                                                      CPU, will be dispatched on a
                                                      IFL processor, and were also
                                                      on the Limit List but
                                                      prevented from running by max
                                                      share.
      92  5C  Unsigned      4  SYTUWT_CALLLZIP        Number of VMDBKs that were
                                                      in dispatch list waiting for
                                                      CPU, will be dispatched on a
                                                      zIIP processor, and were also
                                                      on the Limit List but
                                                      prevented from running by max
                                                      share.
      96  60  Signed        4  SYTUWT_CALCFCP         Cardinal count of VMDBKs in
                                                      the dispatch list that were
                                                      in console-function wait and
                                                      are to be dispatched on a
                                                      central processor (CP).
                                                      During such a wait, the
                                                      virtual CPU is not permitted
                                                      to run. Includes possible
                                                      live guest relocation quiesce
                                                      time.
     100  64  Signed        4  SYTUWT_CALCFZAP        Cardinal count of VMDBKs in
                                                      the dispatch list that were
                                                      in console-function wait and
                                                      are to be dispatched on a
                                                      zAAP processor. During such a
                                                      wait, the virtual CPU is not
                                                      permitted to run. Includes
                                                      possible live guest
                                                      relocation quiesce time.
     104  68  Signed        4  SYTUWT_CALCFIFL        Cardinal count of VMDBKs in
                                                      the dispatch list that were
                                                      in console-function wait and
                                                      are to be dispatched on an
                                                      IFL processor. During such a
                                                      wait, the virtual CPU is not
                                                      permitted to run. Includes
                                                      possible live guest
                                                      relocation quiesce time.
     108  6C  Signed        4  SYTUWT_CALCFZIP        Cardinal count of VMDBKs in
                                                      the dispatch list that were
                                                      in console-function wait and
                                                      are to be dispatched on a
                                                      zIIP processor. During such a
                                                      wait, the virtual CPU is not
                                                      permitted to run. Includes
                                                      possible live guest
                                                      relocation quiesce time.
     112  70  Signed        4  SYTUWT_CALSWCP         Cardinal count of VMDBKs in
                                                      the dispatch list that were
                                                      in 'simulation wait' and are
                                                      to be dispatched on a central
                                                      processor (CP). 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.
     116  74  Signed        4  SYTUWT_CALSWZAP        Cardinal count of VMDBKs in
                                                      the dispatch list that were
                                                      in 'simulation wait' and are
                                                      to be dispatched on a zAAP
                                                      processor. 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.
     120  78  Signed        4  SYTUWT_CALSWIFL        Cardinal count of VMDBKs in
                                                      the dispatch list that were
                                                      in 'simulation wait' and are
                                                      to be dispatched on a IFL
                                                      processor. 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.
     124  7C  Signed        4  SYTUWT_CALSWZIP        Cardinal count of VMDBKs in
                                                      the dispatch list that were
                                                      in 'simulation wait' and are
                                                      to be dispatched on a zIIP
                                                      processor. 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.
     128  80  Signed        4  SYTUWT_CALCWCP         Cardinal count of VMDBKs in
                                                      the dispatch list that are
                                                      waiting for a real processor
                                                      (i.e. CPU WAIT) and are to be
                                                      dispatched on a central
                                                      processor (CP).
     132  84  Signed        4  SYTUWT_CALCWZAP        Cardinal count of VMDBKs in
                                                      the dispatch list that are
                                                      waiting for a real processor
                                                      (i.e. CPU WAIT) and are to be
                                                      dispatched on a zAAP
                                                      processor.
     136  88  Signed        4  SYTUWT_CALCWIFL        Cardinal count of VMDBKs in
                                                      the dispatch list that are
                                                      waiting for a real processor
                                                      (i.e. CPU WAIT) and are to be
                                                      dispatched on an IFL
                                                      processor.
     140  8C  Signed        4  SYTUWT_CALCWZIP        Cardinal count of VMDBKs in
                                                      the dispatch list that are
                                                      waiting for a real processor
                                                      (i.e. CPU WAIT) and are to be
                                                      dispatched on a zIIP
                                                      processor.
     144  90  Signed        4  SYTUWT_CALCRCP         Cardinal count of VMDBKs in
                                                      the dispatch list that are
                                                      running on a real central
                                                      processor.
     148  94  Signed        4  SYTUWT_CALCRZAP        Cardinal count of VMDBKs in
                                                      the dispatch list that are
                                                      running on a real zAAP
                                                      processor.
     152  98  Signed        4  SYTUWT_CALCRIFL        Cardinal count of VMDBKs in
                                                      the dispatch list that are
                                                      running on a real IFL
                                                      processor.
     156  9C  Signed        4  SYTUWT_CALCRZIP        Cardinal count of VMDBKs in
                                                      the dispatch list that are
                                                      running on a real zIIP
                                                      processor.
     160  A0  Unsigned      4  SYTUWT_CALLLICF        Number of VMDBKs that were
                                                      in dispatch list waiting for
                                                      CPU, will be dispatched on a
                                                      ICF processor, and were also
                                                      on the Limit List but
                                                      prevented from running by max
                                                      share.
     164  A4  Signed        4  SYTUWT_CALCFICF        Cardinal count of VMDBKs in
                                                      the dispatch list that were
                                                      in console-function wait and
                                                      are to be dispatched on an
                                                      ICF processor. During such a
                                                      wait, the virtual CPU is not
                                                      permitted to run. Includes
                                                      possible live guest
                                                      relocation quiesce time.
     168  A8  Signed        4  SYTUWT_CALSWICF        Cardinal count of VMDBKs in
                                                      the dispatch list that were
                                                      in 'simulation wait' and are
                                                      to be dispatched on a ICF
                                                      processor. 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.
     172  AC  Signed        4  SYTUWT_CALCWICF        Cardinal count of VMDBKs in
                                                      the dispatch list that are
                                                      waiting for a real processor
                                                      (i.e. CPU WAIT) and are to be
                                                      dispatched on an ICF
                                                      processor.
     176  B0  Signed        4  SYTUWT_CALCRICF        Cardinal count of VMDBKs in
                                                      the dispatch list that are
                                                      running on a real ICF
                                                      processor.
     180  B4  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    180
    SYTUWT_CALCFCP            60      4
    SYTUWT_CALCFICF           A4      4
    SYTUWT_CALCFIFL           68      4
    SYTUWT_CALCFWT            24      4
    SYTUWT_CALCFZAP           64      4
    SYTUWT_CALCFZIP           6C      4
    SYTUWT_CALCPURN           30      4
    SYTUWT_CALCPUWT           2C      4
    SYTUWT_CALCRCP            90      4
    SYTUWT_CALCRICF           B0      4
    SYTUWT_CALCRIFL           98      4
    SYTUWT_CALCRZAP           94      4
    SYTUWT_CALCRZIP           9C      4
    SYTUWT_CALCWCP            80      4
    SYTUWT_CALCWICF           AC      4
    SYTUWT_CALCWIFL           88      4
    SYTUWT_CALCWZAP           84      4
    SYTUWT_CALCWZIP           8C      4
    SYTUWT_CALELSVM           3C      4
    SYTUWT_CALIOACT           48      4
    SYTUWT_CALIOWT            1C      4
    SYTUWT_CALLLCP            50      4
    SYTUWT_CALLLICF           A0      4
    SYTUWT_CALLLIFL           58      4
    SYTUWT_CALLLIST           4C      4
    SYTUWT_CALLLZAP           54      4
    SYTUWT_CALLLZIP           5C      4
    SYTUWT_CALOTHR            34      4
    SYTUWT_CALQDISP           38      4
    SYTUWT_CALSIMWT           28      4
    SYTUWT_CALSWCP            70      4
    SYTUWT_CALSWICF           A8      4
    SYTUWT_CALSWIFL           78      4
    SYTUWT_CALSWZAP           74      4
    SYTUWT_CALSWZIP           7C      4
    SYTUWT_CALTIDL            14      4
    SYTUWT_CALTSVM            18      4
    SYTUWT_CALWTPAG           20      4
    SYTUWT_END                B4      0
    SYTUWT_MRHDR               0      0
    SYTUWT_SRMCELIG           40      2
    SYTUWT_SRMDSVMW           44      4

    This information is
    based on z/VM V7R2.0.

    Last updated on 08 August 2020 at 16:02:33.

    Copyright IBM Corporation, 1990, 2020