Verifying models or packages

At any point in the modeling process, you can check the validity of the whole model or selected objects in the model such as a package. First, verify the model and repair any problems, and then verify each package within a model individually. By verifying a package, you can find and remove invalid objects that can cause a query to fail.

When you verify a model or package, IBM® Cognos® Framework Manager looks for messages in the following categories:

Category	Description
Internal Model Inconsistencies	Verifies that objects are properly defined and that duplicate names are not used. Always run this group of tests.
Invalid or Incomplete Object References	Checks for dangling references or references to missing objects.
Determinant Completeness	Verifies that determinants are completely defined with keys and attributes, and that all query items are accounted for in a determinant.
Dimension Completeness	Verifies that dimensions are fully defined with level member captions and business keys.
Query Status	Verifies that the evaluation status for query subjects and dimensions is valid and is not set to "needs reevaluation" or "invalid". Query status does not verify shortcut objects. For example, you create a shortcut to an object. The object becomes invalid for some reason. If you verify the object, a message is shown because it is invalid. When you verify the shortcut, no message is shown.
Backward Compatibility	Informs you that a model contains features from a previous release that have been maintained but will be deprecated in a future release.
Verify Relationship Cardinality	Warns when many-to-many relationships are found.

Each category can generate multiple messages for an object. For each message, the severity, object icon, object ID, description of the message, explanation of how to correct the problem, and possible actions that can be performed on the object are provided. You may be able to correct a problem immediately by modifying the object that caused the problem or by asking Framework Manager to repair the problem.

Procedure

Choose one of the following:

Goal	Action
Verify a model	From the Project menu, click Verify Model.
Verify a package	In the Project Viewer, right-click a package, and click Verify Selected Objects.
Verify selected objects	In the Project Viewer, select one or more objects, right-click, and click Verify Selected Objects.

On the Options tab, select the message severity levels that you want to see in the results.

By default, all message severity level check boxes are selected. Clear the ones that you do not want.
Select the categories that you want to verify.

By default, all category check boxes are selected. Clear the ones that you do not want.
Click Verify Model.

The Verify Model Results tab shows the results.
To sort the messages, click Sort in the severity, object type, or name column heading.
To see the object that is related to the message, under the Actions heading, click Find in Project Viewer.
To repair problems for a group, select a grouping criteria from the list.
Select the check box beside each message for the problem that you want to repair.
Tips:
- To select all messages, select the check box at the top of the check box column. To clear all selected messages, clear the check box at the top of the check box column.
- If you grouped the messages, select the check box at the top of the group check box column to select all messages in the group.
- To hide the message detail information, click Collapse in the group heading.
Click Repair Selected.
Framework Manager repairs the problems in the following order:
- invalid references
- invalid objects, invalid relationships, invalid aggregation rules, missing locales, unsupported prompt types, inferred roles, and re-evaluate; in no particular order
- upgraded model errors
You can also repair problems by clicking the Edit Definition icon under the Actions heading for the message. In the dialog box, modify the definition of the object as required.

Results

When the repair process is finished, a summary of the repair results displays. The model or package is verified again and the results are shown in the Verify Model Results tab.

Tip: Problems that cannot be repaired during the verification of a package may be repaired using verify model.

For stand-alone filters, if the underlying objects might not be valid, a "needs reevaluation" message displays. The Repair option does not work for stand-alone filters. To ensure that the stand-alone filters are valid, open each filter and save it.