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
      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 V7R2.0.

    Last updated on 09 August 2020 at 14:55:56.

    Copyright IBM Corporation, 1990, 2020