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
Storage Layout
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            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  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 V4R2.0.
Last updated on 15 Oct 2001 at 08:04:23.
Copyright IBM Corporation, 1990, 2001