Question & Answer
This Technote describes the use of the CQCC_AUTO_ASSOCIATE environment variable in the IBM® Rational® ClearCase® config.pl file, used with the IBM Rational Base ClearCase / Rational ClearQuest® integration.
Released with the ClearCase version 2002 Patch 15 and contained in all subsequent versions of ClearCase, the CQCC_AUTO_ASSOCIATE allows you to associate many ClearCase elements with one or more ClearQuest records, without manually having to select each of them in the integration user interface.
To specify one or more ClearQuest records to associate with a batch of ClearCase elements without displaying the integration user interface, set the environment variable "CQCC_AUTO_ASSOCIATE" to the associations you want to make, before starting cleartool command or the ClearCase Explorer application.
If enabled at your site, use this option to specify one or more ClearQuest records that you want to associate with ClearCase elements during checkout and checkin operations. The integration uses the ClearQuest records that you specify, rather than prompting you ClearQuest record selections through the integration user interface. The "ApplyToAll" button in the integration user interface works only for ClearCase elements being versioned in a single checkin or checkout command. This option lets you handle large batches of ClearCase elements in multiple checkin and checkout commands.
Use the same conventions used in the "Type In" option in the integration user interface to specify ClearQuest records. For example, "SAMPL1,2,3" identifies the ClearQuest records IDs 1, 2, and 3 in the ClearQuest SAMPL user database.
The values you specify remain in effect, until you unset the option, or set it to "". On checkin operations, the integration uses the values you specify with this option to override associations you made on checkouts. Specify "-" to set the option to select no ClearQuest records. If errors occur, the integration displays them, and then starts the integration user interface for associating ClearQuest records.
======== Administrator documentation ================
CQCC_AUTO_ASSOCIATE_ENABLE: [DEFAULT: "TRUE"]
In the config file (config.pl), use this option to specify whether local users may use the CQCC_AUTO_ASSOCIATE option. To prohibit use of the
CQCC_AUTO_ASSOCIATE option, set CQCC_AUTO_ASSOCIATE_ENABLE to "FALSE". To allow use of CQCC_AUTO_ASSOCIATE, set CQCC_AUTO_ASSOCIATE_ENABLE to "TRUE".
04 December 2018