Adding a Microsoft Visual SourceSafe integration

The Visual SourceSafe integration adds Visual SourceSafe fields to a record type you select, and the Visual SourceSafe tab to the record type form.

The Microsoft® Visual SourceSafe integration requires the following steps (described in detail in the sections that follow)

For instructions on using the integration after completing these steps, see the Help for the Rational ClearQuest for Visual SourceSafe tool.

Note: If you already have this package in your schema and just want to apply it to a new record type, see Integrating Rational ClearQuest with other products for instructions.

Adding the Visual SourceSafe package

Note: You can only apply a Visual SourceSafe package to one record type in a schema.
  1. In Rational ClearQuest Designer, make sure the schema you want to add the package to is checked in. To check in a schema, click File > Check In.
  2. Click Package > Package Wizard and add the latest Visual SourceSafe package. See Applying package upgrades.

Saving the schema changes

After installing the Visual SourceSafe package:

  1. Validate the schema changes. See the schema developer help for more information.
  2. Click File > Check In to save the schema changes. See Checking in a schema.
  3. Apply schema changes to the user database by clicking Database > Upgrade Database. See the schema developer help for more information.

Creating a query in Rational ClearQuest client

You need to create a query that users can use to find the records you want to associate with Visual SourceSafe projects.

To create a query:

  1. Log in to the Rational ClearQuest Client as a user with Public Folder privileges.
  2. Define the query. See the Rational ClearQuest Client Help for detailed instructions.

Setting up each client machine

Note: When you run the Rational ClearQuest for Visual Source Safe tool, cqvss.exe, the information you enter is stored in a .ini file, in the following location:
 vss\users\<user_name directory>\cqsspref.ini 

 

On each client machine where the Visual Source Safe integration will be used:

  1. Start the Rational ClearQuest for Visual Source Safe tool (cqvss.exe) located in the Rational ClearQuest home directory. You can drag a copy of cqvss.exe to the desktop to create a shortcut to it.
  2. Log in and select the Visual SourceSafe database you want to use.
  3. In the Rational ClearQuest tools for Visual SourceSafe window, click Setup Tool.
  4. In the Visual SourceSafe Integration window, select the Rational ClearQuest query you created in Creating a query in Rational ClearQuest client and click OK.

Feedback