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

#### MRIODVON

Prolog
Control Block Contents
Cross Reference

#### MRIODVON Prolog

     DSECT NAME - IODVON
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRIODVON
     DESCRIPTIVE NAME - Monitor Event Record
                        Domain 6 - I/O Domain
                        Record 1 - Vary On Device
     DESCRIPTION - Indicates that a real device has been varied online

#### MRIODVON Control Block Contents

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure   288  IODVON                 Start of monitor record
       0   0  Character     0  IODVON_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  IODVON_RDEVTYPE        Device type code. Unique
                                                      for each device within the
                                                      class in IODVON_RDEVCLAS.
      21  15  Bitstring     1  IODVON_RDEVCLAS        Device class code. Unique
                                                      for each class.
      22  16  Unsigned      2  IODVON_RDEVDVID        Device type number in
                                                      packed decimal. See
                                                      IODVON_RDEVDVIV for its
                                                      source.
      24  18  Bitstring     1  IODVON_CALMODLN        Device model identifier.
                                                      See IODVON_RDEVDVIV flag for
                                                      its source.
      25  19  Bitstring     1  IODVON_RDEVLPM         Logical path mask
      26  1A  Unsigned      2  IODVON_RDEVDEV         Device number
      28  1C  Unsigned      4  IODVON_RDEVSID         Host subchannel id
      32  20  Character     8  IODVON_RDEVCHPS        Eight channel path ids for
                                                      this device
      40  28  Unsigned      2  IODVON_RDEVCUID        control unit id in packed
                                                      decimal. Applicable only when
                                                      IODVON_RDEVCUIV = on.
      42  2A  Unsigned      1  IODVON_RDEVCUMN        Control unit model
                                                      identifier. Applicable only
                                                      when IODVON_RDEVCUIV = on.
      43  2B  Bitstring     1  IODVON_CALFLAGS        Flag Byte
              1... ....        IODVON_RDEVDVIV         OFF = device model number
                                                      (in IODVON_RDEVDVID) and
                                                      model identifier (in
                                                      IODVON_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.. ....        IODVON_RDEVCUIV         When on, Control unit
                                                      information is supplied in
                                                      IODVON_RDEVCUID and
                                                      IODVON_RDEVCUMN.
              ..1. ....        IODVON_ENCRYCAP         When on, device is
                                                      encryption capable.
              ...1 ....        IODVON_EQIEQHSH         When on, user-specified
                                                      EQID information supplied in
                                                      IODVON_EQIEQID
              .... 1...        IODVON_EQIDUHSH         When on, system-generated
                                                      EQID information supplied in
                                                      IODVON_EQIDUID
              .... .1..        *
              .... ..1.        *
              .... ...1        *
      44  2C  Character     1  IODVON_RDCRCUC         Real CU Code
      45  2D  Character     1  IODVON_RDCOBRCO        OBR Code
      46  2E  Character     6  IODVON_RDEVSER         DASD volume serial
                                                      identifier
      52  34  Unsigned      4  IODVON_CALRDEVSID      Host subchannel id of the
                                                      base PAV when RDEVPVAL is on,
                                                      zero otherwise
      56  38  Unsigned      2  IODVON_CALRDEVDEV      Device number of the base
                                                      PAV when RDEVPVAL is on, zero
                                                      otherwise
      58  3A  Bitstring     1  IODVON_RDEVPVFG        PAV flag to indicate base
                                                      and alias DASD
              1... ....        IODVON_RDEVPVBA         PAV base indicator
              .1.. ....        IODVON_RDEVPVAL         PAV alias indicator
              ..1. ....        IODVON_RDEVHPBA         HyperPAV Base
              ...1 ....        IODVON_RDEVHPAL         HyperPAV Alias The above
                                                      fields are mutually exclusive
              .... 1...        IODVON_RDEVFREQ         HyperPAV Alias is on the
                                                      free queue
              .... .1..        IODVON_RDEVESE         Extent Space Efficient
              .... ..1.        *
              .... ...1        *
      59  3B  Bitstring     1  IODVON_EDEVTYPE        EDEV emulation type
      60  3C  Character   160  IODVON_EDEVPTHS        8 EDEV path triplets
      60  3C  Character    20  IODVON_EDEVPTH1        Path 1
      60  3C  Character     1  *                      Reserved for IBM use
      61  3D  Character     1  IODVON_EDEVCHP1        Channel Path ID
      62  3E  Character     2  IODVON_EDEVFCP1        FCP device number
      64  40  Character     8  IODVON_EDEVWPN1        World wide port number
      72  48  Character     8  IODVON_EDEVLUN1        Logical unit number
      80  50  Character    20  IODVON_EDEVPTH2        Path 2
      80  50  Character     1  *                      Reserved for IBM use
      81  51  Character     1  IODVON_EDEVCHP2        Channel Path ID
      82  52  Character     2  IODVON_EDEVFCP2        FCP device number
      84  54  Character     8  IODVON_EDEVWPN2        World wide port number
      92  5C  Character     8  IODVON_EDEVLUN2        Logical unit number
     100  64  Character    20  IODVON_EDEVPTH3        Path 3
     100  64  Character     1  *                      Reserved for IBM use
     101  65  Character     1  IODVON_EDEVCHP3        Channel Path ID
     102  66  Character     2  IODVON_EDEVFCP3        FCP device number
     104  68  Character     8  IODVON_EDEVWPN3        World wide port number
     112  70  Character     8  IODVON_EDEVLUN3        Logical unit number
     120  78  Character    20  IODVON_EDEVPTH4        Path 4
     120  78  Character     1  *                      Reserved for IBM use
     121  79  Character     1  IODVON_EDEVCHP4        Channel Path ID
     122  7A  Character     2  IODVON_EDEVFCP4        FCP device number
     124  7C  Character     8  IODVON_EDEVWPN4        World wide port number
     132  84  Character     8  IODVON_EDEVLUN4        Logical unit number
     140  8C  Character    20  IODVON_EDEVPTH5        Path 5
     140  8C  Character     1  *                      Reserved for IBM use
     141  8D  Character     1  IODVON_EDEVCHP5        Channel Path ID
     142  8E  Character     2  IODVON_EDEVFCP5        FCP device number
     144  90  Character     8  IODVON_EDEVWPN5        World wide port number
     152  98  Character     8  IODVON_EDEVLUN5        Logical unit number
     160  A0  Character    20  IODVON_EDEVPTH6        Path 6
     160  A0  Character     1  *                      Reserved for IBM use
     161  A1  Character     1  IODVON_EDEVCHP6        Channel Path ID
     162  A2  Character     2  IODVON_EDEVFCP6        FCP device number
     164  A4  Character     8  IODVON_EDEVWPN6        World wide port number
     172  AC  Character     8  IODVON_EDEVLUN6        Logical unit number
     180  B4  Character    20  IODVON_EDEVPTH7        Path 7
     180  B4  Character     1  *                      Reserved for IBM use
     181  B5  Character     1  IODVON_EDEVCHP7        Channel Path ID
     182  B6  Character     2  IODVON_EDEVFCP7        FCP device number
     184  B8  Character     8  IODVON_EDEVWPN7        World wide port number
     192  C0  Character     8  IODVON_EDEVLUN7        Logical unit number
     200  C8  Character    20  IODVON_EDEVPTH8        Path 8
     200  C8  Character     1  *                      Reserved for IBM use
     201  C9  Character     1  IODVON_EDEVCHP8        Channel Path ID
     202  CA  Character     2  IODVON_EDEVFCP8        FCP device number
     204  CC  Character     8  IODVON_EDEVWPN8        World wide port number
     212  D4  Character     8  IODVON_EDEVLUN8        Logical unit number
     220  DC  Bitstring     1  IODVON_PREFPATH        Preferred path mask
     221  DD  Character     3  *                      Reserved and available for
                                                      IBM use.
     224  E0  Unsigned      2  IODVON_RDEVHPPL        HyperPAV Pool Number Note:
                                                      This value is only meaningful
                                                      if the IODVON_RDEVHPBA or
                                                      IODVON_RDEVHPAL flag is set
     226  E2  Unsigned      2  IODVON_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.
     228  E4  Character    40  IODVON_EQIDUID         System-generated EQID
     268 10C  Character     8  IODVON_EQIEQID         User-specified EQID
     276 114  Bitstring     1  IODVON_DEVCHAR         Device Characteristics
              1... ....        IODVON_DEVCHAR_DED      Encrypted Device
              .1.. ....        IODVON_DEVCHAR_SSD      Solid-State Drive
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
     277 115  Bitstring     1  IODVON_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... ....        IODVON_EDEVSCSI         General SCSI Attributes
              .1.. ....        IODVON_EDEV2105         2105 SCSI Attributes
              ..1. ....        IODVON_EDEVFASD         Fibre Array Storage
              ...1 ....        IODVON_EDEV2107         2107 SCSI Attributes
              .... 1...        IODVON_EDEV1750         1750 SCSI Attributes
              .... .1..        IODVON_EDEV2145         2145 SCSI Attributes
              .... ..1.        IODVON_EDEVXIV          XIV SCSI Attributes
              .... ...1        IODVON_EDEVFLSH         Flash SCSI Attributes
     278 116  Unsigned      1  IODVON_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
     279 117  Character     1  *                      Reserved and available for
                                                      future IBM use
     280 118  Unsigned      4  IODVON_RDEVMEXT        Maximum cylinder/block
     284 11C  Character     4  *                      Reserved for future use
     288 120  Character     0  IODVON_END

#### MRIODVON Cross Reference

                          Hex           Hex
    Name                  Offset Length Value

    IODVON                     0    288
    IODVON_CALFLAGS           2B      1
    IODVON_CALMODLN           18      1
    IODVON_CALRDEVDEV         38      2
    IODVON_CALRDEVSID         34      4
    IODVON_CUIDSSID           E2      2
    IODVON_DEVCHAR           114      1
    IODVON_DEVCHAR_DED       114           80
    IODVON_DEVCHAR_SSD       114           40
    IODVON_EDEVATTR          115      1
    IODVON_EDEVATTV          116      1
    IODVON_EDEVCHP1           3D      1
    IODVON_EDEVCHP2           51      1
    IODVON_EDEVCHP3           65      1
    IODVON_EDEVCHP4           79      1
    IODVON_EDEVCHP5           8D      1
    IODVON_EDEVCHP6           A1      1
    IODVON_EDEVCHP7           B5      1
    IODVON_EDEVCHP8           C9      1
    IODVON_EDEVFASD          115           20
    IODVON_EDEVFCP1           3E      2
    IODVON_EDEVFCP2           52      2
    IODVON_EDEVFCP3           66      2
    IODVON_EDEVFCP4           7A      2
    IODVON_EDEVFCP5           8E      2
    IODVON_EDEVFCP6           A2      2
    IODVON_EDEVFCP7           B6      2
    IODVON_EDEVFCP8           CA      2
    IODVON_EDEVFLSH          115           01
    IODVON_EDEVLUN1           48      8
    IODVON_EDEVLUN2           5C      8
    IODVON_EDEVLUN3           70      8
    IODVON_EDEVLUN4           84      8
    IODVON_EDEVLUN5           98      8
    IODVON_EDEVLUN6           AC      8
    IODVON_EDEVLUN7           C0      8
    IODVON_EDEVLUN8           D4      8
    IODVON_EDEVPTHS           3C    160
    IODVON_EDEVPTH1           3C     20
    IODVON_EDEVPTH2           50     20
    IODVON_EDEVPTH3           64     20
    IODVON_EDEVPTH4           78     20
    IODVON_EDEVPTH5           8C     20
    IODVON_EDEVPTH6           A0     20
    IODVON_EDEVPTH7           B4     20
    IODVON_EDEVPTH8           C8     20
    IODVON_EDEVSCSI          115           80
    IODVON_EDEVTYPE           3B      1
    IODVON_EDEVWPN1           40      8
    IODVON_EDEVWPN2           54      8
    IODVON_EDEVWPN3           68      8
    IODVON_EDEVWPN4           7C      8
    IODVON_EDEVWPN5           90      8
    IODVON_EDEVWPN6           A4      8
    IODVON_EDEVWPN7           B8      8
    IODVON_EDEVWPN8           CC      8
    IODVON_EDEVXIV           115           02
    IODVON_EDEV1750          115           08
    IODVON_EDEV2105          115           40
    IODVON_EDEV2107          115           10
    IODVON_EDEV2145          115           04
    IODVON_ENCRYCAP           2B           20
    IODVON_END               120      0
    IODVON_EQIDUHSH           2B           08
    IODVON_EQIDUID            E4     40
    IODVON_EQIEQHSH           2B           10
    IODVON_EQIEQID           10C      8
    IODVON_MRHDR               0      0
    IODVON_PREFPATH           DC      1
    IODVON_RDCOBRCO           2D      1
    IODVON_RDCRCUC            2C      1
    IODVON_RDEVCHPS           20      8
    IODVON_RDEVCLAS           15      1
    IODVON_RDEVCUID           28      2
    IODVON_RDEVCUIV           2B           40
    IODVON_RDEVCUMN           2A      1
    IODVON_RDEVDEV            1A      2
    IODVON_RDEVDVID           16      2
    IODVON_RDEVDVIV           2B           80
    IODVON_RDEVESE            3A           04
    IODVON_RDEVFREQ           3A           08
    IODVON_RDEVHPAL           3A           10
    IODVON_RDEVHPBA           3A           20
    IODVON_RDEVHPPL           E0      2
    IODVON_RDEVLPM            19      1
    IODVON_RDEVMEXT          118      4
    IODVON_RDEVPVAL           3A           40
    IODVON_RDEVPVBA           3A           80
    IODVON_RDEVPVFG           3A      1
    IODVON_RDEVSER            2E      6
    IODVON_RDEVSID            1C      4
    IODVON_RDEVTYPE           14      1
    MRHDR                      0     20
    MRHDR_END                 14      0
    MRHDRDM                    4      1
    MRHDRLEN                   0      2
    MRHDRRC                    6      2
    MRHDRTOD                   8      8
    MRHDRZER                   2      2

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

    Last updated on 01 September 2021 at 16:24:09.

    Copyright IBM Corporation, 1990, 2021