IBM: EXTUAREA

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

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.