Programming Interface Information: This page documents intended Programming Interfaces that allow the customer to write programs to obtain the services of z/VM.

#### INTBLOK

Prolog

Control Block Contents
INTBLOK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### INTBLOK Prolog

     Name       : INTBLOK
     Description: I/O Interrupt Block
     DSECT      : INTBLOK
     Function   : Mapping macro which maps information
                  stored when an I/O interrupt occurs. INTBLOK
                  maps the user provided area indicated by the
                  INTBLOK parameter of the HNDIO macro.

#### INTBLOK Control Block Content

#### INTBLOK DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      INTBLOK        I/O Interrupt Block
    0000    0 Bitstring    8 INTXACOD (0)   Interrupt information
    0000    0 Signed       4 INTPARM        For XA/XC, interruption
                                            parameter; for 370, 0
    0004    4 Bitstring    4 INTIDENT (0)   For XA/XC, subsystem ID word
                                            (SID); for 370, see individual
                                            components
    0004    4 Signed       2 *              For XA/XC, X'0001'; for 370, 0
    0006    6 Signed       2 INTSUBCH       For XA/XC, subchannel number; for
                                            370, use INTDEVAD
    0006    6 Signed       2 INTDEVAD       For XA/XC, use INTSUBCH; for 370,
                                            device address
    0008    8 Dbl-Word     8 INTPSW         I/O old PSW
    0010   16 Bitstring   64 INTXAIRB (0)   For XA/XC, actual interruption
                                            response block (IRB); for 370,
                                            constructed IRB
    0010   16 Bitstring   12 INTSCSW (0)    For XA/XC, actual subchannel
                                            status word (SCSW); for 370,
                                            constructed SCSW
    0010   16 Bitstring    1 INTSCCTL       Key, S, L, and CC
    0011   17 Bitstring    1 *              For XA/XC, miscellaneous SCSW
                                            bits; for 370, 0
              1... ....      INTCCWFM       X'80' For XA/XC, CCW format; for
                                            370, 0
    0012   18 Bitstring    2 *              For XA/XC, more miscellaneous
                                            SCSW bits; for 370, 0
    0014   20 Address      4 INTCCWAD       For XA/XC, CCW address; for 370,
                                            X'00' and 3-byte CCW address
    0018   24 Bitstring    1 INTDEVST       Device status
    0019   25 Bitstring    1 INTSCHST       For XA/XC, subchannel status; for
                                            370, channel status
    001A   26 Signed       2 INTRCNT        Residual byte count
    001C   28 Signed       4 * (13)         For XA/XC, extended status word
                                            (ESW) and extended control word
                                            (ECW); for 370, 0
    0050   80 Bitstring    1 INTSTAT        Status of INTBLOK information
              1... ....      INTFAIL        X'80' For XA/XC, if 1, TSCH
                                            failed and IRB is not valid; for
                                            370, always 0
              .1.. ....      INTPS370       X'40' For XA/XC, always 0 (actual
                                            information given); for 370,
                                            always 1 (constructed, or
                                            "pseudo", information given)
    0051   81 Bitstring    1 *              Reserved
    0052   82 Signed       2 INTDEVNO       Saved device addr for user exit
              00000054       INTBLKSZ       *-INTBLOK INTBLOK length

#### INTBLOK Storage Layout

    *** INTBLOK - I/O Interrupt Block
    *
    *     +---------------------------+-------------+-------------+
    *   0 |         INTPARM           |/////////////|  INTSUBCH   |
    *     +---------------------------+-------------+-------------+
    *   8
    *
    *** INTBLOK - I/O Interrupt Block

    *** Overlay for INTSUBCH in INTBLOK
    *
    *                                               +-------------+
    *   0 ...                                     6 |  INTDEVAD   |
    *     +-----------------------------------------+-------------+
    *   8 |                        INTPSW                         |
    *     +------+------+-------------+---------------------------+
    *  10 |:SCCTL|//////|/////////////|         INTCCWAD          |
    *     +------+------+-------------+---------------------------+
    *  18 |:DEVST|:SCHST|  INTRCNT    |///////////////////////////|
    *     +------+------+-------------+///////////////////////////|
    *  20 |///////////////////////////////////////////////////////|
    *     =///////////////////////////////////////////////////////=
    *     |///////////////////////////////////////////////////////|
    *     +------+------+-------------+---------------------------+
    *  50 |:STAT |//////|  INTDEVNO   | 54
    *     +------+------+-------------+
    *
    *** Overlay for INTSUBCH in INTBLOK

#### INTBLOK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    INTBLKSZ       0052 00000054
    INTCCWAD       0014
    INTCCWFM       0011 80
    INTDEVAD       0006
    INTDEVNO       0052
    INTDEVST       0018
    INTFAIL        0050 80
    INTIDENT       0004
    INTPARM        0000
    INTPSW         0008
    INTPS370       0050 40
    INTRCNT        001A
    INTSCCTL       0010
    INTSCHST       0019
    INTSCSW        0010
    INTSTAT        0050
    INTSUBCH       0006
    INTXACOD       0000
    INTXAIRB       0010

This information is based on z/VM V5R2.0.
Last updated on 6 Dec 2005 at 15:40:02 EDT.
Copyright IBM Corporation, 1990, 2005