Analysis Unit editor
This section provides a detailed description of the Analysis Unit editor. This editor essentially provides a means for you to create a new Analysis Unit or edit the configuration of an existing or auto-created Analysis Unit.
- An Analysis Unit can best be described as a set of configuration settings that govern how a perimeter of source code is consistently analyzed.
- Analysis Units are automatically created when you use the Set as current version option (see the Delivery tab) - as such they correspond to Projects discovered by the CAST Delivery Manager Tool. However, they can also be created manually using this editor for situations where no Analysis Unit has been automatically created for a given project.
- When the Analysis Unit has been created automatically, options will "inherit" their initial configuration settings from the discovery process in the CAST Delivery Manager Tool (i.e. "project" settings). Where an option could not be defined automatically via the CAST Delivery Manager Tool, it will "inherit" its initial configuration settings from those defined at Technology level (see Technology editors) and at Application level (see the Analysis tab and the Production tab in the Application editor).
- Analysis Units that are manually defined will "inherit" their initial configuration settings from the settings defined at Technology level (see Technology editors) and at Application level (see the Analysis tab and the Production tab in the Application editor).
- Modifying an identical option at Technology level (see Technology editors) or at Application level (see the Analysis tab and the Production tab in the Application editor) will automatically update the same option in the Analysis Unit editor unless that specific option has already been modified independently in the Analysis Unit editor.
- Note about the Reset option: some options have a "Reset" option next to them - using this will reset the option to the value set at at Application level (see the Analysis tab and the Production tab in the Application editor):
The above screen shot shows the Analysis Unit editor for a J2EE Analysis Unit.
|Name||Displays the name of your Analysis Unit: |
You can edit the field by selecting it and then modifying or replacing as appropriate. Please see Naming constraints for more information.
|Analysis Unit Description||Use this area to make notes or remarks about the item.|
Source Settings tab
The options in these tabs are explained below:
- Oracle Forms and Reports
- MS SQL Server / Sybase ASE
- Universal Analyzer/Importer Analysis Unit
- Visual Basic
The options in these tabs are explained in the relevant Technology editors.
The Production tab only contains a Dynamic Links Rules section. It allows you to assign a Dynamic Link Manager rule file (*.DLM.XML file) to the Analysis Unit. The interface is explained in the Application editor Production tab.
You can find out more information about Dynamic Link Manager rule files here: Dynamic Link Manager filter rules.
|Run Analysis on the current analysis unit's group||This option will run an analysis on the current Analysis Unit and save the results to the CAST Analysis Service. Any associated Analysis Unit's in the current Analysis Unit's parent Execution Unit will also be analyzed to maintain consistency of the analysis results - in other words, the results produced by this option will be identical to the results produced when generating a snapshot that includes the current Analysis Unit. |
However, please note that if the current Analysis Unit is used as a target for a Dependency Rule in the parent Application, then any other Analysis Units involved in the Dependency Rule will not be re-analyzed - therefore results (i.e. links between objects) may be incomplete - if this is the case, the following message will be displayed:
Analysis Unit 'XXX' is the target of a Dependency Rule involving other Analysis Units within the application.These other Analysis Units will not be re-analyzed, therefore the results may be incomplete.
Additionally, these missing dependencies are logged in CAST-MS.log.txt with the following format:
Dependencies are missing from analysis: XXX. This might cause the absence of links to these dependencies.
|Test Analysis on the current analysis unit's group||This option is identical to the Run Analysis on the current analysis unit's group option described above but no results will be saved to the CAST Analysis Service. This is purely for testing the analysis can run without error: you can consult the log files to resolve an issue before you use the run an analysis option or Generate a Snapshot, both of which will save the results to the Analysis Service.|
|View Analysis Unit content||This option will show the objects that have been saved to the CAST Analysis Service on successful completion of an analysis. Note that no information will be visible if you have only used the Test analysis option. |
Analysis Unit implementation
|Analyze Analysis Unit|| Allows you to include/exclude the current Analysis Unit from an analysis. |
|Execution Unit annotation||See Working with Execution Units for more information. |
Only available in some Analysis Units (for technologies that support Execution Units).
|Code Size (bytes)|
|Is Application entry point|
|Don't show in the Dashboard||This option allows you to flag objects in the Analysis Unit as "external": |
This option will be checked automatically for Analysis Units whose corresponding projects have been excluded (marked as Ignored) in the CAST Delivery Manager Tool, and where one or more dependent projects in the same source code package are included (marked as Selected). There is more information about this in the CAST Delivery Manager Tool help.
Last Execution Summary
|Last Execution Status||Displays the status of the most recent execution (as part of a snapshot or standalone analysis) of the current Analysis Unit.|
|Last Execution Date||Displays the date of the most recent execution (as part of a snapshot or standalone analysis) of the current Analysis Unit.|
|Last Execution Log||Displays the location of the analysis log for the most recent execution (as part of a snapshot or standalone analysis) of the current Analysis Unit. Click the Open button to display the log.|
The following buttons are available in the view:
|Minimize > Minimize the entire window|
|Maximize > Maximize the entire window|