SET UOWLINK
Delete a link to a unit of work (a UOW-link) that was created by a connection that has since been discarded. UOWLINKs associated with RRS can be deleted when a cold start of RRS has been performed.
Conditions: INVREQ, NOTAUTH, UOWLNOTFOUND
For more information about the use of CVDAs, see CICS-value data areas (CVDAs).
Description
The association between a unit of work and a connection is known as a UOW-link. You can use the INQUIRE UOWLINK command to browse all the UOW-links currently in the system. Some of the UOW-links may have been created by connections that have since been discarded. If so, you may be able to use the SET UOWLINK command to delete them. (For information about when it is safe to delete UOW-links, see Managing connection definitions).
Options
- ACTION(cvda)
- specifies
the action to be taken against the UOW-link. The CVDA value is:
- DELETE
- Delete the UOW-link. Note that you cannot delete UOW-links where the connection still exists.
- UOWLINK(data-value)
- specifies the 4-character identifier of the unit of work-connection dependency (the UOW-link) to which this command applies.
Conditions
- INVREQ
- RESP2 values:
- 2
- Resynchronization is already in progress, or the UOW-link is already being processed by another instance of the SET UOWLINK command.
- 3
- The unit of work is indoubt, and the UOW-link is the coordinator of the commit or backout session. The unit of work must be forced using the SET UOW command before the UOW-link can be deleted.
- 4
- This is not a link created by a connection, or is not a recoverable link.
- 5
- The UOW-link (and the associated communication session) is still active.
- 6
- ACTION has an invalid CVDA value.
- 7
- The UOW-link has a suitable connection definition, and cannot be deleted. You must discard the related connection before you can delete a UOW link.
- NOTAUTH
- RESP2 values:
- 100
- The use of this command is not authorized.
- UOWLNOTFOUND
- RESP2 values:
- 1
- The specified UOW-link cannot be found.