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 V6R2.0.
Last updated on 23 Nov 2011 at 15:33:04.
Copyright IBM Corporation, 1990, 2011