CMS - Analysis Unit editor

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.

Notes

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:

In the case of newly created Analysis Units, this will be displayed as New XXX Analysis Unit (where XXX corresponds to the Technology type) and all other fields will be empty
In the case of existing Analysis Units that have been defined automatically, the name is determined by the CAST Management Studio and the CAST Delivery Manager Tool, using the name of the corresponding project. For example, for J2EE based source code, the name defined in the <name> tags of a .project file will be used:
```
<?xml version="1.0" encoding="UTF-8"?><projectDescription> <name>CastPubs</name> <comment></comment> <projects></projects> <buildSpec>  <buildCommand>   <name>org.eclipse.jdt.core.javabuilder</name>   <arguments></arguments>  </buildCommand> </buildSpec> <natures>  <nature>org.eclipse.jdt.core.javanature</nature> </natures></projectDescription>
```

You can edit the field by selecting it and then modifying or replacing as appropriate. Please see Naming constraints for more information.

Notes

The Name of a database type Analysis Unit is not visible and cannot be edited.

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:

Analysis tab

The options in these tabs are explained in the relevant Technology editors.

Production tab

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.

Execute tab

Options

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. Checked > The Analysis Unit will be included in the analysis Unchecked > The Analysis Unit will NOT be included in the source code analysis. This is usually done to temporarily remove an Analysis Unit from the Application and hence from the source code analysis. Note that you should delete the Analysis Unit in the Current Version tab of the Application editor if you want to permanently remove an Analysis Unit from the Application. Notes Unchecking this option can lead to a loss of objects and/or links Running the Clean up Analysis Units option will remove any Analysis Units from the parent Application where this option has been unchecked. You can view how this setting is configured for each Analysis Unit by using the Current Version tab in the Application editor:
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": Checked > The corresponding Analysis Unit and its objects WILL be analyzed so as to avoid link resolution errors and will thus be visible in CAST Enlighten, however, the objects resulting from the analysis of the Analysis Unit will be flagged as "external" and WILL NOT contribute to any calculations executed for the CAST Health Dashboard/CAST Engineering Dashboard and WILL NOT figure in any results displayed in the CAST Health Dashboard/CAST Engineering Dashboard. Unchecked > The corresponding Analysis Unit and its objects WILL be analyzed so as to avoid link resolution errors and will thus be visible in CAST Enlighten. Objects resulting from the analysis of the Analysis Unit WILL contribute to any calculations executed for the CAST Dashboard and WILL figure in any results displayed in the CAST Health Dashboard/CAST Engineering Dashboard. 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.

Editor buttons

The following buttons are available in the view:

	Minimize > Minimize the entire window
	Maximize > Maximize the entire window