UOW Analysis situations

The predefined situations in this category monitor transactions, that is, units of work.

Note:
All the attribute names in this group are prefixed with CICSplex_UOW_Analysis. except where stated.
CICSplex_ShuntedUOWs_Warning
Warning threshold exceeded for shunted UOWs.

If shunted UOWs are causing problems, such as holding locks that result in enqueue failures, consider forcing a decision. The UOW Enqueue Analysis report will provide a list of all UOW IDs, including those that are shunted. Using either Tivoli OMEGAMON XE for CICS on z/OS or the CICS CEMT transaction, you can perform the following actions against a shunted UOW: force backout, force commit, or force defined action.

Formula

If 
 the value of the attribute Shunted_UOWs is greater than 0 
and 
 the value of the attribute Shunted_UOWs is less than or equal to 1
CICSplex_ShuntedUOWs_Critical
Critical threshold exceeded for shunted UOWs.

If shunted UOWs are causing problems, such as holding locks that result in enqueue failures, consider forcing a decision. The UOW Enqueue Analysis report will provide a list of all UOW IDs, including those that are shunted. Using either Tivoli OMEGAMON XE for CICS on z/OS or the CICS CEMT transaction, you can perform the following actions against a shunted UOW: force backout, force commit, or force defined action.

Formula

If 
 the value of the attribute Shunted_UOWs is greater than 1
CICSplex_UOWShuntTime_Warning
Warning threshold exceeded for total shunt time.

If shunted UOWs are causing problems, such as holding locks that result in enqueue failures, consider forcing a decision. The UOW Enqueue Analysis report can be used to obtain a list of all UOW IDs and their associated shunt times. Using either Tivoli OMEGAMON XE for CICS on z/OS or the CICS CEMT transaction, you can perform the following actions against a shunted UOW: force backout, force commit, or force defined action.

Formula

If 
 the value of the attribute Total_Time_Shunted is greater than 0 
and 
 the value of the attribute Total_Time_Shunted is less than or
equal to 1
CICSplex_UOWShuntTime_Critical
Critical threshold exceeded for total shunt time.

If shunted UOWs are causing problems, such as holding locks that result in enqueue failures, consider forcing a decision. The UOW Enqueue Analysis report can be used to obtain a list of all UOW IDs and their associated shunt times. Using either Tivoli OMEGAMON XE for CICS on z/OS or the CICS CEMT transaction, you can perform the following actions against a shunted UOW: force backout, force commit, or force defined action.

Formula

If 
 the value of the attribute Total_Time_Shunted is greater than 1
CICSplex_UOWForce_Warning
Warning threshold exceeded for UOW forced decisions.

A forced decision can occur after an indoubt UOW remains unresolved for a user-defined time period. CICS unconditionally backs out or commits the changes made by the UOW to release the resources held by the in-doubt UOW.

Formula

If 
 the value of the attribute Forced_Decisions is greater than 0 
and 
 the value of the attribute Forced_Decisions is less than or equal
to 1
CICSplex_UOWForce_Critical
Critical threshold exceeded for UOW forced decisions.

A forced decision can occur after an indoubt UOW remains unresolved for a user-defined time period. CICS unconditionally backs out or commits the changes made by the UOW to release the resources held by the in-doubt UOW.

Formula

If 
 the value of the attribute Forced_Decisions is greater than 1
CICSplex_UOWENQFail_Warning
Warning threshold exceeded for UOW enqueue failures.

If shunted UOWs are causing problems, such as holding locks that result in enqueue failures, consider forcing a decision. The UOW Enqueue Analysis report will provide a list of all UOW IDs, including those that are shunted. Using either Tivoli OMEGAMON XE for CICS on z/OS or the CICS CEMT transaction, you can perform the following actions against a shunted UOW: force backout, force commit, or force defined action.

Formula

If 
 the value of the attribute
CICSplex_UOW_Enqueue_Analysis.Enqueue_Failures is greater than 0 
and 
 the value of the attribute
CICSplex_UOW_Enqueue_Analysis.Enqueue_Failures is less than or
equal to 1
CICSplex_UOWENQFail_Critical
Critical threshold exceeded for UOW enqueue failures.

If shunted UOWs are causing problems, such as holding locks that result in enqueue failures, consider forcing a decision. The UOW Enqueue Analysis report will provide a list of all UOW IDs, including those that are shunted. Using either Tivoli OMEGAMON XE for CICS on z/OS or the CICS CEMT transaction, you can perform the following actions against a shunted UOW: force backout, force commit, or force defined action.

Formula

If 
 the value of the attribute
CICSplex_UOW_Enqueue_Analysis.Enqueue_Failures is greater than 1

See also the CICSplex UOW Analysis attribute group.