B.1 Understanding the ClearCase-ClearQuest Integrations

The integration of ClearQuest and ClearCase associates one or more ClearQuest records with one or more ClearCase versions, allowing you to use features of each product. ClearCase supports two separate integrations with ClearQuest:

• The base ClearCase-ClearQuest integration

• The UCM-ClearQuest integration

For information on setting up the base ClearCase-ClearQuest integration, see Chapter 13, Setting Up the Base ClearCase-ClearQuest Integration. Note that this integration cannot be used with UCM projects.

For further information on the UCM-ClearQuest integration, see Part 1 of this book.

In general, we recommend that you use the base ClearCase and UCM integrations separately, and avoid using a common ClearQuest user database. However, it is possible for both integrations to use the same ClearQuest user database. This can be useful if you are moving a project to UCM and have a substantial amount of information in a ClearQuest user database that was created with the base ClearCase-ClearQuest integration. You may want the new work in UCM to be reflected in new ClearQuest records in the same ClearQuest user database.

The remainder of this appendix discusses considerations in managing the coexistence of the base ClearCase-ClearQuest integration and the UCM-ClearQuest integration.

Managing Coexisting Integrations

When a ClearQuest user database that had been integrated with ClearCase previously is configured for integration with UCM, the existing change sets are preserved intact in the ClearQuest user database, but cannot be migrated to the UCM integration.

Change sets of existing records in the ClearQuest user database are preserved, and you can access them from ClearQuest. To continue work on a task in a project that has been migrated to UCM, create a new, corresponding, UCM activity and continue work there.

See Planning How to Use the UCM-ClearQuest Integration for related information.

Schema

A ClearQuest schema can contain modifications from both the base ClearCase-ClearQuest integration and the UCM-ClearQuest integration. A record type in such a schema would include both the ClearCase package and the Unified Change Management package.

An individual record of that record type can store either ClearCase or UCM change set information, but not both.

Presentation

The form for a record type that uses both integrations includes two tabs to show the change set information associated with each integration, as shown in Figure 58. The Unified Change Management tab lists the change set for a UCM activity. The ClearCase tab shows the change set associated with a ClearQuest record.

Figure 58 Change Sets in ClearQuest GUI