CEMT INQUIRE UOW

Retrieve information about units of work (UOWs).

Description

The INQUIRE UOW command returns information about a named unit of work, or about all the UOWs currently in the system. It displays the state of the UOW (for example, INDOUBT) and whether it is active, waiting, or shunted.

If you suspect a problem with either a recoverable data set or a connection, you can use INQUIRE UOW to display UOWs that have been shunted because of a connection or data set failure. The command, in some cases, displays the name of the resource that caused the UOW to be shunted, plus the transaction, user, and terminal that started it.

Important: In an intercommunication environment, a unit of work can include actions by two or more connected systems. Such a unit of work is known as a distributed unit of work, because the resources to update are distributed across more than one system. A distributed unit of work is made up of two or more local units of work, each of which represents the work to be done on one of the participating systems.

The INQUIRE UOW command 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 Troubleshooting intersystem problems.

Input

Press the Clear key to clear the screen. You can start this transaction in two ways:

Type CEMT INQUIRE UOW (or suitable abbreviations for the keywords). The resulting display lists all the current UOWs.
Type CEMT INQUIRE UOW (or suitable abbreviations for the keywords), followed by the attributes that are necessary to limit the range of information that you require. For example, if you enter cemt i uow sh con, the resulting display shows the details of only those UOWs that have been shunted because of the failure of a connection.

(value): A 16-character local identifier of a UOW.
ALL: The default. If you do not specify a UOW identifier, information about all UOWs in the system is shown.

Sample screen

Figure 1. CEMT INQUIRE UOW screen

IN UOW
STATUS:  RESULTS - OVERTYPE TO MODIFY
 Uow(AB8FFF37584B6601) Inf Act Tra(CSSY) Tas(0000005)
    Age(00004090)                          Use(BELL    )
 Uow(AB8FFF3758786C01) Inf Act Tra(CSSY) Tas(0000006)
    Age(00004090)                          Use(BELL    )
 Uow(AB8FFF376D9B6601) Inf Act Tra(CSTP) Tas(0000008)
    Age(00004090)                          Use(BELL    )
 Uow(AB900BD865417C04) Inf Act Tra(CSNE) Tas(0000018)
    Age(00000700)                          Use(BELL    )
 Uow(AB900BE2010AC401) Inf Act Tra(CEMT) Tas(0000043)
    Age(00000689) Ter(S21D) Netn(IGBS21D ) Use(BELL    )

Note: When a value does not apply, or is negative (the value begins with No), the fields on the screen are blank. To modify these fields, locate them by tabbing (they appear in the same sequence as in the expanded format), and overtype with input valid for that field. You might find it more convenient to use the expanded format when setting one of these values.

If you place the cursor against a specific entry in the list and press ENTER, CICS® displays an expanded format, as shown in Figure 2.

Figure 2. The expanded display of an individual entry

 IN UOW
 RESULT - OVERTYPE TO MODIFY
   Uow(AB8FFF37584B6601)
   Uowstate( Inflight )
   Waitstate(Active)
   Transid(CSSY)
   Taskid(0000005)
   Age(00004233)
   Termid()
   Netname()
   Userid(BELL)
   Waitcause()
   Link()
   Sysid()
   Netuowid(..GBIBMIYA.CICSHT61........)
   Otstid()

CEMT INQUIRE UOW

Displayed fields

AGE (value)

Displays the age of the UOW in seconds. This is the number of seconds since the UOW entered its current state, or since the start of the UOW.

LINK(value)

Displays the 8-character value that, for a WAITCAUSE value of CONNECTION, is the netname of the remote system that caused the UOW to wait or be shunted. For other WAITCAUSE values, LINK displays blanks.

NETNAME (value)

Displays the 8-character network name of the terminal from which the UOW was started.

If the UOW was started from an ISC or MRO session, NETNAME displays the network name of the remote region.

If the UOW was not started from a terminal, nor from an ISC or MRO session, NETNAME displays blanks.

NETUOWID (value)

Displays a 27-character string that contains the LU6.2 name for the UOW within this network; that is, the network-wide identifier of the UOW.

Nondisplayable characters appear as periods. You can use PF2 on the expanded panel: to see the value in hexadecimal.

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.

OTSTID(value)

Displays the first 128 bytes of 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.

SYSID (value)

Displays the 4-character sysid that, for a WAITCAUSE value of CONNECTION, is the sysid of the connection that caused the UOW to wait ir be shunted. If the connection has been discarded, and for other WAITCAUSE values, SYSID returns blanks.

TASKID (value)

Displays the task number originally associated with this UOW. If the UOW is shunted, the task terminates. In this case, the number may have been reused by another task.

TERMID (value)

Displays the 4-character ID of the terminal or session from which this UOW was started. This is the principal facility for the task. If the transaction is the mirror transaction, CSMI, it is the session. For OUWs that are part of an OTS transaction, it will be the session used by the request stream that attached the task.

TRANSID (value)

Displays the 4-character ID of the transaction that started this UOW.

UOW(value)

Indicates that this panel relates to a UOW inquiry and displays a 16-character UOW local identifier.

UOWSTATE

Displays the state of the UOW. The values are as follows:

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. This might be because the decision has not yet been communicated to all participants in the syncpoint, or because a failure has occurred during commit processing.
INDOUBT: This UOW is in the indoubt state.
INFLIGHT: The UOW is running normally.
HBACKOUT: The UOW has been forcibly backed out. A forced decision is taken when a UOW is unable to wait for indoubt resolution; for example, the transaction was defined as WAIT(NO), or was backed out with a CEMT SET UOW command.
HCOMMIT: The UOW has been forcibly committed.

Note: You can reset this value by overtyping it with:

COMMIT: Attempt to force syncpoint commit processing, as specified for this UOW.
BACKOUT: Attempt to force syncpoint backout processing, as specified for this UOW.
FORCE: Attempt to force the UOW to backout or commit, as specified on the ACTION option of the TRANSACTION resource definition.

All these values are valid only for UOWs that have been shunted indoubt. For information about the indoubt attributes of TRANSACTION resource definition, see TRANSACTION attributes.

USERID(value)

Displays the 8-character user ID with which this transaction was started.

WAITCAUSE

Displays, if the UOW is waiting or shunted, the type of resource that caused it to be so.

Note: In the case of a wait, it is the UOW that is waiting, not the task.

The values are as follows:

CONNECTION: This UOW is waiting or was shunted because of the failure of a session to the coordinator of the UOW during the indoubt period. NETNAME and SYSID contain the netname and system name of the failed link.
DATASET: This UOW is waiting or was shunted because of the failure of one or more data sets. Use the INQUIRE UOWDSNFAIL command to identify the data sets involved and the reasons why they have caused the UOW to fail.
NOTAPPLIC: The UOW is not waiting.
RLSSERVER: This UOW is waiting or was shunted for the OTS coordinator because of the failure of an RLS server.
RRMS: This UOW is waiting or has been shunted because communication has been lost with RRS/MVS.
WAITCOMMIT: This UOW is waiting or was shunted because a failure occurred during commit processing.
WAITFORGET: This UOW is waiting for FORGET from participants in the syncpoint. Use the INQUIRE UOWLINK command to obtain the netnames and sysids of the participants.
WAITRMI: This UOW is waiting for FORGET from the RMI. Use the INQUIRE UOWLINK command to obtain the entry name and qualifier of the task-related user exit.

WAITSTATE

Displays whether syncpoint processing of the UOW has been deferred. The values are as follows:

ACTIVE: The UOW is running normally, or is being unshunted.
WAITING: Syncpoint processing has completed on this system, but not on all systems involved in the distributed UOW. Values of WAITFORGET or WAITRMI, and BACKOUT or COMMIT indicate how the UOW was resolved on this system.
SHUNTED: Syncpoint processing of the UOW has been deferred. SHUNTED further indicates that the task, terminal and program storage have been released, and locks have been retained.