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

#### MRMTRECM

Prolog
Control Block Contents
Storage Layout
Cross Reference

#### MRMTRECM Prolog

####

####

     DSECT NAME - MTRECM
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRMTRECM
     DESCRIPTIVE NAME - Monitor Event Record
                        Domain 1 - Monitor Domain
                        Record 2 - Event Alteration command
     DESCRIPTION - Text of a MONITOR EVENT command that was issued after
                   monitor event data collection was started.  All
                   MONITOR EVENT commands except MONITOR EVENT START
                   and MONITOR EVENT STOP are recorded, and in separate
                   records.
     NOTES:
        - The timestamp, MRHDRTOD, in the record's header also reflects
          the time the command was issued.

    MRMTRECM Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)          Description

      0   0  Structure   24  MTRECM              Start of monitor record
      0   0  Character   24  MTRECM_STATIC
      0   0  Character    0  MTRECM_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  Unsigned     4  MTRECM_CALBYCT      length, in bytes, of data in
                                                 MTRECM_CALCMD
     24  18  Character    0  MTRECM_CALCMD       Text of command, starting with
                                                 the word, 'MONITOR'. Regardless of
                                                 how the command word, 'MONITOR',
                                                 was entered on the command line,
                                                 it is expanded to its full word in
                                                 the record.

    MRMTRECM 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
    MTRECM                  0     24
    MTRECM_CALBYCT         14      4
    MTRECM_CALCMD          18      0
    MTRECM_MRHDR            0      0
    MTRECM_STATIC           0     24

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

    Last updated on 1 May 2002 at 16:20:33.

    Copyright IBM Corporation, 1990, 2002