This section describes a sample use of Change Analyzer that should help you get oriented in the tool. Assume that you want
to evaluate the impact of changing the
YEAR field in your application.
In the Repository Browser, select the project you want to analyze and choose
Analyze > Change Analyzer.
The Change Analyzer window opens.
Tools > Analysis Options, select
Use Cross Program Analysis and click
Select a file from the list of programs and click
(Step 1: Populate starting point list).
A message informing you that any existing lists will be deleted pops up. Click
When the Search window opens, click
on the tool bar to define a new criterion. In the New Criterion dialog, enter
YEAR and click
YEAR criterion is displayed in the list of recognized criteria in the Change Analyzer tab in the Search window.
In the Change Analyzer tab, select the
YEAR criterion and then enter the following search text for the criterion in the Name Like tab:
Find All Constructs.
You are informed about the number of constructs found.
The Starting point tab is now populated with the seed fields for the criterion.
All Programs (all starting points). If a messages pops up informing you that cross-program is enabled and the analysis might take excessive amount of time,
The Find Synonyms dialog opens.
Specify the depth of synonym processing in the
Depth combo box, then click
The Lists pane is now populated with tabs with synonyms for each of the seed fields found in the first step of the analysis.
Note: Depth refers to both depth level of flow IN and OUT of the target field. The default value is 5. This means that Change Analyzer
will search for synonyms of the selected field five levels up and five levels down from the current one. The maximum depth
Select a seed field to navigate to its declaration in the Source pane. Examine the declaration to determine whether the field
will be affected by the proposed change.
Right-click a seed field in any of the Affected by lists and choose
Trace in the right-click menu.
Change Analyzer displays the synonyms for the selected field in the Impact Tracing pane.
Examine the declaration for each synonym to determine whether the field will be affected by the proposed change.
Optionally you can create a new list using
Lists > Add List and move any of the seed fields there to better suit your needs. For information on how to do it, see
Moving or Copying Fields between Lists below.
Tools > Reports. The Report Selection dialog opens. In the
Report Type drop-down, select
Report on the Whole List and click
OK and then
Yes if a message pops up asking you if you want to continue.
Change Analyzer displays the report for the Affected list.