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               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. 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.
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.
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.
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.
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.
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 V6R1.0.
Last updated on 8 Oct 2009 at 21:08:13.
Copyright IBM Corporation, 1990, 2009