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   200  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
       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  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'2C'
                                                      = 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  Unsigned      1  USEITE_VMDPUTYP        CPU Type. Valid values:
                                                      X'00' - General Purpose (CP)
                                                      X'02' - zSeries Application
                                                      Assist (zAAP) X'03' -
                                                      Integrated Facility for Linux
                                                      (IFL) X'04' - Internal
                                                      Coupling Facility (ICF) X'05'
                                                      - zSeries Integrated
                                                      Information (zIIP)
     197  C5  Bitstring     1  USEITE_VMDCFGEM        Virtual configuration
                                                      indicators. Valid in base
                                                      VMDBK only
              1... ....        *
              .1.. ....        USEITE_VMDCPUAF         User requested CPU
                                                      Affinity
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
     198  C6  Bitstring     1  USEITE_VMDPUST         CPU Status flag
              1... ....        USEITE_VMDAFSUP         CPU Affinity suppressed
              .1.. ....        *
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
     199  C7  Character     1  *                      Reserved for IBM use
     200  C8  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    200
    USEITE_CALBASE            2F           80
    USEITE_CALFLAG1           2F      1
    USEITE_CALOSTAT           95      1
    USEITE_CALRSTAT           96      1
    USEITE_END                C8      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_VMDAFSUP           C6           80
    USEITE_VMDAUTOL           95           02
    USEITE_VMDCETSD           A8      8
    USEITE_VMDCFGEM           C5      1
    USEITE_VMDCFWT            96           40
    USEITE_VMDCIDLD           B0      8
    USEITE_VMDCNTID           8C      2
    USEITE_VMDCPRMD           98      8
    USEITE_VMDCPUAD           1C      2
    USEITE_VMDCPUAF           C5           40
    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_VMDPUST            C6      1
    USEITE_VMDPUTYP           C4      1
    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 V7R2.0.

    Last updated on 08 August 2020 at 14:46:08.

    Copyright IBM Corporation, 1990, 2020