Using automatic associations

If the CQCC_AUTO_ASSOCIATE_ENABLE configuration parameter is enabled in the configuration file that is used on your system, you can specify automatic associations. Use the CQCC_AUTO_ASSOCIATE environment variable specify one or more change requests to associate with a batch of files on checkout and checkin operations without the user interface being displayed. The integration uses the change requests that you specify rather than prompting you through the user interface. (The ApplyToAll mechanism in the integration user interface works only for files being versioned in a single checkin or checkout command.) With this automatic association option, you can handle large batches of files in multiple checkin and checkout commands.

Set the CQCC_AUTO_ASSOCIATE environment variable to the associations that you want to make and then start either cleartool, File Browser, or DevOps ClearCase® Explorer. The following values are recognized:

  • To specify change requests, use the same conventions that are used in the Type In option in the user interface.
  • To disable the option, use ″″.
  • To select no change requests, specify ″-″.

On checkin operations, the integration uses the values that you specify with this option to override associations that you made on checkouts. If an error occurs, the integration displays the related messages and starts the user interface for associating change requests.

The Type In option specifies change requests. For example:

setenv CQCC_AUTO_ASSOCIATE "SAMPL1,2,3"

The value ″SAMPL1,2,3″ identifies change request IDs 1, 2, and 3 in the SAMPL user database.

The values that you specify remain in effect until you disable the option. For example: 

setenv CQCC_AUTO_ASSOCIATE ""