SET UOW
Commit, back out, or force a shunted unit of work.
Syntax
Activate security checks on commands by specifying the XCMD system initialization parameter and by ensuring that command security checking is active for the transaction (either by specifying CMDSEC(YES) on the TRANSACTION resource definition or by specifying ALWAYS on the CMDSEC system initialization parameter).
Conditions: INVREQ, NOTAUTH, UOWNOTFOUND
NOHANDLE, RESP, and
RESP2 are common options that can be added to all EXEC CICS
commands to process error conditions. They are not explicitly included in the command syntax diagram
and option descriptions. For information about these common options and EXEC CICS
command syntax, see EXEC CICS command format and programming considerations. For more information
about the use of CVDAs, see CICS-value data areas (CVDAs).
This command is threadsafe.
Description
The SET UOW command enables you to commit, back out, or force a unit of work that has been shunted during the indoubt period of the transaction.
Options
- UOW(data-value)
- Specifies the 16-byte identifier of the UOW to be committed, backed out, or forced.
- UOWSTATE(cvda)
- Specifies the action to be attempted for this UOW. CVDA values are as follows:
- BACKOUT
- Attempt to force syncpoint backout processing, as specified for this UOW.
- COMMIT
- Attempt to force syncpoint commit processing, as specified for this UOW.
- FORCE
- Attempt to force the UOW to back out or commit, as specified on the ACTION option of the TRANSACTION resource definition.
Note: All these values are valid only for UOWs that are shunted indoubt. For information about the INDOUBT attributes of TRANSACTION definitions, see TRANSACTION resources.
Conditions
- INVREQ
- RESP2 values:
- 3
- UOWSTATE has an invalid CVDA value.
- 4
- CICS® is not in a valid state to COMMIT, BACKOUT, or FORCE this UOW.
- NOTAUTH
- RESP2 values:
- 100
- The use of this command is not authorized.
- UOWNOTFOUND
- RESP2 values:
- 1
- The UOW cannot be found.