Enabling for specific invocation-types

Use the following options of the EXEC CICS ENABLE command to cause your exit program to be started at specific events: INDOUBTWAIT, SHUTDOWN, and SPI.

INDOUBTWAIT

Specifies that, at phase 2 sync point time, if CICS® is indoubt about the outcome of the UOW, the exit program is to be started with the UERTWAIT verb (wait), instead of a forced definition of UERTCOMM (commit) or UERTBACK (backout). UERTWAIT signifies that CICS does not yet know the outcome of the UOW. In response to a UERTWAIT call, the task-related user exit should start its resource manager to free any task-related resources, such as the thread. However, the resource manager should maintain any locks held by the UOW, and record that the UOW is indoubt.

When CICS receives the outcome of the UOW from its coordinator, a resynchronization task is attached to notify the task-related user exit about the outcome of the UOW.

If CICS is indoubt about the outcome of a UOW for which an external resource manager has requested resynchronization (by using the EXEC CICS RESYNC command), CICS waits until the indoubt has been resolved before initiating a resynchronization task.

The effects of not enabling a task-related user exit with the INDOUBT keyword are:

If CICS is indoubt about a UOW, a forced decision is taken and the task-related user exit started with the forced decision.
If CICS is forced to take a decision because a task-related user exit is not enabled with INDOUBTWAIT, it takes a forced decision for all resources updated by the UOW, even if all the other resources are capable of waiting for indoubt resolution. This applies to local resources such as files, and also other RMCs, such as LU6.1, LU6.2, or MRO connections to other systems.
An inbound RESYNC command from a resource manager that requests resynchronization for a UOW that CICS was indoubt about, results in CICS starting the task-related user exit with a forced decision.

SHUTDOWN

Specifies that the exit program is to be started at CICS shutdown.

SPI

Specifies that the exit program is to be started to satisfy EXEC CICS INQUIRE EXITPROGRAM calls that specify the CONNECTST or QUALIFIER options. Use this option to enable user programs to discover whether the exit program is connected to its resource manager, and what its entryname qualifier is.

Note: The exit program can set this option dynamically, by setting the UEFMSPI bit-mask in the schedule flag word.