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

#### MRIODSTC

Prolog
Control Block Contents
Cross Reference

#### MRIODSTC Prolog

####

####

     DSECT NAME - IODSTC
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRIODSTC
     DESCRIPTIVE NAME - Monitor Event Record
                        Domain  6 - I/O Domain
                        Record 20 - State Change
     DESCRIPTION - Indicates that a real device has generated a state
                   change.
     NOTES -
      Codes defined for IODSTC_CALCODE:
       IODSTC_CALCODE_00: '00'X Reserved
       IODSTC_CALCODE_BS: '01'X Result of a PSF order X'1F' -
                                  manage alias
       IODSTC_CALCODE_1E: '02'X Result of a x'1E' -
                                  PAC state change unit check

    MRIODSTC Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

      0   0  Structure   68  IODSTC                 Start of monitor record
      0   0  Character    0  IODSTC_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  Unsigned     1  IODSTC_CALCODE         State change type code See
                                                    defined code values above
     21  15  Bitstring    1  *                      Reserved and available for
                                                    IBM use
     22  16  Unsigned     2  *                      Reserved and available for
                                                    IBM use
     24  18  Bitstring    1  IODSTC_RDEVTYPE        Device type code. Unique for
                                                    each device within the class in
                                                    IODSTC_RDEVCLAS.
     25  19  Bitstring    1  IODSTC_RDEVCLAS        Device class code. Unique for
                                                    each class.
     26  1A  Unsigned     2  IODSTC_RDEVDVID        Device type number in packed
                                                    decimal. See IODSTC_RDEVDVIV
                                                    for its source.
     28  1C  Bitstring    1  IODSTC_CALMODLN        Device model identifier. See
                                                    IODSTC_RDEVDVIV flag for its
                                                    source.
     29  1D  Bitstring    1  IODSTC_RDEVLPM         Logical path mask
     30  1E  Unsigned     2  IODSTC_RDEVDEV         Device number in packed
                                                    decimal
     32  20  Unsigned     4  IODSTC_RDEVSID         Host subchannel id
     36  24  Character    8  IODSTC_RDEVCHPS        Eight channel path ids for
                                                    this device
     44  2C  Unsigned     2  IODSTC_RDEVCUID        control unit id in packed
                                                    decimal. Applicable only when
                                                    IODSTC_RDEVCUIV = on.
     46  2E  Unsigned     1  IODSTC_RDEVCUMN        Control unit model
                                                    identifier. Applicable only
                                                    when IODSTC_RDEVCUIV = on.
     47  2F  Bitstring    1  IODSTC_CALFLAGS        Flag Byte
              1... ....      IODSTC_RDEVDVIV        OFF = device model number (in
                                                    IODSTC_RDEVDVID) and model
                                                    identifier (in IODSTC_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.. ....      IODSTC_RDEVCUIV        When on, Control unit
                                                    information is supplied in
                                                    IODSTC_RDEVCUID and
                                                    IODSTC_RDEVCUMN.
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
     48  30  Character    6  IODSTC_RDEVSER         DASD volume serial identifier
     54  36  Unsigned     2  *                      Reserved and available for
                                                    IBM use
     56  38  Unsigned     4  IODSTC_CALRDEVSID      Host subchannel id for the
                                                    new base
     60  3C  Unsigned     2  IODSTC_CALRDEVDEV      Device number for the new
                                                    base in packed decimal
     62  3E  Bitstring    1  IODSTC_RDEVPVFG        PAV flag to indicate base and
                                                    alias DASD
              1... ....      IODSTC_RDEVPVBA        PAV base indicator
              .1.. ....      IODSTC_RDEVPVAL        PAV alias indicator
              ..1. ....      IODSTC_RDEVHPBA        HyperPAV Base
              ...1 ....      IODSTC_RDEVHPAL        HyperPAV Alias The above
                                                    fields are mutually exclusive
              .... 1...      IODSTC_RDEVFREQ        HyperPAV Alias is on the free
                                                    queue
              .... .1..      *
              .... ..1.      *
              .... ...1      *
     63  3F  Bitstring    1  *                      Reserved and available for
                                                    IBM use
     64  40  Unsigned     2  IODSTC_RDEVHPPL        HyperPAV Pool Number Note:
                                                    This value is only meaningful
                                                    if the IODSTC_RDEVHPBA or
                                                    IODSTC_RDEVHPAL flag is set
     66  42  Unsigned     2  *                      Reserved and available for
                                                    IBM use.
     68  44  Character    0  IODSTC_END

    MRIODSTC Cross Reference

                          Hex           Hex
    Name                 Offset Length Value

    IODSTC                     0     68
    IODSTC_CALCODE            14      1
    IODSTC_CALFLAGS           2F      1
    IODSTC_CALMODLN           1C      1
    IODSTC_CALRDEVDEV         3C      2
    IODSTC_CALRDEVSID         38      4
    IODSTC_END                44      0
    IODSTC_MRHDR               0      0
    IODSTC_RDEVCHPS           24      8
    IODSTC_RDEVCLAS           19      1
    IODSTC_RDEVCUID           2C      2
    IODSTC_RDEVCUIV           2F           40
    IODSTC_RDEVCUMN           2E      1
    IODSTC_RDEVDEV            1E      2
    IODSTC_RDEVDVID           1A      2
    IODSTC_RDEVDVIV           2F           80
    IODSTC_RDEVFREQ           3E           08
    IODSTC_RDEVHPAL           3E           10
    IODSTC_RDEVHPBA           3E           20
    IODSTC_RDEVHPPL           40      2
    IODSTC_RDEVLPM            1D      1
    IODSTC_RDEVPVAL           3E           40
    IODSTC_RDEVPVBA           3E           80
    IODSTC_RDEVPVFG           3E      1
    IODSTC_RDEVSER            30      6
    IODSTC_RDEVSID            20      4
    IODSTC_RDEVTYPE           18      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