Filter
Top Products
Your program must be in primary-space translation mode when you invoke the
XPI. (For information about translation modes, see the
IBM ESA/370 Principles of
Operation
manual.)
Notes:
1. You cannot use all of these calls at every global user exit point. You will find
an indication of when these calls cannot be used both with the description of
each function call, and in the list of exit points in the
CICS Customization
Guide
.
Warning: These XPI calls are used to invoke CICS services; using them in the
wrong exits causes unpredictable errors in your CICS system.
2. There is a restriction on using the XPI early during initialization. Do not start
exit programs that use the XPI functions INQUIRE_MONITOR_DATA,
MONITOR, TRANSACTION_DUMP, and WRITE_JOURNAL_DATA until the
second phase of the PLTPI. For further information about the PLTPI, refer to
″Writing initialization and shutdown programs″ in the
CICS Customization
Guide
, SC33-1683.
3. These XPI functions are likely to cause the task executing the user exit
program to lose control to another task while the XPI function is being
executed. Therefore, the use of XPI functions must be very carefully
considered as interrupting the flow of CICS functions could cause problems,
such as lockouts, to occur.
For more information on tailoring CICS global and user exits review your
CICS
Customization Guide
, SC33-1683.
Remember that CICS/ESA does not support macro-level programs. If you attempt
to invoke programs with macro-level code and/or internal CICS addresses the
following should result:
•
CICS issues a warning message naming the offending program or
transaction
•
CICS names the offending program or transaction and abends the offender
•
CICS names the offending program or transaction and disables
Changes to the exit programming interface means that you will also need to
make changes to global user exit programs. Still, you must reassemble all global
exit programs. Plus, there are the following changes to be noted in your exit
programs.
CSA and TCA addresses are withdrawn from DFHUEPAR.
The following API commands are not supported in global user exits:
Command Exit points
EXEC CICS ABEND All exits
EXEC CICS RETURN All exits
All EXEC DLI XRMIIN and XRMIOUT
All EXEC SQL All exits
All CALL DLI All exits
148 VSE to OS/390 Migration Workbook