Impact analysis time out facility

While the impact analysis collector is active, it is consuming resources.

Since it is possible to start impact analysis collection and then move on to other kinds of analysis without turning the collector off, the impact analysis time out facility automatically terminates the collector after a period of time. This time period is equal to the short-term collection interval multiplied by the number of short-term intervals in the long-term interval. For example, if the short-term interval is 1 minute and the long-term interval is 5 short-term intervals (the defaults), impact analysis times out after 5 minutes. You can set the long-term interval by scrolling to the IACL statement. The format is:

IACLn 
b or 0
Displays the current long-term bucket clearing interval.
1–5
Sets the long-term bucket clearing interval at 1–5 short-term intervals. The default is 5.

For example, if you set IACL to 1, there is no difference between the short and long-term intervals in the impact analysis display. If you set IACL to 3, the long-term part of the impact analysis display includes the current short-term interval, plus the two previous short-term intervals.

You can set the short-term interval by scrolling to the IACS statement. This is the format:

IACSnn 
b or 0
Displays the current short-term bucket clearing interval, and clears the short-term bucket immediately. OMEGAMON for CICS (3270) does not clear the bucket again until the IACL statement is reentered with a numeric operand.
1–99
Sets the short-term bucket clearing interval at 1–99 minutes. The default setting is 1 minute.

You can use the IACS statement at any time during a session. OMEGAMON for CICS (3270) automatically clears the buckets as soon as you use this option.

You can set the number of groups that you want to monitor for the impact analysis display by scrolling to the IANC statement. This is the format:

IANCnn 
b or 0
Displays the current maximum number of CICS® regions or groups monitored by impact analysis.
1–5
Sets the maximum number of CICS regions or groups to 1–5. The default is a maximum of 5 CICS regions or groups.

If you wish to monitor fewer than five regions or groups, you must reduce the maximum with the IANC statement before you begin the session (that is, before you use IANL the first time). Upon execution, IANC issues a message informing you of the new maximum number.

You cannot change the maximum number of regions while the collector is running; you must either do so before you start the collector, or you must stop the collector, change the number of regions, and then restart collection.

You can set the severity threshold for the impact analysis display by scrolling to the IATH statement. This is the format:

IATHnn 

You can enter the IATH statement at any time during a session.

b
Displays the current value.
0
Displays all impact sources.
1–99
Causes impact analysis to display impact sources that account for the indicated percentage or more of non-idle time of the CICS region or group. By default, impact sources that account for 5% or more of the total non-idle time of the CICS region or group are shown in the display.

For example, to limit impact analysis displays to impact sources that account for 10% or more of the non-idle time, enter the following statement:

IATH10 

The resulting message shows you the new threshold value.

Figure 1. Plot Percentage Message Example
IATH  >> IA2006 Plot percentage threshold is 10% <<

Notice that the operand is expressed as a percentage and that the statement is not commented out (preceded by >) after execution.