File control quiesce send exit xfcquis – IBM SC33-1683-02 User Manual

Page 142

Advertising
background image

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

On completion, successful or failed, of a SET DSNAME QUIESCESTATE
command.

Exit-specific parameters

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).

UEPQRCDE

Address of a 1-byte field indicating the result of the quiesce or
unquiesce. Possible values are:

UEQOK

Successful.

UEQREJEC

Rejected—see UEPQCONF for the reason code.

UEQUNKNO

Failed because data set not known to DFSMS as a VSAM
data set.

UEQIOERR

Failed because of RLS error or SMSVSAM server not
available.

UEQCANCL

Failed because quiesce was canceled by user (UEQSD and
UEIMQSD only).

file control quiesce send exit

110

CICS TS for OS/390: CICS Customization Guide

Advertising