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

#### EXTUAREA

Prolog

Control Block Contents
EXTUAREA DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### EXTUAREA Prolog

     NAME       : EXTUAREA
     DESCRIPTION: External Interrupt User Area.
     DSECT      : EXTUAREA
     FUNCTION   : Mapping macro which maps information
                  passed to an external interrupt handler when an
                  interrupt occurs. EXTUAREA is a user area
                  generated by the EXTUAREA macro. The pointer to
                  the save area is passed to the user in register
                  13.

#### EXTUAREA Control Block Content

#### EXTUAREA DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      EXTUAREA       External Interrupt User Area.
    0000    0 Signed       4 EXTUGPRS (16)  General registers at interrupt
                                            tim
    0040   64 Dbl-Word     8 EXTUFRS (4)    Floating point regs at interrupt
    0060   96 Dbl-Word     8 EXTUPSW        External Old PSW at interrupt
                                            time
    0068  104 Signed       4 EXTUSAVE (20)  Save area for handler routine;
                                            pointed to by R13 when control
                                            passed to handler rtn.
    00B8  184 Signed       4 * (0)          Need fullword boundary
    00B8  184 Bitstring    8 EXTUINT (0)    Length of 8
    00B8  184 Signed       2 EXTUCPID       2 bytes = CPU ID bytes
    00BA  186 Signed       2 EXTUCODE       2 bytes = EXTERNAL INTERRUPT CODE
    00BC  188 Signed       4 EXTUPARM       User parm
    00C0  192 Signed       4 EXTUPREV       Pointer to previous user area
    00C4  196 Signed       4 EXTUARS (0)    Access Registers
    00C4  196 Signed       4 EXTUAR0        Access Register 0
    00C8  200 Signed       4 EXTUAR1        Access Register 1
    00CC  204 Signed       4 EXTUAR2        Access Register 2
    00D0  208 Signed       4 EXTUAR3        Access Register 3
    00D4  212 Signed       4 EXTUAR4        Access Register 4
    00D8  216 Signed       4 EXTUAR5        Access Register 5
    00DC  220 Signed       4 EXTUAR6        Access Register 6
    00E0  224 Signed       4 EXTUAR7        Access Register 7
    00E4  228 Signed       4 EXTUAR8        Access Register 8
    00E8  232 Signed       4 EXTUAR9        Access Register 9
    00EC  236 Signed       4 EXTUAR10       Access Register 10
    00F0  240 Signed       4 EXTUAR11       Access Register 11
    00F4  244 Signed       4 EXTUAR12       Access Register 12
    00F8  248 Signed       4 EXTUAR13       Access Register 13
    00FC  252 Signed       4 EXTUAR14       Access Register 14
    0100  256 Signed       4 EXTUAR15       Access Register 15
              00000104       EXTUSIZE       (*-EXTUAREA) Size of EXTUAREA in
                                            bytes

#### EXTUAREA Storage Layout

    *** EXTUAREA - External Interrupt User Area.
    *
    *     +-------------------------------------------------------+
    *   0 |                                                       |
    *     =                       EXTUGPRS                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  40 |                                                       |
    *     =                       EXTUFRS                         =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  60 |                       EXTUPSW                         |
    *     +-------------------------------------------------------+
    *  68 |                                                       |
    *     =                       EXTUSAVE                        =
    *     |                                                       |
    *     +-------------+-------------+---------------------------+
    *  B8 |  EXTUCPID   |  EXTUCODE   |         EXTUPARM          |
    *     +-------------+-------------+---------------------------+
    *  C0 |         EXTUPREV          |         EXTUAR0           |
    *     +---------------------------+---------------------------+
    *  C8 |         EXTUAR1           |         EXTUAR2           |
    *     +---------------------------+---------------------------+
    *  D0 |         EXTUAR3           |         EXTUAR4           |
    *     +---------------------------+---------------------------+
    *  D8 |         EXTUAR5           |         EXTUAR6           |
    *     +---------------------------+---------------------------+
    *  E0 |         EXTUAR7           |         EXTUAR8           |
    *     +---------------------------+---------------------------+
    *  E8 |         EXTUAR9           |         EXTUAR10          |
    *     +---------------------------+---------------------------+
    *  F0 |         EXTUAR11          |         EXTUAR12          |
    *     +---------------------------+---------------------------+
    *  F8 |         EXTUAR13          |         EXTUAR14          |
    *     +---------------------------+---------------------------+
    * 100 |         EXTUAR15          | 104
    *     +---------------------------+
    *
    *** EXTUAREA - External Interrupt User Area.

#### EXTUAREA Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    EXTUARS        00C4
    EXTUAR0        00C4
    EXTUAR1        00C8
    EXTUAR10       00EC
    EXTUAR11       00F0
    EXTUAR12       00F4
    EXTUAR13       00F8
    EXTUAR14       00FC
    EXTUAR15       0100
    EXTUAR2        00CC
    EXTUAR3        00D0
    EXTUAR4        00D4
    EXTUAR5        00D8
    EXTUAR6        00DC
    EXTUAR7        00E0
    EXTUAR8        00E4
    EXTUAR9        00E8
    EXTUCODE       00BA
    EXTUCPID       00B8
    EXTUFRS        0040
    EXTUGPRS       0000
    EXTUINT        00B8
    EXTUPARM       00BC
    EXTUPREV       00C0
    EXTUPSW        0060
    EXTUSAVE       0068
    EXTUSIZE       0100 00000104

This information is based on z/VM V6R1.0.
Last updated on 23 Oct 2009 at 11:01:14 EDT.
Copyright IBM Corporation, 1990, 2008