Exit XFCVSDS

Exit XFCVSDS is invoked after VSAM RLS has informed CICS® that processing is required as a result of a data set-related action occurring in the sysplex.

When invoked
Invoked after VSAM RLS has informed CICS that processing is required as a result of a data set-related action occurring in the sysplex.
Exit-specific parameters
UEPDSNAM
Address of a 44-byte field containing the name of the data set to which the action applies
UEPVSACT
Address of a 1-byte field indicating the RLS action of which CICS has been informed. Possible values are:
UEQUIES
Quiesce
UEUNQUIS
Unquiesce
UENBWST
Non-BWO backup start
UENBWCMP
Non-BWO backup complete
UEBWOST
BWO backup start
UEBWOCMP
BWO backup complete.
UEPQUCLS
Address of a 1-byte field indicating, for UEQUIES only, how files open in RLS mode are to be closed. Possible values are:
UEORDCLO
Wait until all in-flight UOWs that are accessing the data set have completed syncpoint before closing.
UEIMMCLO
Abend all in-flight UOWs that are accessing the data set before closing.
UEPCPTEC
Address of a 1-byte field indicating, for UENBWST and UEBWOST only, whether the backup is to use the concurrent copy technique. Possible values are:
UEORDCOP
Concurrent copy is not being used.
UECONCOP
Concurrent copy is being used.
Return codes
UERCNORM
Continue processing—complete the actions required to support the VSAM RLS operation.
UERCBYP
This applies only to actions UEQUIES, UENBWST and UEBWOST. 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.

XPI calls
All can be used.
API and SPI calls
You can use CICS API and SPI commands at this exit. In general all can be used, with the following restrictions:
  • You should avoid the use of commands that cause the issuing task to suspend.
  • You must not use EXEC CICS SHUTDOWN or EXEC CICS XCTL.
  • You must not use the QUIESCESTATE option of EXEC CICS SET DSNAME for data set UEPDSNAM.
  • You must not use the OPENSTATUS option of EXEC CICS SET FILE, or issue file control requests, for files that reference data set UEPDSNAM.


dfha3c0034.html | Timestamp icon Last updated: Monday, 5 June 2017