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, userids or identifiers of
                   domain specific subsets 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'05' = processor
                                                    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,
                                                    8-char indentifier for processor
                                                    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 V6R1.0.

    Last updated on 9 Aug 2011 at 16:11:13.

    Copyright IBM Corporation, 1990, 2011