DEFEXIT: Define CICS VR exit names for batch backout

Use the DEFEXIT ESDSDELETE command to request CICS® VR batch backout processing to call the specified exit when attempting to back out a record that was added to a VSAM ESDS.

Format

Read syntax diagramSkip visual syntax diagramDEFEXITESDSDELETE(ESDS delete exit name)

Keywords

ESDSDELETE(ESDS delete exit name)
Specifies the name of the ESDS delete exit that CICS VR batch backout processing must call when attempting to back out a record that was added to a VSAM ESDS by a batch job. This exit program updates the record so it is marked-for-deletion. The exit program returns an action code, indicating what action CICS VR batch backout processing must take. The ESDSDELETE keyword must be specified when the specified batch backout processing backs out one or more records that were added to a VSAM ESDS. Refer to Implementing exits for forward recovery and backout for more information about creating an ESDS delete exit for use with CICS VR batch backout processing.
ESDS delete exit name
Specifies the name of the ESDS delete exit program load module. The name is 1 through 8 alphanumeric or national ($, #, @) characters. The first character must be alphabetic or national ($, #, @).

Usage Notes

Consider the following points when using the DEFEXIT ESDSDELETE command:

  • Only one DEFEXIT ESDSDELETE command can be specified per job step that starts the DWWBACK program.
  • DEFEXIT ESDSDELETE must be specified when the specified batch backout processing attempts to back out at least one record that was added to a VSAM ESDS.
  • If the exit program is not in the Link List, the exit program must reside in a data set that is defined to the JOBLIB, STEPLIB, or DWWLOAD ddname. You also can keep the exit program in your CICS VR load library.

Examples

  • Call the ESDSDEL exit program every time CICS VR batch backout processing must back out a record that was added to a VSAM ESDS: 
    DWWEXIT ESDSDELETE(ESDSDEL)

Synonyms

The DEFEXIT synonyms table provides the CICS VR batch backout DEFEXIT commands and keywords along with acceptable synonyms that can be used in place of the full command or keyword name:

Table 1. DEFEXIT synonyms
Command or keyword Synonyms
DEFEXIT X, DX, EXIT, EXITS
ESDSDELETE ESDSDEL, EDEL