IBM: XITPL

Programming Interface Information: This information is NOT intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only.

XITPL

Prolog

Control Block Contents

XITPL DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

XITPL Prolog

 NAME       : HCPXITPL
 DESCRIPTION: Exit Plist
 STATUS     : VM/ESA Version 2, Release 1.0
 DSECT      : XITPL
 FUNCTION   : The Exit Plist describes the standard fields in the
              CP Exit parameters supplied to the exit routines.
              Additional fields are expected to be appended by the
              various routines that build exit plists.
 LOCATED BY : R1 at invocation of the HCPXSERV CALL service.
 CREATED BY : Any CP routine that has an exit point defined.
 DELETED BY : The CP routine that created it.
 SERIALIZED : None
 NOTES      : Acqusition and release of the exit plist should use
              the label XITPL.   This is because the true plist
              (the addresses of data items) is embedded within the
              acquired storage.  This is done to facilitate use of
              BLOCKDEF and BLOCKMAP, as well as provide a simple
              way for one to extend the plist addresses at XITPLVAR
              without stomping on data that would come after the
              plist addresses if we didn't put the data at the
              front of the acquired storage.
              The 256 byte TRT table, XITPLTRT, must remain on a
              double word boundary, just so expectaions in user
              exit routines for a doubleword aligned work area
              are met.
              The last address in the true plist should have its
              high order bit turned on, just so expectaions in user
              exit routines for a variable length plist are met.

XITPL Control Block Content


XITPL DSECT
Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      XITPL          Exit Plist
     The user fields must remain at the front of the block
0000    0 Dbl-Word     8 XITPLUD1       Reserved for non-IBM use
0008    8 Dbl-Word     8 XITPLUD2       Reserved for non-IBM use
0010   16 Signed       4 XITPLUF1       Reserved for non-IBM use
0014   20 Signed       4 XITPLUF2       Reserved for non-IBM use
0018   24 Signed       2 XITPLUH1       Reserved for non-IBM use
001A   26 Signed       2 XITPLUH2       Reserved for non-IBM use
001C   28 Bitstring    1 XITPLUX1       Reserved for non-IBM use
001D   29 Bitstring    1 XITPLUX2       Reserved for non-IBM use
001E   30 Bitstring    1 XITPLUX3       Reserved for non-IBM use
001F   31 Bitstring    1 XITPLUX4       Reserved for non-IBM use
0020   32 Dbl-Word     8 * (0)          Align XITPLTRT
0020   32 Bitstring  256 XITPLTRT       256 bytes for anything
          00000120       XITPLHSZ       *-XITPL Size of standard plist
                                        header Start of the true plist
                                        (list of addresses)
0120  288 Address      4 XITPLSTR (0)   Start of the plist
0120  288 Address      4 XITPL@RS       'RESERVED'
0124  292 Address      4 XITPL@UW       'USERWORD' pointer
0128  296 Address      4 XITPL@TT       'TRTTABLE' pointer
012C  300 Address      4 XITPLVAR (0)   Start of variable length data
                                        Addresses of fields . specific to
                                        the exit. (Eventually) the end of
                                        the true plist (list of
                                        addresses)
012C  300 Address      4 XITPL@04       Address of first field . specific
                                        to the exit.
0130  304 Address      4 XITPL@05       Address of second field .
                                        specific to the exit.
     etc.

XITPL Storage Layout

*** XITPL - Exit Plist
*
*     +-------------------------------------------------------+
*   0 |                       XITPLUD1                        |
*     +-------------------------------------------------------+
*   8 |                       XITPLUD2                        |
*     +---------------------------+---------------------------+
*  10 |         XITPLUF1          |         XITPLUF2          |
*     +-------------+-------------+------+------+------+------+
*  18 |  XITPLUH1   |  XITPLUH2   |:PLUX1|:PLUX2|:PLUX3|:PLUX4|
*     +-------------+-------------+------+------+------+------+
*  20 |                                                       |
*     =                       XITPLTRT                        =
*     |                                                       |
*     +---------------------------+---------------------------+
* 120 |         XITPL@RS          |         XITPL@UW          |
*     +---------------------------+---------------------------+
* 128 |         XITPL@TT          |                           |
*     +---------------------------+                           |
* 130 |                                                       |
*     =                       XITPLVAR                        =
*     |                                                       |
*     +-------------------------------------------------------+
*
*** XITPL - Exit Plist
*** Overlay for XITPLVAR in XITPL
*
*                                 +---------------------------+
* 128 ...                     12C |         XITPL@04          |
*     +---------------------------+---------------------------+
* 130 |         XITPL@05          | 134
*     +---------------------------+
*
*** Overlay for XITPLVAR in XITPL