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

MRUSEITE

Prolog
Control Block Contents
Cross Reference

MRUSEITE Prolog

 DSECT NAME - USEITE
 FUNCTION - Map a Monitor record.
 LOCATED BY -
        Through the Monitor Control Area
 REFERENCED CONTROL BLOCKS -
        MRRECHDR    Monitor Record Header
 NAME - MRUSEITE
 DESCRIPTIVE NAME - Monitor Event Record
                    Domain 4 - User Domain
                    Record 10 - User Interaction at Transaction End
 DESCRIPTION - Describes a VMDBK's interaction with other VMDBKs
               during a transaction.  A separate record is generated
               for each VMDBK in a virtual complex that contributed
               to the transaction.
 NOTES:
  - Fields labeled by the prefix, 'USEITE_HF', are high-frequency
    counters.
  - The following is the order in which the user is tested for its
    wait state.  If the user is in more than one state, it is
    counted only in the first of the list.
             USEITE_HFIOWT
             USEITE_HFCFWT
             USEITE_HFSIMWT
             USEITE_HFWTPAG
             USEITE_HFLLIST
             USEITE_HFCPUWT
             USEITE_HFCPURN
             USEITE_HFESVM
             USEITE_HFLOAD
             USEITE_HFDORM
             USEITE_HFDSVM
             USEITE_HFIOACT
             USEITE_HFTIDL
             USEITE_HFTSVM
             USEITE_HFPGACT
             USEITE_HFOTHR


MRUSEITE Control Block Contents

Offsets
Dec Hex  Type       Len  Name (Dim)             Description
 
  0   0  Structure  196  USEITE                 Start of monitor record
  0   0  Character    0  USEITE_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  Character    8  USEITE_VMDUSER         User logon identification
 28  1C  Unsigned     2  USEITE_VMDCPUAD        Processor address
 30  1E  Signed       2  USEITE_VMDSLCNT        Count of minor time slices
                                                that have expired since the
                                                start of current transaction.
 32  20  Unsigned     4  USEITE_VMDSVMFX        Number of times the SVM wait
                                                flag was left on at the end of
                                                a transaction and had to be
                                                reset by the scheduler.
 36  24  Character    8  USEITE_VMDSVMID        VMDBK name for the last
                                                successful IUCV, VMCF or
                                                APPC/VM Send for this virtual
                                                machine. Valid in base VMDBK
                                                only.
 44  2C  Bitstring    1  USEITE_VMDSVMWT        Service-virtual-machine (SVM)
                                                wait flag byte - valid in base
                                                VMDBK only.
          1... ....      USEITE_VMDSVMWF        VMDBK is waiting for a
                                                response from IUCV, VMCF, or
                                                APPC.
          .1.. ....      *                      
          ..1. ....      *                      
          ...1 ....      *                      
          .... 1...      *                      
          .... .1..      *                      
          .... ..1.      *                      
          .... ...1      *                      
 45  2D  Character    0  USEITE_VMDSVMW2        Back-up byte to the VMDSVMWT
                                                byte. Its contents will persist
                                                longer than they would in
                                                VMDSVMWT. Valid in base VMDBK
                                                only.
 45  2D  Bitstring    1  USEITE_VMDSVMWT        Service-virtual-machine (SVM)
                                                wait flag byte - valid in base
                                                VMDBK only.
          1... ....      USEITE_VMDSVMWF        VMDBK is waiting for a
                                                response from IUCV, VMCF, or
                                                APPC.
 46  2E  Character    0  USEITE_VMDRDYCM        Flag byte set by IUCV, VMCF,
                                                or APPC whenever IUCV/VMCF/APPC
                                                makes an external interrupt. It
                                                is sort of a "reference bit"
                                                that tells the scheduler that
                                                IUCV/VMCF/APPC has been active
                                                recently. Valid in base VMDBK
                                                only.
 46  2E  Bitstring    1  USEITE_VMDSVMWT        Service-virtual-machine (SVM)
                                                wait flag byte - valid in base
                                                VMDBK only.
          1... ....      USEITE_VMDSVMWF        VMDBK is waiting for a
                                                response from IUCV, VMCF, or
                                                APPC.
 47  2F  Bitstring    1  USEITE_CALFLAG1        Flag byte
          1... ....      USEITE_CALBASE         If on, this is the base
                                                VMDBK. VMDBASE
          .1.. ....      *                      
          ..1. ....      *                      
          ...1 ....      *                      
          .... 1...      *                      
          .... .1..      *                      
          .... ..1.      *                      
          .... ...1      *                      
 48  30  Unsigned     4  USEITE_HFQUCT          Number of times VMDBK was
                                                sampled for high-frequency data
 52  34  Unsigned     4  USEITE_HFDISP0         Number of times the VMDBK was
                                                in Q0. VMDSLIST = VMDDISPL and
                                                VMDELIST = 0.
 56  38  Unsigned     4  USEITE_HFDISP1         Number of times the VMDBK was
                                                in Q1. VMDSLIST = VMDDISPL and
                                                VMDELIST = 1.
 60  3C  Unsigned     4  USEITE_HFDISP2         Number of times the VMDBK was
                                                in Q2. VMDSLIST = VMDDISPL and
                                                VMDELIST = 2.
 64  40  Unsigned     4  USEITE_HFDISP3         Number of times the VMDBK was
                                                in Q3. VMDSLIST = VMDDISPL and
                                                VMDELIST = 3.
 68  44  Unsigned     4  USEITE_HFELIG0         Number of times the VMDBK was
                                                in E0. VMDSLIST = VMDELIG and
                                                VMDELIST = 0.
 72  48  Unsigned     4  USEITE_HFELIG1         Number of times the VMDBK was
                                                in E1. VMDSLIST = VMDELIG and
                                                VMDELIST = 1.
 76  4C  Unsigned     4  USEITE_HFELIG2         Number of times the VMDBK was
                                                in E2. VMDSLIST = VMDELIG and
                                                VMDELIST = 2.
 80  50  Unsigned     4  USEITE_HFELIG3         Number of times the VMDBK was
                                                in E3. VMDSLIST = VMDELIG and
                                                VMDELIST = 3.
 84  54  Unsigned     4  USEITE_HFSTCT          Number of times VMDBK was
                                                high-frequency sampled. This
                                                was once distinguishable from
                                                USEITE_HFQUCT but is now the
                                                same and is retained for
                                                migration and compatibility
                                                purposes.
 88  58  Unsigned     4  USEITE_HFTIDL          Number of times this user was
                                                found in test idle and not in
                                                SVM wait
 92  5C  Unsigned     4  USEITE_HFTSVM          Number of times this user was
                                                found in test idle and in SVM
                                                wait
 96  60  Unsigned     4  USEITE_HFIOWT          Number of times this user was
                                                in I/O wait. I/O wait indicates
                                                that a guest is waiting for I/O
                                                completion status and thus is
                                                prevented from running. VMDIOWT
100  64  Unsigned     4  USEITE_HFCFWT          Number of times this user was
                                                found in console-function wait.
                                                During such a wait, the virtual
                                                cpu is not permitted to run.
                                                VMDCFWT
104  68  Unsigned     4  USEITE_HFSIMWT         Number of times this user was
                                                found in 'simulation wait,' in
                                                which 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
108  6C  Unsigned     4  USEITE_HFWTPAG         Number of times this user was
                                                found in page wait. Page wait
                                                is when 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
112  70  Unsigned     4  USEITE_HFCPUWT         Number of times this user was
                                                found waiting to run on the
                                                real CPU. VMDSTATE = VMDREADY
116  74  Unsigned     4  USEITE_HFCPURN         Number of times this user was
                                                found running on the real CPU.
                                                VMDSTATE = VMDISPCH
120  78  Unsigned     4  USEITE_HFESVM          Number of times this user was
                                                found in SVM wait and in the
                                                eligible list.
124  7C  Unsigned     4  USEITE_HFLOAD          Number of times this user was
                                                considered a loading user.
                                                VMDLOADU is on and VMDSLIST ^=
                                                VMDDORM.
128  80  Unsigned     4  USEITE_HFDORM          Number of times this user was
                                                found dormant. VMDSLIST =
                                                VMDDORM
132  84  Signed       4  USEITE_HFDSVM          Number of times this user was
                                                found in SVM wait and in the
                                                dormant list. Note: this count
                                                is also included in
                                                USEITE_HFDORM. VMDSVMWF of
                                                VMDSVMWT = on and VMDSLIST =
                                                VMDDORM
136  88  Unsigned     4  USEITE_HFOTHR          Number of times this user was
                                                not found in any of the above
                                                states
140  8C  Unsigned     2  USEITE_VMDCNTID        Number of times user was not
                                                granted a test idle time when
                                                it went idle in the dispatch
                                                list
142  8E  Unsigned     2  USEITE_VMDCTIDL        Number of times this user was
                                                granted a test idle time when
                                                it went idle in the dispatch
                                                list
144  90  Unsigned     4  USEITE_VMDDFRWK        Count of 'deferred' work
                                                items for the VMDBK. A
                                                'deferred' work item is an
                                                asynchronous task that has yet
                                                to run. This VMDBK shall be
                                                prevented from completing its
                                                logoff until this count is
                                                zero, i.e., when all such work
                                                items have been run.
148  94  Bitstring    1  USEITE_VMDSTATE        Scheduler/Dispatcher State.
                                                X'63' = Review-suspended. VMDBK
                                                is in transition to the
                                                suspended state. X'58' =
                                                Review-idle. VMDBK is in
                                                transition to the idle state.
                                                X'4D' = VMDBK has been selected
                                                by dispatcher for processing.
                                                X'42' = VMDBK is ready for
                                                selection by dispatcher once it
                                                goes to the dispatch list.
                                                X'37' = Test-idle. VMDBK is
                                                ready for selection by the
                                                dispatcher but should be
                                                dropped from the dispatch list
                                                when selected the next time.
                                                X'08' = VMDBK is suspended,
                                                probably waiting for a
                                                short-term event to occur.
                                                X'00' = VMDBK is idle. No work
                                                is available.
149  95  Bitstring    1  USEITE_CALOSTAT        Virtual machine operating
                                                status
          1... ....      USEITE_VMDSYSOP        User is primary system
                                                operator
          .1.. ....      USEITE_VMDUSRCT        User is counted as being
                                                logged on
          ..1. ....      *                      
          ...1 ....      USEITE_VMDFORCE        User is to be logged off.
                                                This may be requested by CP, a
                                                forced logoff, or user's logoff
                                                command.
          .... 1...      USEITE_VMDUFORC        User is forced to logoff the
                                                system
          .... .1..      USEITE_VMDDISC         User is running disconnected
          .... ..1.      USEITE_VMDAUTOL        AUTOLOG/XAUTOLOG in progress.
                                                User has been automatically
                                                logged on. This bit is set off
                                                when the user's IPL statement
                                                is processed, or (if there is
                                                no IPL to process) when the
                                                user enters a LOGON command
                                                from a terminal to RECONNECT.
          .... ...1      USEITE_VMDXAUTO        The original command was
                                                XAUTOLOG. Valid for the base
                                                VMDBK only.
150  96  Bitstring    1  USEITE_CALRSTAT        Reason(s) the dispatched
                                                VMDBK is not being run
          1... ....      *                      
          .1.. ....      USEITE_VMDCFWT         VMDBK is in console function
                                                wait. Either a console function
                                                is active, or the virtual
                                                machine is waiting for the
                                                remaining VMDBKs in the
                                                configuration to enter console
                                                function mode.
          ..1. ....      USEITE_VMDSIMWT        CP is simulating some
                                                hardware function for the guest
                                                such as instructions,
                                                interrupts, and timer updates.
                                                Virtual machine is prevented
                                                from running to avoid potential
                                                conflicts with the simulations.
          ...1 ....      USEITE_VMDIOWT         Instruction waiting for I/O
                                                status for completion. (May be
                                                cancelled without loss of
                                                system integrity.)
          .... 1...      *                      
          .... .1..      *                      
          .... ..1.      *                      
          .... ...1      *                      
151  97  Unsigned     1  *                      Reserved for IBM use
152  98  Unsigned     2  USEITE_VMDCPRMD(4)     Number of times this user was
                                                pre-emptied from the dispatch
                                                list (Q0, Q1, Q2, Q3) due to a
                                                requirement for storage for E1
                                                users.
160  A0  Unsigned     2  USEITE_VMDCWSGD(4)     Number of times this user was
                                                removed from the dispatch list
                                                (Q0, Q1, Q2, Q3) because it
                                                reached its working set size
                                                growth limit, and its new
                                                working set size would no
                                                longer fit into available
                                                storage.
168  A8  Unsigned     2  USEITE_VMDCETSD(4)     Number of times this user was
                                                removed from the dispatch list
                                                (Q0, Q1, Q2, Q3) because it
                                                reached elapsed time slice end.
176  B0  Unsigned     2  USEITE_VMDCIDLD(4)     Number of times this user was
                                                removed from the dispatch list
                                                (Q0, Q1, Q2, Q3) because its
                                                test idle time had expired or
                                                because it was granted no test
                                                idle time.
184  B8  Unsigned     4  USEITE_HFIOACT         High Frequency Count.
                                                Cardinal number of times the
                                                user had an asynchronous I/O
                                                outstanding, causing the user
                                                to be left in the dispatch
                                                list. VMDIOACT
188  BC  Unsigned     4  USEITE_HFLLIST         High Frequency Count. Number
                                                of times the user was in
                                                dispatch list waiting for CPU
                                                but was on the Limit List,
                                                prevented from running by max
                                                share.
192  C0  Unsigned     4  USEITE_HFPGACT         High Frequency Count. Number
                                                of times the virtual machine
                                                had page fault requests active,
                                                but was not in page wait
                                                (VMDWTPAG was not set). This
                                                would occur if asynchronous
                                                page fault was being used and
                                                there was an outstanding page
                                                fault, but the virtual machine
                                                loaded a wait state because it
                                                had no other work to do. A
                                                virtual machine can have page
                                                faults handled asynchronously
                                                if using the PAGEX feature or
                                                the Page-Fault Handshaking CP
                                                services via the CP PFAULT
                                                MACRO.
196  C4  Character    0  USEITE_END             

MRUSEITE 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
USEITE                     0    196
USEITE_CALBASE            2F           80
USEITE_CALFLAG1           2F      1
USEITE_CALOSTAT           95      1
USEITE_CALRSTAT           96      1
USEITE_END                C4      0
USEITE_HFCFWT             64      4
USEITE_HFCPURN            74      4
USEITE_HFCPUWT            70      4
USEITE_HFDISP0            34      4
USEITE_HFDISP1            38      4
USEITE_HFDISP2            3C      4
USEITE_HFDISP3            40      4
USEITE_HFDORM             80      4
USEITE_HFDSVM             84      4
USEITE_HFELIG0            44      4
USEITE_HFELIG1            48      4
USEITE_HFELIG2            4C      4
USEITE_HFELIG3            50      4
USEITE_HFESVM             78      4
USEITE_HFIOACT            B8      4
USEITE_HFIOWT             60      4
USEITE_HFLLIST            BC      4
USEITE_HFLOAD             7C      4
USEITE_HFOTHR             88      4
USEITE_HFPGACT            C0      4
USEITE_HFQUCT             30      4
USEITE_HFSIMWT            68      4
USEITE_HFSTCT             54      4
USEITE_HFTIDL             58      4
USEITE_HFTSVM             5C      4
USEITE_HFWTPAG            6C      4
USEITE_MRHDR               0      0
USEITE_VMDAUTOL           95           02
USEITE_VMDCETSD           A8      8
USEITE_VMDCFWT            96           40
USEITE_VMDCIDLD           B0      8
USEITE_VMDCNTID           8C      2
USEITE_VMDCPRMD           98      8
USEITE_VMDCPUAD           1C      2
USEITE_VMDCTIDL           8E      2
USEITE_VMDCWSGD           A0      8
USEITE_VMDDFRWK           90      4
USEITE_VMDDISC            95           04
USEITE_VMDFORCE           95           10
USEITE_VMDIOWT            96           10
USEITE_VMDRDYCM           2E      0
USEITE_VMDSIMWT           96           20
USEITE_VMDSLCNT           1E      2
USEITE_VMDSTATE           94      1
USEITE_VMDSVMFX           20      4
USEITE_VMDSVMID           24      8
USEITE_VMDSVMWF           2C           80
USEITE_VMDSVMWF           2D           80
USEITE_VMDSVMWF           2E           80
USEITE_VMDSVMWT           2C      1
USEITE_VMDSVMWT           2D      1
USEITE_VMDSVMWT           2E      1
USEITE_VMDSVMW2           2D      0
USEITE_VMDSYSOP           95           80
USEITE_VMDUFORC           95           08
USEITE_VMDUSER            14      8
USEITE_VMDUSRCT           95           40
USEITE_VMDXAUTO           95           01

This information is based on z/VM V5R2.0.
Last updated on 11 Dec 2005 at 18:48:12.
Copyright IBM Corporation, 1990, 2005