Specifying associations in comment patterns

If the CQCC_COMMENT_PATTERN configuration parameter is enabled in the configuration file that is used on your system, you can provide, in checkout or checkin comments, the pattern that the integration checks. The pattern provides a list of associations to use and replaces the prompting for associations by the integration interface. The pattern that you supply in the checkout or checkin comment is matched against the pattern that is defined in the CQCC_COMMENT_PATTERN configuration parameter.

The change requests that you specify in comments on checkin commands override the change requests that you specify on checkout commands.

If the CQCC_AUTO_ASSOCIATE_ENABLE configuration parameter and the CQCC_COMMENT_PATTERN configuration parameter are enabled at the same time in the configuration file that is used on your system, the integration uses automatic associations defined in CQCC_AUTO_ASSOCIATE when it makes associations.

The project manager specifies, in the CQCC_COMMENT_PATTERN configuration parameter, a pattern in the form of a Perl expression. For example:

&SetConfigParm("CQCC_COMMENT_PATTERN", "BUGS:\\[(\\S+)\\]");

This setting enables the option for you to supply a string that matches the pattern in checkout and checkin comments to specify associations between the related versions and Rational® ClearQuest® records. This example uses double backslash characters to escape each backslash character. You cannot set this pattern locally in an environment variable.

Make associations by entering a checkin or checkout comment that matches the pattern, as in the following example of a checkout comment:

"This fixes BUGS:[SAMPL1,2,3]"

The pattern uses the same conventions that are used in the Type In option in the user interface. The value SAMPL1,2,3 identifies change request IDs 1, 2, and 3 in the SAMPL user database.