Unit of work - UOW

The unit of work (UOW) views display information about currently executing units of work.

Supplied views

To access from the main menu, click:

CICS operations views > Unit of work (UOW) operations views > Unit of work

Table 1. Views in the supplied Unit of work (UOW) view set
View Notes
Unit of work

EYUSTARTUOW.BACKOUT

 Perform syncpoint backout processing.
Unit of work

EYUSTARTUOW.COMMIT

 Perform syncpoint commit processing.
Unit of work

EYUSTARTUOW.DETAIL1

 Details of object transaction service (OTS) transaction ID.
Unit of work

EYUSTARTUOW.DETAILED

 Detailed information about a selected unit of work.
Unit of work

EYUSTARTUOW.FORCE

 Force unit of work backout or commit.
Unit of work

EYUSTARTUOW.SET

 Set attributes according to the new values specified in input fields
Unit of work

EYUSTARTUOW.TABULAR

 Tabular information about units of work in CICS systems.

Actions

Table 2. Actions available for UOW views
Action Description
BACKOUT Perform syncpoint backout processing.
COMMIT Perform syncpoint commit processing.
FORCE Force unit of work backout or commit.
SET Set attributes according to the new values specified in input fields

Fields

Table 3. Fields in UOW views
Field Attribute name Description
Time in current wait state (seconds) AGE Indicates the number of seconds since the unit of work entered its current wait state.
Netname of remote system that caused wait LINK When the Wait Cause field contains a value of CONNECTION, this field displays the ID of the system involved. If the sysid has been discarded, or for other Wait Cause values, this field remains blank.
Netname of link causing UOW wait/shunt NETNAME When the Wait Cause field contains a value of CONNECTION, this field displays the netname of the link which caused the unit of work to wait or be shunted. For other Wait Cause values, this field remains blank.
LU 6.2 network-wide name for UOW NETUOWID The LU6.2 name for the unit of work within this network.
Object transaction service (OTS) transaction ID OTSTID Indicates the transaction identifier (TID) of the OTS transaction of which the UOW is a part. If the OTS name has fewer than 128 bytes, it is padded on the right with binary zeros.
System ID of connection that caused wait SYSID When the Wait Cause field contains a value of CONNECTION, this field displays the ID of the system involved. If the connection has been discarded, or for other Wait Cause values, this field remains blank.
Task originally associated with UOW TASKID Indicates the task number associated with this unit of work.
Terminal from which this UOW was started TERMID Indicates the ID of the terminal or session from which this unit of work was started.
Transaction that started UOW TRANSID Indicates the ID of the transaction which started this unit of work.
Local unit of work (UOW) ID UOWID Indicates the ID of the local unit of work (UOW).
UOW status UOWSTATE Indicates the state of the unit of work. Options are:
  • BACKOUT - This UOW is being backed out, or has failed to back out one or more of the recoverable resources involved in the UOW
  • COMMIT - A decision to commit the UOW has been made, but the UOW is waiting or has been shunted
  • FORCE - An attempt is being made to force the UOW to back out or commit
  • HEURBACKOUT - The UOW has been forcibly backed out
  • HEURCOMMIT - The UOW has been forcibly committed
  • INDOUBT - This UOW is in the in-doubt state
  • INFLIGHT - The UOW is running normally
User that started transaction USERID Indicates the user ID from which this transaction was started.
Cause of wait WAITCAUSE Identifies the type of resource that caused the unit of work to wait or be shunted:
  • NOTAPPLIC - The UOW is not waiting
  • CONNECTION - Failure of a session to the coordinator of the UOW during the in-doubt period
  • DATASET - Failure associated with one or more data sets
  • OTSCOORD - Failure of a session to the OTS coordinator
  • RLSSERVER - Failure of an RLS server
  • WAITRRMS - Communication has been lost with RRS/MVS
  • WAITCOMMIT - Failure occurred during commit processing
  • WAITFORGET - Waiting for FORGET from participants in the syncpoint
  • WAITRMI - Waiting for FORGET from the RMI
Wait status WAITSTATE Indicates the wait state of the unit of work. Options are ACTIVE, SHUNTED, WAITING.