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   320  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
      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.        MTRDEV_EQIEQHSH         When on, user-specified
                                                      EQID information supplied in
                                                      MTRDEV_EQIEQID
              .... ...1        MTRDEV_EQIDUHSH         When on, system-generated
                                                      EQID information supplied in
                                                      MTRDEV_EQIDUID
      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..        MTRDEV_RDEVESE         Extent Space Efficient
              .... ..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     1  *                      Reserved for IBM use
      81  51  Character     1  MTRDEV_EDEVCHP1        Channel Path ID
      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     1  *                      Reserved for IBM use
     101  65  Character     1  MTRDEV_EDEVCHP2        Channel Path ID
     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     1  *                      Reserved for IBM use
     121  79  Character     1  MTRDEV_EDEVCHP3        Channel Path ID
     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     1  *                      Reserved for IBM use
     141  8D  Character     1  MTRDEV_EDEVCHP4        Channel Path ID
     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     1  *                      Reserved for IBM use
     161  A1  Character     1  MTRDEV_EDEVCHP5        Channel Path ID
     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     1  *                      Reserved for IBM use
     181  B5  Character     1  MTRDEV_EDEVCHP6        Channel Path ID
     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     1  *                      Reserved for IBM use
     201  C9  Character     1  MTRDEV_EDEVCHP7        Channel Path ID
     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     1  *                      Reserved for IBM use
     221  DD  Character     1  MTRDEV_EDEVCHP8        Channel Path ID
     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
                                                      This deprecated field reports
                                                      the previous bit settings that
                                                      were used to record the EDEVICE
                                                      attribute. The EDEVATTV field
                                                      field provides the equivalent
                                                      information and leaves room
                                                      for expansion.
              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        MTRDEV_EDEVFLSH         FLASH SCSI Attributes
     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  Unsigned      1  MTRDEV_EDEVATTV        EDEV Attribute value
                                                      1 - General SCSI
                                                      2 - 2105 SCSI
                                                      3 - Fibre Array Storage
                                                      4 - 2107 SCSI
                                                      5 - 1750 SCSI
                                                      6 - 2145 SCSI
                                                      7 - XIV SCSI
                                                      8 - Flash SCSI
     258 102  Character     2  *                      Reserved and available for
                                                      future IBM use
     260 104  Character    40  MTRDEV_EQIDUID         System-generated EQID
     300 12C  Character     8  MTRDEV_EQIEQID         User-specified EQID
     308 134  Bitstring     1  MTRDEV_DEVCHAR         Device Characteristics
              1... ....        MTRDEV_DEVCHAR_DED      Encrypted Device
              .1.. ....        MTRDEV_DEVCHAR_SSD      Solid-State Drive
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
     309 135  Character     1  *                      Reserved and available for
                                                      future IBM use
     310 136  Unsigned      2  MTRDEV_CUIDSSID        If the device is a DASD
                                                      this field contains the
                                                      subsystem ID (SSID). If the
                                                      device is a non-DASD this
                                                      field contains binary zeroes.
     312 138  Unsigned      4  MTRDEV_RDEVMEXT        Maximum cylinder/block
     316 13C  Character     4  *                      Reserved for future use
     320 140  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    320
    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_CUIDSSID          136      2
    MTRDEV_DEVCHAR           134      1
    MTRDEV_DEVCHAR_DED       134           80
    MTRDEV_DEVCHAR_SSD       134           40
    MTRDEV_EDEVATTR           F1      1
    MTRDEV_EDEVATTV          101      1
    MTRDEV_EDEVCHP1           51      1
    MTRDEV_EDEVCHP2           65      1
    MTRDEV_EDEVCHP3           79      1
    MTRDEV_EDEVCHP4           8D      1
    MTRDEV_EDEVCHP5           A1      1
    MTRDEV_EDEVCHP6           B5      1
    MTRDEV_EDEVCHP7           C9      1
    MTRDEV_EDEVCHP8           DD      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_EDEVFLSH           F1           01
    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               140      0
    MTRDEV_EQIDUHSH           2B           01
    MTRDEV_EQIDUID           104     40
    MTRDEV_EQIEQHSH           2B           02
    MTRDEV_EQIEQID           12C      8
    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_RDEVESE            46           04
    MTRDEV_RDEVFREQ           46           08
    MTRDEV_RDEVHPAL           46           10
    MTRDEV_RDEVHPBA           46           20
    MTRDEV_RDEVHPPL           F2      2
    MTRDEV_RDEVLPM            19      1
    MTRDEV_RDEVMEXT          138      4
    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 V7R2.0.

    Last updated on 31 August 2021 at 17:36:21.

    Copyright IBM Corporation, 1990, 2021