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.

    MRIODSTC Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)          Description

      0   0  Structure   64  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 Result of
                                                 PSF order X'1F' - manage alias
     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 Bases and
                                                 aliases are mutually exclusive
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
     63  3F  Bitstring    1  *                   Reserved and available for IBM
                                                 use
     64  40  Character    0  IODSTC_END

    MRIODSTC Cross Reference

                          Hex           Hex
    Name                 Offset Length Value

    IODSTC                  0     64
    IODSTC_CALCODE         14      1
    IODSTC_CALFLAGS        2F      1
    IODSTC_CALMODLN        1C      1
    IODSTC_CALRDEVDEV      3C      2
    IODSTC_CALRDEVSID      38      4
    IODSTC_END             40      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_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 V4R4.0.

    Last updated on 22 Jul 2003 at 15:04:23.

    Copyright IBM Corporation, 1990, 2003