Exit XTDEREQ
Exit XTDEREQ is invoked before CICS® processes a transient data API request.
- Exit-specific parameters
-
- UEPCLPS
- Address of the command-level parameter structure. See The UEPCLPS exit-specific parameter.
- UEPTDTOK
- Address of the 4-byte token to be passed to XTDEREQC. UEPTDTOK allows you, for example, to pass a work area to exit XTDEREQC.
- UEPRCODE
- Address of a 6-byte hexadecimal copy of the EIB return code ‘EIBRCODE'. For details of EIB return codes, refer to EIB fields.
- UEPRESP
- Address of a 4-byte binary copy of the EIB response code ‘EIBRESP'.
- UEPRESP2
- Address of a 4-byte binary copy of the EIB response code ‘EIBRESP2'.
- UEPTSTOK
- Address of a 4-byte token that is valid throughout the life of a task. See Using the task token UEPTSTOK.
- UEPRECUR
- Address of a halfword recursion counter. The counter is set to 0 when the exit is first invoked, and is incremented for each recursive call.
- UEPRSRCE
- Address of an 8-character copy of the EIB resource value, EIBRSRCE.
- Return codes
-
- UERCNORM
- Continue processing.
- UERCBYP
- The transient data EXEC interface program ignores this request.
- UERCPURG
- Task purged during XPI call.
- XPI calls
- All can be used.
Although the exit permits the use of XPI GETMAIN and FREEMAIN calls, we recommend that you use the EXEC CICS GETMAIN and FREEMAIN commands instead.
- API and SPI commands
- All can be used, except for:
- EXEC CICS SHUTDOWN
- EXEC CICS XCTL
Note: Take care when issuing recursive commands. For example,
you must avoid entering a loop when issuing a transient data request
from the XTDEREQ exit. Use of the recursion counter UEPRECUR is recommended.