|
Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM. |
XITPL
Control Block Contents
XITPL DSECT
Cross Reference (Contains links to field and bit definitions)
XITPL Prolog
NAME : HCPXITPL
DESCRIPTION: Exit Plist
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 |
* +---------------------------+
*
*** XITPL - Exit Plist
*** Overlay for XITPLVAR in XITPL
*
* +---------------------------+
* 128 ... 12C | XITPL@04 |
* +---------------------------+---------------------------+
* 130 | XITPL@05 | 134
* +---------------------------+
*
*** Overlay for XITPLVAR in XITPL
XITPL Cross Reference
Symbol Dspl Value -------------- ---- ----- XITPL@RS 0120 XITPL@TT 0128 XITPL@UW 0124 XITPL@04 012C XITPL@05 0130 XITPLHSZ 0020 00000120 XITPLSTR 0120 XITPLTRT 0020 XITPLUD1 0000 XITPLUD2 0008 XITPLUF1 0010 XITPLUF2 0014 XITPLUH1 0018 XITPLUH2 001A XITPLUX1 001C XITPLUX2 001D XITPLUX3 001E XITPLUX4 001F XITPLVAR 012C
Last updated on 5 Jun 2001 at 17:21:21 EDT.
Copyright IBM Corporation, 1990, 2001