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  260  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..      MTRDEV_ENCRYCAP        When on, device is encryption
                                                    capable.
              .... ..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         Cumulative 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
              ..1. ....      MTRDEV_RDEVHPBA        HyperPAV Base
              ...1 ....      MTRDEV_RDEVHPAL        HyperPAV Alias The above
                                                    fields are mutually exclusive
              .... 1...      MTRDEV_RDEVFREQ        HyperPAV Alias is on the free
                                                    queue
              .... .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  Bitstring    1  MTRDEV_EDEVATTR        EDEV attributes
              1... ....      MTRDEV_EDEVSCSI        General SCSI Attribute
              .1.. ....      MTRDEV_EDEV2105        2105 SCSI Attributes
              ..1. ....      MTRDEV_EDEVFASD        Fibre array storage driver
              ...1 ....      MTRDEV_EDEV2107        2107 SCSI Attributes
              .... 1...      MTRDEV_EDEV1750        1750 SCSI Attributes
              .... .1..      MTRDEV_EDEV2145        2145 SCSI Attributes
              .... ..1.      MTRDEV_EDEVXIV         XIV SCSI Attributes
              .... ...1      *
    242  F2  Unsigned     2  MTRDEV_RDEVHPPL        HyperPAV Pool Number Note:
                                                    This value is only meaningful
                                                    if the MTRDEV_RDEVHPBA or
                                                    MTRDEV_RDEVHPAL flag is set
    244  F4  Character    4  MTRDEV_CALDEVFLAGS
                                                    -------------------------------
                                                    -------------------- Only if
                                                    MTRDEV_EDEVFASD then these bits
                                                    are valid:
                                                    -------------------------------
                                                    --------------------
    244  F4  Bitstring    1  *
              1... ....      *
              .1.. ....      *
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      SZQFCWOB               FASD -cache without batteries
              .... ..1.      SZQFFWT                FASD -force write thru on two
                                                    minute warning from ups
              .... ...1      SZQFCME                FASD -cache mirror enable
    245  F5  Bitstring    1  *
              1... ....      SZQFABPR               FASD -alt ctrl batteries
                                                    present
              .1.. ....      SZQFBPR                FASD -batteries present
              ..1. ....      SZQFACMA               FASD -alt ctrl cache mirror
                                                    active
              ...1 ....      SZQFCMA                FASD -ctrl cache mirror
                                                    active
              .... 1...      SZQFABOK               FASD -alt ctrl batteries ok
              .... .1..      SZQFBOK                FASD -ctrl batteries ok
              .... ..1.      SZQFRCA                FASD -read cache active
              .... ...1      SZQFWCA                FASD -write cache active
    246  F6  Character    2  *                      Reserved and available
                                                    EDEVICE path connection types
                                                    0=not connected/unknown 1=point
                                                    to point 2=switched
                                                    3=arbitrated loop
    248  F8  Unsigned     1  MTRDEV_EDEVPATHCONN1
    249  F9  Unsigned     1  MTRDEV_EDEVPATHCONN2
    250  FA  Unsigned     1  MTRDEV_EDEVPATHCONN3
    251  FB  Unsigned     1  MTRDEV_EDEVPATHCONN4
    252  FC  Unsigned     1  MTRDEV_EDEVPATHCONN5
    253  FD  Unsigned     1  MTRDEV_EDEVPATHCONN6
    254  FE  Unsigned     1  MTRDEV_EDEVPATHCONN7
    255  FF  Unsigned     1  MTRDEV_EDEVPATHCONN8
    256 100  Character    1  MTRDEV_RDCEXFC         Device extended features
              1... ....      *
              .1.. ....      MTRDEV_RDCXRC          Device supports XRC
              ..1. ....      MTRDEV_RDCPPRC         Device supports PPRC CCWs
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
    257 101  Character    3  *                      Reserved and available for
                                                    future IBM use
    260 104  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    260
    MTRDEV_CALDEVFLAGS        F4      4
    MTRDEV_CALFLAGS           2B      1
    MTRDEV_CALMODLN           18      1
    MTRDEV_CALRDEVDEV         44      2
    MTRDEV_CALRDEVSID         40      4
    MTRDEV_CALTHROT           2B           08
    MTRDEV_EDEVATTR           F1      1
    MTRDEV_EDEVFASD           F1           20
    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_EDEVPATHCONN1      F8      1
    MTRDEV_EDEVPATHCONN2      F9      1
    MTRDEV_EDEVPATHCONN3      FA      1
    MTRDEV_EDEVPATHCONN4      FB      1
    MTRDEV_EDEVPATHCONN5      FC      1
    MTRDEV_EDEVPATHCONN6      FD      1
    MTRDEV_EDEVPATHCONN7      FE      1
    MTRDEV_EDEVPATHCONN8      FF      1
    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_EDEVSCSI           F1           80
    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_EDEVXIV            F1           02
    MTRDEV_EDEV1750           F1           08
    MTRDEV_EDEV2105           F1           40
    MTRDEV_EDEV2107           F1           10
    MTRDEV_EDEV2145           F1           04
    MTRDEV_ENCRYCAP           2B           04
    MTRDEV_END               104      0
    MTRDEV_MRHDR               0      0
    MTRDEV_PREFPATH           F0      1
    MTRDEV_RDCEXFC           100      1
    MTRDEV_RDCOBRCO           2D      1
    MTRDEV_RDCPPRC           100           20
    MTRDEV_RDCRCUC            2C      1
    MTRDEV_RDCXRC            100           40
    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_RDEVFREQ           46           08
    MTRDEV_RDEVHPAL           46           10
    MTRDEV_RDEVHPBA           46           20
    MTRDEV_RDEVHPPL           F2      2
    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
    SZQFABOK                  F4           08
    SZQFABPR                  F4           80
    SZQFACMA                  F4           20
    SZQFBOK                   F4           04
    SZQFBPR                   F4           40
    SZQFCMA                   F4           10
    SZQFCME                   F4           01
    SZQFCWOB                  F4           04
    SZQFFWT                   F4           02
    SZQFRCA                   F4           02
    SZQFWCA                   F4           01

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

    Last updated on 20 Mar 2013 at 14:42:13.

    Copyright IBM Corporation, 1990, 2013