Enqueue Analysis situations

The predefined situations in this category monitor enqueues.

Note:
All the attribute names in this group are prefixed with CICSplex_Enqueue_Analysis. except where stated.
CICSplex_TotENQWaits_Warning
Warning threshold exceeded for CICS enqueue waits.

Select the Enqueue Analysis report to find all tasks waiting on enqueues and the owners of the serially reusable resources. If an enqueue is not being released, examine the owning task's resource type to determine whether it is looping, waiting on a resource, or deadlocked with another task. You can use the KILL command of Tivoli OMEGAMON XE for CICS on z/OS to free the enqueue and allow the waiting tasks to continue. To limit the number of tasks suspended because of enqueue conflicts, consider transaction classes.

Formula

If the value of the attribute CICSplex_Region_Overview.Enqueue_Waits is greater than 5 
and the value of the attribute CICSplex_Region_Overview.Enqueue_Waits
 is less than or equal to 10
CICSplex_TotENQWaits_Critical
This is the critical threshold exceeded for CICS enqueue waits.

Select the Enqueue Analysis report to find all tasks waiting on enqueues and the owners of the serially reusable resources. If an enqueue is not being released, examine the owning task's resource type to determine whether it is looping, waiting on a resource, or deadlocked with another task. You can use the KILL command of Tivoli OMEGAMON XE for CICS on z/OS to free the enqueue and allow the waiting tasks to continue. To limit the number of tasks suspended because of enqueue conflicts, consider transaction classes.

Formula

If the value of the attribute CICSplex_Region_Overview.Enqueue_Waits is greater than 10
CICSplex_ENQWaitCount_Warning
Warning threshold exceeded for enqueue task waits.

Select the Enqueue Analysis report to find all tasks waiting on enqueues and the owners of the serially reusable resources. If an enqueue is not being released, examine the owning task's resource type to determine whether it is looping, waiting on a resource, or deadlocked with another task. You can use the KILL command of Tivoli OMEGAMON XE for CICS on z/OS to free the enqueue and allow the waiting tasks to continue. To limit the number of tasks suspended because of enqueue conflicts, consider transaction classes.

Formula

If the value of the attribute Wait_Count is greater than 1 
and the value of the attribute Wait_Count is less than or equal to 5
CICSplex_ENQWaitCount_Critical
This is the critical threshold exceeded for enqueue task waits.

Select the Enqueue Analysis report to find all tasks waiting on enqueues and the owners of the serially reusable resources. If an enqueue is not being released, examine the owning task's resource type to determine whether it is looping, waiting on a resource, or deadlocked with another task. You can use the KILL command of Tivoli OMEGAMON XE for CICS on z/OS to free the enqueue and allow the waiting tasks to continue. To limit the number of tasks suspended because of enqueue conflicts, consider transaction classes.

Formula

If the value of the attribute Wait_Count is greater than 5
CICSplex_SysplexEnq_Warning
Sysplex enqueues warning.

The current number of waiting Sysplex enqueues has exceeded 20. Use the Transaction Analysis workspace to determine which transactions are enqueuing resources for excessive time periods. Investigate the applications to determine why they are serially accessing resources across the Sysplex.

Formula

If the value of the attribute CICSplex_Enqueue_Pool_Details.Current_Sysplex_waiting
 is greater than 20
CICSplex_SysplexEnq_Critical
Sysplex enqueues critical.

The current number of waiting Sysplex enqueues has exceeded 50, and the situation can now be considered critical. Use the Transaction Analysis workspace to determine which transactions are enqueuing on resources for excessive time periods. Investigate the applications to determine why they are serially accessing resources across the Sysplex.

Formula

If the value of the attribute CICSplex_Enqueue_Pool_Details.Current_Sysplex_waiting
 is greater than 50

See also the CICSplex Enqueue Analysis attribute group.