About first-time use

If the VOB in which you access versions is set up for the base ClearCase® integration with ClearQuest®, you may have to associate the version on which you are working with a ClearQuest record. To do this, you have to be logged on to a ClearQuest user database in which change request records for your project are stored.

Logging on to a ClearQuest user database

The first time that you attempt to check out an element from or check in an element to a VOB enabled for the base ClearCase integration with ClearQuest, you are prompted to log in to IBM ClearQuest. Specify a ClearQuest user ID, password, and ClearQuest user database name. ClearQuest user IDs and passwords are kept in their own database. Make sure that your ClearQuest administrator has added a user ID and password to the ClearQuest user database for you.

After you log in to ClearQuest, you can use the integration to complete your checkout and checkin operations. The integration stores the user ID and an encoded version of the password in a file named .cqparams, which it creates in platform-specific areas. On UNIX workstations, it is stored in the home directory. On Windows computers, it is stored in the following location:

<windows>\Profiles\<login>\Application Data\Rational\Cqcc\

Thereafter, the integration uses the user ID and password in .cqparams instead of prompting you for them. If you change your password or connect to a different ClearQuest user database, the next time you check out or check in a version from that VOB, the integration displays an error message and prompts you to reenter the user ID and password. The integration updates the .cqparams file with the new information.

The base ClearCase integration with ClearQuest interfaces

If you are logged on to a ClearQuest user database and check out or check in an element in a VOB enabled for ClearQuest, you see a modified interface, one for a graphic user interface or one for a command line interface. If you use File Browser on a UNIX system or Linux, or if you useRational® ClearCase Explorer or Windows Explorer on a Windows system, the Association dialog window opens.

Using the modified graphic user interface(s)

For the modified graphic user interface, the integration is based on a Perl trigger. The Association dialog window displays the result set of a standard ClearQuest query, usually showing all open change-request IDs currently assigned to you. If local policies allow, you can select and run alternative site-specific queries or queries supplied with ClearQuest.

Select an entry in the result set and click Associate to create an association between the versions you are checking out and the change request. If multiple selections are allowed on your project, select multiple entries. With at least one association, click OK to continue the checkout. To close the dialog box without making a change, click Cancel. For more information, click Help in the window.

On Windows systems: Some systems use an alternative integration based on a Visual Basic trigger to provide a graphic user interface. (This interface lacks the Database and Record Type buttons that the Perl-base interface has.) You use the Associate Change Requests dialog box to associate a ClearCase version with one or more ClearQuest change requests and to remove existing associations. To change your stored user name, password, or ClearQuest user database name, use the Registry Editor to delete the key similar to the following:

HKEY_CURRENT_USER\Software\Rational Software\ClearQuest\2003.06.00\Common\CQIntSvr

The integration prompts you for the information the next time that you check in or check out a version.