File control domain exits, xfcfrin and xfcfrout, Xfcfrin – IBM SC34-6814-04 User Manual

Page 94

Advertising
background image

Exit-specific parameters

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.

Return codes

UERCNORM

Continue processing.

UERCPURG

Task purged during XPI call.

XPI calls

All can be used.

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
CICS file control

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

Advertising