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 V7R3.0.

Last updated on 09 September 2022 at 14:24:05.
Copyright IBM Corporation, 1990, 2022