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   312  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.        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..        *
          .... ..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
          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    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     3  *                      Reserved and available for
                                                  future IBM use
 312 138  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    312
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_DEVCHAR           134      1
MTRDEV_DEVCHAR_DED       134           80
MTRDEV_DEVCHAR_SSD       134           40
MTRDEV_EDEVATTR           F1      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_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               138      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_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 V6R2.0.
Last updated on 20 Mar 2013 at 14:47:04.
Copyright IBM Corporation, 1990, 2013