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

#### MRMTRDEV

Prolog
Control Block Contents
Cross Reference

#### MRMTRDEV Prolog

####

####

     DSECT NAME - MTRDEV
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     Deleted By -
            HCPMNNRF      Free the DCSS When All Records Are Processed
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRMTRDEV
     DESCRIPTIVE NAME - Monitor Sample Configuration Record
                        Domain 1 - Monitor Domain
                        Record 6 - Device Configuration Data
     DESCRIPTION - Describes the configuration of a real device.  A
                   separate record is generated for each real device
                   defined to the system.
     NOTES:
      -  If the device is offline (see MTRDEV_RDEVOFFL),
         only the following fields will be valid:
              MTRDEV_MRHDR
              MTRDEV_RDEVTYPE
              MTRDEV_RDEVCLAS
              MTRDEV_RDEVDEV
              MTRDEV_RDEVSHAR
              MTRDEV_RDEVSER

    MRMTRDEV Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)          Description

      0   0  Structure   72  MTRDEV              Start of monitor record
      0   0  Character    0  MTRDEV_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  Bitstring    1  MTRDEV_RDEVTYPE     Device type code. Unique for
                                                 each device within the class in
                                                 MTRDEV_RDEVCLAS.
     21  15  Bitstring    1  MTRDEV_RDEVCLAS     Device class code. Unique for
                                                 each class.
     22  16  Unsigned     2  MTRDEV_RDEVDVID     Device type number in packed
                                                 decimal. See MTRDEV_RDEVDVIV for
                                                 its source.
     24  18  Unsigned     1  MTRDEV_CALMODLN     Device model identifier. See
                                                 MTRDEV_RDEVDVIV flag for its
                                                 source.
     25  19  Bitstring    1  MTRDEV_RDEVLPM      Logical path mask
     26  1A  Unsigned     2  MTRDEV_RDEVDEV      Device number in packed decimal
     28  1C  Unsigned     4  MTRDEV_RDEVSID      Host subchannel id
     32  20  Character    8  MTRDEV_RDEVCHPS     Eight channel path ids for this
                                                 device
     40  28  Unsigned     2  MTRDEV_RDEVCUID     control unit id in packed
                                                 decimal. Applicable only when
                                                 MTRDEV_RDEVCUIV = on.
     42  2A  Unsigned     1  MTRDEV_RDEVCUMN     Control unit model identifier.
                                                 Applicable only when
                                                 MTRDEV_RDEVCUIV = on.
     43  2B  Bitstring    1  MTRDEV_CALFLAGS     Flag Byte
              1... ....      MTRDEV_RDEVDVIV     OFF = device model number (in
                                                 MTRDEV_RDEVDVID) and model
                                                 identifier (in MTRDEV_CALMODLN)
                                                 were provided by user through the
                                                 RDEVICE macro or device sensing at
                                                 IPL time. ON = device type number
                                                 and model identifier were provided
                                                 by the device at device
                                                 initialization time.
              .1.. ....      MTRDEV_RDEVCUIV     When on, control unit
                                                 information is supplied in
                                                 MTRDEV_RDEVCUID and
                                                 MTRDEV_RDEVCUMN.
              ..1. ....      MTRDEV_RDEVOFFL     OFF = Device is online. ON =
                                                 Device is offline.
              ...1 ....      MTRDEV_RDEVSHAR     OFF = This is a CP-owned CPVOL.
                                                 ON = This is a shared CPVOL.
                                                 Applicable only if this record
                                                 represents a CPVOL device (see
                                                 MTRDEV_RDEVCLAS and/or
                                                 MTRDEV_RDEVDVID).
              .... 1...      MTRDEV_CALTHROT     OFF = Device is not throttled ON
                                                 = Device is throttled
              .... .1..      *
              .... ..1.      *
              .... ...1      *
     44  2C  Character    1  MTRDEV_RDCRCUC      Real CU Code
     45  2D  Character    1  MTRDEV_RDCOBRCO     OBR Code
     46  2E  Character    6  MTRDEV_RDEVSER      DASD volume serial identifier
     52  34  Unsigned     4  MTRDEV_THRDLYS      Cummulative count of the number
                                                 of times I/O was delayed for a
                                                 throttled device.
     56  38  Character    8  MTRDEV_THRIORTE     I/O rate expressed as the TOD
                                                 clock increment between I/O
                                                 operations.
     64  40  Unsigned     4  MTRDEV_CALRDEVSID   Host subchannel id of the base
                                                 PAV when RDEVPVAL is on, zero
                                                 otherwise
     68  44  Unsigned     2  MTRDEV_CALRDEVDEV   Device number of the base PAV
                                                 when RDEVPVAL is on, zero
                                                 otherwise
     70  46  Bitstring    1  MTRDEV_RDEVPVFG     PAV flag to indicate base and
                                                 alias DASD
              1... ....      MTRDEV_RDEVPVBA     PAV base indicator
              .1.. ....      MTRDEV_RDEVPVAL     PAV alias indicator Bases and
                                                 aliases are mutually exclusive
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
     71  47  Bitstring    1  *                   Reserved and available for IBM
                                                 use
     72  48  Character    0  MTRDEV_END

    MRMTRDEV 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
    MTRDEV                  0     72
    MTRDEV_CALFLAGS        2B      1
    MTRDEV_CALMODLN        18      1
    MTRDEV_CALRDEVDEV      44      2
    MTRDEV_CALRDEVSID      40      4
    MTRDEV_CALTHROT        2B           08
    MTRDEV_END             48      0
    MTRDEV_MRHDR            0      0
    MTRDEV_RDCOBRCO        2D      1
    MTRDEV_RDCRCUC         2C      1
    MTRDEV_RDEVCHPS        20      8
    MTRDEV_RDEVCLAS        15      1
    MTRDEV_RDEVCUID        28      2
    MTRDEV_RDEVCUIV        2B           40
    MTRDEV_RDEVCUMN        2A      1
    MTRDEV_RDEVDEV         1A      2
    MTRDEV_RDEVDVID        16      2
    MTRDEV_RDEVDVIV        2B           80
    MTRDEV_RDEVLPM         19      1
    MTRDEV_RDEVOFFL        2B           20
    MTRDEV_RDEVPVAL        46           40
    MTRDEV_RDEVPVBA        46           80
    MTRDEV_RDEVPVFG        46      1
    MTRDEV_RDEVSER         2E      6
    MTRDEV_RDEVSHAR        2B           10
    MTRDEV_RDEVSID         1C      4
    MTRDEV_RDEVTYPE        14      1
    MTRDEV_THRDLYS         34      4
    MTRDEV_THRIORTE        38      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