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  228  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               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  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 in packed
                                                    decimal
     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 ....      *
              .... 1...      *
              .... .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..      *
              .... ..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    2  *                      Reserved for IBM use
     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    2  *                      Reserved for IBM use
     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    2  *                      Reserved for IBM use
    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    2  *                      Reserved for IBM use
    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    2  *                      Reserved for IBM use
    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    2  *                      Reserved for IBM use
    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    2  *                      Reserved for IBM use
    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    2  *                      Reserved for IBM use
    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  *                      Reserved and available for
                                                    IBM use.
    228  E4  Character    0  IODVON_END

    MRIODVON Cross Reference

                          Hex           Hex
    Name                 Offset Length Value

    IODVON                     0    228
    IODVON_CALFLAGS           2B      1
    IODVON_CALMODLN           18      1
    IODVON_CALRDEVDEV         38      2
    IODVON_CALRDEVSID         34      4
    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_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_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_ENCRYCAP           2B           20
    IODVON_END                E4      0
    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_RDEVFREQ           3A           08
    IODVON_RDEVHPAL           3A           10
    IODVON_RDEVHPBA           3A           20
    IODVON_RDEVHPPL           E0      2
    IODVON_RDEVLPM            19      1
    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 V6R1.0.

    Last updated on 8 Oct 2009 at 21:08:13.

    Copyright IBM Corporation, 1990, 2009