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               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     1  USETRE_VMDPUTYP        Old 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)
 58  3A  Bitstring    1  USETRE_VMDCFGEM        Virtual configuration
                                                indicators. Valid in base VMDBK
                                                only
          1... ....      *                      
          .1.. ....      USETRE_VMDCPUAF        User requested CPU Affinity
          ..1. ....      *                      
          ...1 ....      *                      
          .... 1...      *                      
          .... .1..      *                      
          .... ..1.      *                      
          .... ...1      *                      
 59  3B  Bitstring    1  USETRE_VMDPUST         CPU Status flag
          1... ....      USETRE_VMDAFSUP        CPU Affinity suppressed
          .1.. ....      *                      
          ..1. ....      *                      
          ...1 ....      *                      
          .... 1...      *                      
          .... .1..      *                      
          .... ..1.      *                      
          .... ...1      *                      
 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_VMDAFSUP           3B           80
USETRE_VMDCFGEM           3A      1
USETRE_VMDCPUAD           1C      2
USETRE_VMDCPUAF           3A           40
USETRE_VMDDQTOD           20      8
USETRE_VMDMTTOD           30      8
USETRE_VMDPUST            3B      1
USETRE_VMDPUTYP           39      1
USETRE_VMDSUSCK           28      8
USETRE_VMDUSER            14      8

This information is based on z/VM V5R4.0.
Last updated on 5 Sep 2008 at 09:11:41.
Copyright IBM Corporation, 1990, 2008