Retrieve information about a unit of work (UOW).
INQUIRE UOW .-------------------------. V | >>-INQUIRE UOW(data-area)----+---------------------+-+--------->< +-AGE(data-area)------+ +-LINK(data-area)-----+ +-NETNAME(data-area)--+ +-NETUOWID(data-area)-+ +-OTSTID(data-area)---+ +-SYSID(data-area)----+ +-TASKID(data-area)---+ +-TERMID(data-area)---+ +-TRANSID(data-area)--+ +-UOWSTATE(cvda)------+ +-USERID(data-area)---+ +-WAITCAUSE(cvda)-----+ '-WAITSTATE(cvda)-----'
Conditions: END, ILLOGIC, NOTAUTH, UOWNOTFOUND
For more information about the use of CVDAs, see CICS-value data areas (CVDAs).
The INQUIRE UOW command retrieves information about a unit of work, or about all UOWs in a specified state. It returns the state of the UOW (for example, INDOUBT) and whether it is active, waiting, or shunted. In some cases, it returns the name of the resource that caused the UOW to be shunted, plus the transaction, user, and terminal that started it.
Note that INQUIRE UOW always returns information about local UOWs--that is, for a distributed UOW it returns information only about the work required on the system on which the command is issued. You can assemble information about a distributed UOW by matching the network-wide UOW identifier returned in the NETUOWID field against the network-wide identifiers of local UOWs on other systems.
For further information about local and distributed UOWs, see the CICS® Intercommunication Guide.
You can also browse through all of the UOWs currently in your system by using the browse options (START, NEXT, and END) on INQUIRE UOW commands. See Browsing resource definitions for general information about browsing, including syntax, exception conditions, and examples.
For example, if you suspect a problem with either a recoverable data set or a connection, you can use INQUIRE UOW to return information about UOWs that have been shunted because of a connection or data set failure.
This is because every time the SYNCPOINT command is executed, a new UOW is created. The new UOW is returned in the next INQUIRE UOW, which is followed by a SYNCPOINT, and so on.
For examples of the use of the INQUIRE UOW command, see the CICS Problem Determination Guide.
You can assemble information about a distributed UOW by matching the network-wide UOW identifier against the network-wide identifiers of local UOWs on other systems.
Because each resource needs fields of the right type, WAITCAUSE also indicates which fields contain the RESOURCE NAME and QUALIFIER. CVDA values are: