File Control Quiesce Send Exit Xfcquis - IBM SC34-6814-04 Customization Manual

XPI calls
API and SPI calls

File control quiesce send exit XFCQUIS

The XFCQUIS global user exit is invoked on completion of a VSAM RLS quiesce or
unquiesce of a data set that was requested either by a CEMT or EXEC CICS SET
DSNAME QUIESCESTATE command.
The exit is invoked regardless of whether the QUIESCESTATE action has
completed successfully or unsuccessfully. This enables you to perform, or schedule,
any processing that cannot take place until quiesce or unquiesce processing has
finished.
When invoked
Exit-specific parameters
124
Customization Guide
CICS is not to carry out the processing required for the VSAM RLS
action, and is to cancel the action throughout the sysplex.
A return code of UERCPURG is not allowed.
All can be used.
You can use CICS API and SPI commands at this exit. In general all can be
used, with the following restrictions:
v You should avoid the use of commands that cause the issuing task to
suspend.
v You must not use EXEC CICS SHUTDOWN or EXEC CICS XCTL.
v You must not use the QUIESCESTATE option of EXEC CICS SET
DSNAME for data set UEPDSNAM.
v You must not use the OPENSTATUS option of EXEC CICS SET FILE, or
issue file control requests, for files that reference data set UEPDSNAM.
On completion, successful or failed, of a SET DSNAME QUIESCESTATE
command.
UEPQDSNM
Address of a 44-byte field containing the name of the data set that
was being quiesced or unquiesced.
UEPQSTAT
Address of a 1-byte field indicating whether the data set was being
quiesced or unquiesced. Possible values are:
UEQSD
Data set was being quiesced by
QUIESCESTATE(QUIESCED). In-flight UOWs accessing
the data set completed syncpoint before files open in RLS
mode were closed.
UEIMQSD
Data set was being quiesced by
QUIESCESTATE(IMMQUIESCED). In-flight UOWs
accessing the data set were abended before files open in
RLS mode were closed.
UEUNQSD
Data set was being unquiesced by
QUIESCESTATE(UNQUIESCED).