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
       2   2  Unsigned      2  MRHDRZER
       4   4  Unsigned      1  MRHDRDM
       5   5  Unsigned      1  *
       6   6  Unsigned      2  MRHDRRC
       8   8  Character     8  MRHDRTOD
      16  10  Character     4  *
      20  14  Character     0  MRHDR_END
      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. x'00' = all items
                                                      are not being monitored.
                                                      Note: This flag does not
                                                      indicate the status of PCIF
                                                      class. The status of PCIF
                                                      class is indicated by
                                                      MTRDDR_PCIST.
      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.. ....        MTRDDR_PCIST            OFF = PCIF class is
                                                      disabled. Note that this bit
                                                      is only valid for EVENT IO
                                                      and SAMPLE IO. Since a user
                                                      can only enable PCIF class
                                                      for those two domains. ON =
                                                      PCIF class is enabled. Note
                                                      that this bit is only valid
                                                      for EVENT IO and SAMPLE IO.
                                                      Since a user can only enable
                                                      PCIF class for those two
                                                      domains.
              ..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
                                                      identifier 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_PCIST              17           40
    MTRDDR_PROFILE            14      1
    MTRDDR_REQUIRED           14      8

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

    Last updated on 09 August 2020 at 15:12:23.

    Copyright IBM Corporation, 1990, 2020