Exit XFCAREQC
Exit XFCAREQC is invoked after a file control SPI request has completed, before return from the file control SPI EXEC interface program.
- Exit specific parameters:
-
- UEPCLPS
- Address of a copy of the API command parameter list. See Accessing the command-level parameter structure from exits XFCAREQ and XFCAREQC.
- UEPFATOK
- Address of a 4-byte area that can be used to pass information between XFCAREQ and XFCAREQC on a single file control SPI request.
- UEPRCODE
- Address of a 6-byte hexadecimal copy of the EIB return code EIBRCODE. For details of EIB return codes, see 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 which can be used to pass information between successive file control requests within the same task (for example, between successive invocations of the XFCAREQC exit). See Using the task token UEPTSTOK.
- UEPRECUR
- Address of a halfword recursion counter. The counter is set to zero when the exit is first invoked and is incremented for each recursive call.
- Return codes
-
- UERCNORM
- Continue processing.
- UERCPURG
- Task purged during XPI call.
- XPI commands
- All can be used.
- API and SPI commands
- All can be used, except for:
- EXEC CICS® SHUTDOWN
- EXEC CICS XCTL
You can update the copies of EIBRCODE, EIBRESP, and EIBRESP2 that you are given in the parameter list. If you update the values, file control copies the new values into the application program's EXEC interface block (EIB) after the completion of XFCAREQC or if you specify a return code of UERCBYP in XFCAREQ.
You must set valid file control responses. You must set all three of EIBRCODE, EIBRESP, and EIBRESP2 to a consistent set of values, such as would be set by file control to describe a valid completion. CICS does not check the consistency of the values you set. If EIBRCODE is set to a non-zero value and EIBRESP is set to zero, CICS overrides EIBRESP with a non-zero value. To help you set values for EIBRCODE, EIBRESP, and EIBRESP2, the values used by file control for SPI requests are specified in DSECT DFHFAUED.