File Control Domain Exits, Xfcfrin And Xfcfrout - IBM SC34-6814-04 Customization Manual

Exit-specific parameters
Return codes
XPI calls

File control domain exits, XFCFRIN and XFCFROUT

XFCFRIN
If enabled, the XFCFRIN exit is invoked on entry to the main file control request
gate, FCFR. It allows you to:
v Monitor file control requests and allow them to continue, to be processed by
v Intercept file control requests and bypass CICS file control processing altogether
v Redirect the request to a remote region.
The request may have originated from:
v The execution of an application request to process a user file
v The receipt of a function-shipped request
72
Customization Guide
UEPARG
Address of the EXEC command parameter list.
UEPEXECB
Address of the system EIB.
UEPUSID
Address of the 8-character userid.
UEPPGM
Address of the 8-character application program name.
UEPLOAD
Address of the application program's load-point.
UEPRSA
Address of the application's register save area. This contains the
contents of the registers at the point when the program issued the
EXEC CICS command.
UEP_EI_PBTOK
Address of a 4-byte field containing the z/OS Workload Manager
(WLM) Performance Block Token. An exit program can use this
token to access information (such as the service class token,
SERVCLS) in the WLM Performance Block. To do so, it must use
the WLM EXTRACT macro, IWMMEXTR, passing the Performance
Block Token as the MONTKN input parameter. For more information
about the IWMMEXTR macro, see z/OS MVS Programming:
Workload Management Services.
An exit program must not attempt to modify the Performance Block:
if it does so, the results are unpredictable.
UERCNORM
Continue processing.
UERCPURG
Task purged during XPI call.
All can be used.
CICS file control