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.

Syntax

Warning: System commands are powerful as they provide information about the state of the system and allow changes to be made to it. System commands should be used only by authorized applications and users.

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).

SET UOWLINK

Read syntax diagramSkip visual syntax diagramSET UOWLINK( data-value)ACTION(cvda)DELETE

Conditions: INVREQ, NOTAUTH, UOWLNOTFOUND

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).

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 APPC connections to and from z/OS Communications Server generic resources.

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.