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

#### MRUSETRE

Prolog
Control Block Contents
Cross Reference

#### MRUSETRE Prolog

####

####

     DSECT NAME - USETRE
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRUSETRE
     DESCRIPTIVE NAME - Monitor Event Record
                        Domain 4 - User Domain
                        Record 8 - User Transaction End
     DESCRIPTION - Provides dispatch and suspend times for a VMDBK.
                   A separate record is generated for each VMDBK in a
                   virtual complex that contributed to the transaction.

    MRUSETRE Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

      0   0  Structure   60  USETRE                 Start of monitor record
      0   0  Character    0  USETRE_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  USETRE_VMDUSER         User logon identification
     28  1C  Unsigned     2  USETRE_VMDCPUAD        Processor address
     30  1E  Character    2  USETRE_CALTRIV         'YE' = trivial transaction.
                                                    'NO' = non-trivial translation
     32  20  Character    8  USETRE_VMDDQTOD        Time of day clock at the time
                                                    that the VMDBK was dropped from
                                                    the dispatch list
     40  28  Character    8  USETRE_VMDSUSCK        Time of day clock at the time
                                                    the VMDBK was last marked
                                                    suspended
     48  30  Character    8  USETRE_VMDMTTOD        Time of day clock when the
                                                    last transaction started
     56  38  Bitstring    1  USETRE_CALFLAG1        Flag byte
              1... ....      USETRE_CALBASE         If on, this is the base
                                                    VMDBK. VMDBASE
              .1.. ....      *
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
     57  39  Unsigned     3  *                      Reserved for IBM use
     60  3C  Character    0  USETRE_END

    MRUSETRE 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
    USETRE                     0     60
    USETRE_CALBASE            38           80
    USETRE_CALFLAG1           38      1
    USETRE_CALTRIV            1E      2
    USETRE_END                3C      0
    USETRE_MRHDR               0      0
    USETRE_VMDCPUAD           1C      2
    USETRE_VMDDQTOD           20      8
    USETRE_VMDMTTOD           30      8
    USETRE_VMDSUSCK           28      8
    USETRE_VMDUSER            14      8

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

    Last updated on 11 Dec 2005 at 20:46:09.

    Copyright IBM Corporation, 1990, 2005