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.