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 See
                                                defined code values below
 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 V5R1.0.
Last updated on 13 Sep 2004 at 11:25:22.
Copyright IBM Corporation, 1990, 2004