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  244  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
      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  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  MTRDEV_EDEVTYPE        EDEV emulation type
     72  48  Character    8  MTRDEV_EDEVTABL        SCSI Disk Attributes Table
                                                    Name
     80  50  Character  160  MTRDEV_EDEVPTHS        8 EDEV path triplets
     80  50  Character   20  MTRDEV_EDEVPTH1        Path 1
     80  50  Character    2  *                      Reserved for IBM use
     82  52  Character    2  MTRDEV_EDEVFCP1        FCP device number
     84  54  Character    8  MTRDEV_EDEVWPN1        World wide port number
     92  5C  Character    8  MTRDEV_EDEVLUN1        Logical unit number
    100  64  Character   20  MTRDEV_EDEVPTH2        Path 2
    100  64  Character    2  *                      Reserved for IBM use
    102  66  Character    2  MTRDEV_EDEVFCP2        FCP device number
    104  68  Character    8  MTRDEV_EDEVWPN2        World wide port number
    112  70  Character    8  MTRDEV_EDEVLUN2        Logical unit number
    120  78  Character   20  MTRDEV_EDEVPTH3        Path 3
    120  78  Character    2  *                      Reserved for IBM use
    122  7A  Character    2  MTRDEV_EDEVFCP3        FCP device number
    124  7C  Character    8  MTRDEV_EDEVWPN3        World wide port number
    132  84  Character    8  MTRDEV_EDEVLUN3        Logical unit number
    140  8C  Character   20  MTRDEV_EDEVPTH4        Path 4
    140  8C  Character    2  *                      Reserved for IBM use
    142  8E  Character    2  MTRDEV_EDEVFCP4        FCP device number
    144  90  Character    8  MTRDEV_EDEVWPN4        World wide port number
    152  98  Character    8  MTRDEV_EDEVLUN4        Logical unit number
    160  A0  Character   20  MTRDEV_EDEVPTH5        Path 5
    160  A0  Character    2  *                      Reserved for IBM use
    162  A2  Character    2  MTRDEV_EDEVFCP5        FCP device number
    164  A4  Character    8  MTRDEV_EDEVWPN5        World wide port number
    172  AC  Character    8  MTRDEV_EDEVLUN5        Logical unit number
    180  B4  Character   20  MTRDEV_EDEVPTH6        Path 6
    180  B4  Character    2  *                      Reserved for IBM use
    182  B6  Character    2  MTRDEV_EDEVFCP6        FCP device number
    184  B8  Character    8  MTRDEV_EDEVWPN6        World wide port number
    192  C0  Character    8  MTRDEV_EDEVLUN6        Logical unit number
    200  C8  Character   20  MTRDEV_EDEVPTH7        Path 7
    200  C8  Character    2  *                      Reserved for IBM use
    202  CA  Character    2  MTRDEV_EDEVFCP7        FCP device number
    204  CC  Character    8  MTRDEV_EDEVWPN7        World wide port number
    212  D4  Character    8  MTRDEV_EDEVLUN7        Logical unit number
    220  DC  Character   20  MTRDEV_EDEVPTH8        Path 8
    220  DC  Character    2  *                      Reserved for IBM use
    222  DE  Character    2  MTRDEV_EDEVFCP8        FCP device number
    224  E0  Character    8  MTRDEV_EDEVWPN8        World wide port number
    232  E8  Character    8  MTRDEV_EDEVLUN8        Logical unit number
    240  F0  Bitstring    1  MTRDEV_PREFPATH        Preferred path mask
    241  F1  Character    3  *                      Reserved and available for
                                                    IBM use.
    244  F4  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    244
    MTRDEV_CALFLAGS           2B      1
    MTRDEV_CALMODLN           18      1
    MTRDEV_CALRDEVDEV         44      2
    MTRDEV_CALRDEVSID         40      4
    MTRDEV_CALTHROT           2B           08
    MTRDEV_EDEVFCP1           52      2
    MTRDEV_EDEVFCP2           66      2
    MTRDEV_EDEVFCP3           7A      2
    MTRDEV_EDEVFCP4           8E      2
    MTRDEV_EDEVFCP5           A2      2
    MTRDEV_EDEVFCP6           B6      2
    MTRDEV_EDEVFCP7           CA      2
    MTRDEV_EDEVFCP8           DE      2
    MTRDEV_EDEVLUN1           5C      8
    MTRDEV_EDEVLUN2           70      8
    MTRDEV_EDEVLUN3           84      8
    MTRDEV_EDEVLUN4           98      8
    MTRDEV_EDEVLUN5           AC      8
    MTRDEV_EDEVLUN6           C0      8
    MTRDEV_EDEVLUN7           D4      8
    MTRDEV_EDEVLUN8           E8      8
    MTRDEV_EDEVPTHS           50    160
    MTRDEV_EDEVPTH1           50     20
    MTRDEV_EDEVPTH2           64     20
    MTRDEV_EDEVPTH3           78     20
    MTRDEV_EDEVPTH4           8C     20
    MTRDEV_EDEVPTH5           A0     20
    MTRDEV_EDEVPTH6           B4     20
    MTRDEV_EDEVPTH7           C8     20
    MTRDEV_EDEVPTH8           DC     20
    MTRDEV_EDEVTABL           48      8
    MTRDEV_EDEVTYPE           47      1
    MTRDEV_EDEVWPN1           54      8
    MTRDEV_EDEVWPN2           68      8
    MTRDEV_EDEVWPN3           7C      8
    MTRDEV_EDEVWPN4           90      8
    MTRDEV_EDEVWPN5           A4      8
    MTRDEV_EDEVWPN6           B8      8
    MTRDEV_EDEVWPN7           CC      8
    MTRDEV_EDEVWPN8           E0      8
    MTRDEV_END                F4      0
    MTRDEV_MRHDR               0      0
    MTRDEV_PREFPATH           F0      1
    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 V5R2.0.

    Last updated on 11 Dec 2005 at 20:54:24.

    Copyright IBM Corporation, 1990, 2005