Enabling link validity in CLM projects

For each project that is enabled for configurations in the QM and RM applications, and in the DM application, you can choose to show or hide the link validity status of links and the validity summary of artifacts. Show this information to help you determine which artifacts and relationships you need to examine and update when changes are made. Hide this information to reduce the clutter on the page when you know that your team does not need it.

Before you begin

  • A Jazz™ Administrator must activate configuration management for the Quality Management (QM) and Requirements Management (RM) applications.
  • QM and RM applications: You must have configuration management enabled for at least one project. Read a guidance article for links to videos, considerations, and other resources to help you decide if using configuration management tools is right for your team.
  • All CLM applications must be the same version (6.0.1 or later).
  • The advanced server property for link validity must be enabled for your application:
    • RM application: The advanced server property named "Link Validity enabled" must be true in the RM Client Component and RM Core Component sections. By default, it is set to true in both locations.
    • QM application:
      • You must have permission to save project properties.
      • The advanced server property named Link Validity must be true, which is its default value.
    Note: Starting in version 6.0.1, Design Management supports link validity. For more information about the support, see the 6.0.1 release notes.

About this task

To learn more about link validity:
  • Read the related Link validity concept topic, which contains definitions and examples.
  • Watch the related YouTube video that describes link validity. Although this video was created in version 6.0.1, the feature is similar in this CLM version.

The Requirements Management (RM), Quality Management (QM), and Design Management applications provide two kinds of validity information about requirement, test and design artifacts:
  • Link validity, the status of links between artifacts to indicate whether the contents of two artifacts meet the intended meaning of the link between them.
  • Validity summary, a rollup of the status of all the relevant links for an artifact. It specifies whether you need to investigate specific relationships further and modify artifacts to achieve or restore the intended meaning of the link.

When artifact contents change, the system marks the link between them as Suspect. Someone must examine the artifacts and link to determine whether the intended link meaning is still satisfied. If changes are required to restore the intended meaning, typically a team member changes the downstream artifact.

By default, the Show link validity option is disabled, and you can change it at any time. For example, when work begins at the start of a release or milestone, the link validity status might not be as important to consider, so you might enable it later in the release.

For details and examples that explain link validity status and validity summary information, see Link validity.


Complete the steps for the application you are enabling:
Application Steps
Design Management (DM)
  1. From the Administration Administration menu menu, click Manage This Project Area.
  2. Click Design Domain.
  3. Select or clear Show link validity to show or hide link validity status, and click Save.
Quality Management (QM)
  1. From the Administration Administration menu menu, click Manage Project Properties.
  2. In the Properties section, click Link Validity.
  3. Select or clear Show link validity to show or hide link validity status, and click Save.
  4. (Optional) When a test case is approved, mark all links as Valid: Select this option to enable the system to automatically mark each link to corresponding requirements as Valid after a team member approves a test case. This option saves team members time when working with large numbers of test cases because they do not need to manually validate each test case-to-requirement link.
Requirements Management (RM)
  1. From the Administration Administration menu menu, click Manage Component Properties.
  2. On the Link Validity tab, select or clear Show link validity to show or hide link validity status, and click Save.


After you enable the Show link validity option, link validity information is shown where links to artifacts are shown. See this related topic for a list.

Link validity status information is collected by the Lifecycle Query Engine (LQE) data source whether you show or hide this information.

If the system cannot determine the validity status of a link, it sets the status to "Unknown" and the validity summary of the appropriate artifact as "Undetermined". Determine the cause of the problem: for example, a network problem, the database containing the link information cannot be reached, and so on. Explore the error log files. You might have to restart the application server.

What to do next

Grant permission to set link validity to the team members who need it.

In the Lifecycle Query Engine (LQE) application, grant access to link validity data so team members can report on link validity information.

video icon Watch videos

CLM playlist
Jazz.net channel
User Education channel

learn icon Learn more

CLM learning circle
Agile learning circle
Learning circles

ask icon Ask questions

Jazz.net forum
developerWorks forums

support icon Get support

Support Portal
Deployment wiki
Support blog