Exit xfcareq – IBM SC33-1683-02 User Manual

Page 116

Advertising
background image

Exit XFCAREQ

When invoked

Before CICS processes a file control SPI request.

Exit-specific parameters

UEPCLPS

Address of a copy of the SPI command parameter list. See “The
command-level parameter structure” on page 86.

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 the

CICS

Application Programming Reference manual.

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 SPI requests within the same task
(for example, between successive invocations of the XFCAREQC
exit).

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

UERCBYP

Bypass this request.

UERCNORM

Continue processing.

UERCPURG

Task purged during XPI call.

XPI commands

All can be used.

API and SPI commands

All can be used.

Note: Take care when using recursive commands. For example, you must avoid

entering a loop when issuing a file control SPI request from the XFCAREQ
exit. Use of the recursion counter UEPRECUR is recommended.

File control EXEC interface SPI exits XFCAREQ and XFCAREQC

84

CICS TS for OS/390: CICS Customization Guide

Advertising