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

#### MRMTRDDR

Prolog
Control Block Contents
Cross Reference

#### MRMTRDDR Prolog

####

####

     DSECT NAME - MTRDDR
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRMTRDDR
     DESCRIPTIVE NAME - Monitor Event and Sample Configuration Record
                        Domain 1  - Monitor Domain
                        Record 14 - Domain Detail
     DESCRIPTION - A list of devices or userids that are enabled for
                   monitoring.  A separate record is generated for
                   each applicable event or sample domain.
     NOTES:
     --  The list of items (MTRDDR_DMITEMS) may be spanned across more
         than one MRMTRDDR record.  The flag, MTRDDR_CONT, indicates
         whether the list is continued in the next MRMTRDDR record.
         The record itself will not be spanned across a frame boundary.
         When the spanning of the list becomes necessary, this record
         will be followed by an End-of-Frame record (MRMTREOF, Domain 1,
         Record 13), and the list will be continued in another MRMTRDDR
         record in the next frame.

    MRMTRDDR Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)          Description

      0   0  Structure   28  MTRDDR              Start of monitor record
      0   0  Character    0  MTRDDR_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  MTRDDR_REQUIRED
     20  14  Character    1  MTRDDR_PROFILE      Monitor Profile code for this
                                                 record: 'E' = event record. 'S' =
                                                 sample record.
     21  15  Unsigned     1  MTRDDR_DMNUMBER     Code indicating the domain for
                                                 this record. x'02' = scheduler
                                                 domain. x'04' = user domain. x'06'
                                                 = I/O domain. x'07' = seek domain.
                                                 x'0A' = appldata domain.
     22  16  Bitstring    1  MTRDDR_DMSTATUS     Code pertaining to the contents
                                                 of MTRDDR_DMITEMS table,
                                                 indicating which items of the
                                                 domain are being (or not being)
                                                 monitored: x'80' = all items of
                                                 the domain are being monitored.
                                                 x'40' = all items in the table ---
                                                 and only those so listed---are
                                                 being monitored. x'20' = all items
                                                 EXCEPT those listed in the table
                                                 are being monitored.
     23  17  Bitstring    1  MTRDDR_CALFLAGS     Flag byte
              1... ....      MTRDDR_CONT         OFF = This is the last or only
                                                 record of this set of MRMTRDDR
                                                 records pertaining to the list of
                                                 items for this domain and the
                                                 event or sample profile. ON = The
                                                 list of items (in MTRDDR_DMITEMS),
                                                 continues in the next MRMTRDDR
                                                 record.
              .1.. ....      *
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
     24  18  Signed       4  MTRDDR_DMITEMCT     Number of items in the
                                                 MTRDDR_DMITEMS table in this
                                                 record. Zero if MTRDDR_DMSTATUS =
                                                 x'80'. If the list is spanned
                                                 across more than one record (see
                                                 MTRDDR_CONT), add up all the
                                                 MTRDDR_DMITEMCTs of this set to
                                                 get the total count of the items.
     28  1C  Character    0  MTRDDR_DMITEMS      Table of items of the domain,
                                                 8-char userids for user domain,
                                                 scheduler domain, or appldata
                                                 domain, 2-byte hex device numbers
                                                 for I/O or seek domain. See codes
                                                 in MTRDDR_DMNUMBER and
                                                 MTRDDR_DMSTATUS.

    MRMTRDDR 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
    MTRDDR                  0     28
    MTRDDR_CALFLAGS        17      1
    MTRDDR_CONT            17           80
    MTRDDR_DMITEMCT        18      4
    MTRDDR_DMITEMS         1C      0
    MTRDDR_DMNUMBER        15      1
    MTRDDR_DMSTATUS        16      1
    MTRDDR_MRHDR            0      0
    MTRDDR_PROFILE         14      1
    MTRDDR_REQUIRED        14      8

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

    Last updated on 22 Jul 2003 at 15:04:23.

    Copyright IBM Corporation, 1990, 2003