Work with commitment definitions in a distributed relational database

Use the Work with Commitment Definitions (WRKCMTDFN) command if you want to work with the commitment definitions on the server.

A commitment definition is used to store information about commitment control when commitment control is started by the Start Commitment Control (STRCMTCTL) command. These commitment definitions might or might not be associated with an active job. Those not associated with an active job have been ended, but one or more of its logical units of work have not yet been completed.

The Work with Commitment Definitions (WRKCMTDFN) command can be used to work with commitment definitions based on the job name, status, or logical unit of work identifier of the commitment definition.

On the STATUS parameter, you can specify all jobs or only those that have a status value of *RESYNC or *UNDECIDED. *RESYNC shows only the jobs that are involved with resynchronizing their resources in an effort to reestablish a synchronization point; a synchronization point is the point where all resources are in consistent state.

*UNDECIDED shows only those jobs for which the decision to commit or roll back resources is unknown.

On the LUWID parameter, you can display commitment definitions that are working with a commitment definition on another server. Jobs containing these commitment definitions are communicating using an APPC-protected conversation. An LUWID can be found by displaying the commitment definition on one server and then using it as input to the Work with Commitment Definitions (WRKCMTDFN) command to find the corresponding commitment definition.

You can use the Work with Commitment Definitions (WRKCMTDFN) command to free local resources in jobs that are undecided, but only if the commitment definitions are in a Prepared (PRP) or Last Agent Pending (LAP) state. You can force the commitment definition to either commit or roll back, and thus free up held resources; control does not return to the program that issued the original commitment until the initiator learns of the action taken on the commitment definition.

You can also use the Work with Commitment Definitions (WRKCMTDFN) command to end synchronization in cases where it is determined that resynchronization will not ever complete with another server.

Related concepts
Troubleshoot transactions and commitment control
Related reference
Start Commitment Control (STRCMTCTL) command
Work with Commitment Definitions (WRKCMTDFN) command