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, for example, holding locks that result in enqueue failures, consider forcing a decision. The UOW Enqueue Analysis workspace provides a list of all UOW IDs, including those that are shunted. Using either OMEGAMON AI for CICS or the CICS® CEMT transaction, perform the following actions against a shunted UOW: force backout, force commit, or force defined action.

Formula: If the value of Shunted_UOWs is greater than 0 and the value of Shunted_UOWs is less than or equal to 1 then situation CICSplex_ShuntedUOWs_Warning is true.

CICSplex_ShuntedUOWs_Critical
Critical threshold exceeded for shunted UOWs.

If shunted UOWs are causing problems, for example, holding locks that result in enqueue failures, consider forcing a decision. The UOW Enqueue Analysis workspace provides a list of all UOW IDs, including those that are shunted. Using either OMEGAMON AI for CICS or the CICS CEMT transaction, perform the following actions against a shunted UOW: force backout, force commit, or force defined action.

Formula: If the value of Shunted_UOWs is greater than 1 then situation CICSplex_ShuntedUOWs_Critical is true.

CICSplex_UOWShuntTime_Warning
Warning threshold exceeded for total shunt time.

If shunted UOWs are causing problems, for example, holding locks that result in enqueue failures, consider forcing a decision. The UOW Enqueue Analysis workspace is used to obtain a list of all UOW IDs and their associated shunt times. Using either OMEGAMON AI for CICS or the CICS CEMT transaction, perform the following actions against a shunted UOW: force backout, force commit, or force defined action.

Formula: If the value of Total_Time_Shunted is greater than 0 and the value of Total_Time_Shunted is less than or equal to 1 then situation CICSplex_UOWShuntTime_Warning is true.

CICSplex_UOWShuntTime_Critical
Critical threshold exceeded for total shunt time.

If shunted UOWs are causing problems, for example, holding locks that result in enqueue failures, consider forcing a decision. The UOW Enqueue Analysis workspace is used to obtain a list of all UOW IDs and their associated shunt times. Using either OMEGAMON AI for CICS or the CICS CEMT transaction, perform the following actions against a shunted UOW: force backout, force commit, or force defined action.

Formula: If the value of Total_Time_Shunted is greater than 1 then situation CICSplex_UOWShuntTime_Critical is true.

CICSplex_UOWForce_Warning
Warning threshold exceeded for UOW forced decisions.

A forced decision occurs 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 indoubt UOW.

Formula: If the value of Forced_Decisions is greater than 0 and the value of Forced_Decisions is less than or equal to 1 then situation CICSplex_UOWForce_Warning is true.

CICSplex_UOWForce_Critical
Critical threshold exceeded for UOW forced decisions.

A forced decision occurs 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 indoubt UOW.

Formula: If the value of Forced_Decisions is greater than 1 then situation CICSplex_UOWForce_Critical is true.

CICSplex_UOWENQFail_Warning
Warning threshold exceeded for UOW enqueue failures.
If shunted UOWs are causing problems, for example, holding locks that result in enqueue failures, consider forcing a decision. The UOW Enqueue Analysis workspace provides a list of all UOW IDs, including those that are shunted. Using either OMEGAMON AI for CICS or the CICS CEMT transaction, perform the following actions against a shunted UOW:
  • force backout
  • force commit
  • force defined action

Formula: If the value of CICSplex_UOW_Enqueue_Analysis.Enqueue_Failures is greater than 0 and the value of CICSplex_UOW_Enqueue_Analysis.Enqueue_Failures is less than or equal to 1 then situation CICSplex_UOWENQFail_Warning is true.

CICSplex_UOWENQFail_Critical
Critical threshold exceeded for UOW enqueue failures.
If shunted UOWs are causing problems, for example, holding locks that result in enqueue failures, consider forcing a decision. The UOW Enqueue Analysis workspace provides a list of all UOW IDs, including those that are shunted. Using either OMEGAMON AI for CICS or the CICS CEMT transaction, perform the following actions against a shunted UOW:
  • force backout
  • force commit
  • force defined action

Formula: If the value of CICSplex_UOW_Enqueue_Analysis.Enqueue_Failures is greater than 1 then situation CICSplex_UOWENQFail_Critical is true.

See also the CICSplex UOW Analysis attribute group.