Defining a batch

(see Using the association batch feature)

If you use the CQCC_ASSOC_BATCH_ENABLE configuration parameter in the configuration file, the developer can also use the environment variable CQCC_ASSOC_BATCH_SERIES to define a batch. A batch is ordinarily the set of files to which a single DevOps Code ClearCase® operation is applied. The CQCC_ASSOC_BATCH_SERIES environment variable provides a way for a developer to broaden the meaning of a batch to be a series of ClearCase operations. This is useful for checking in multiple files more efficiently than checking them in one at a time.

If the CQCC_ASSOC_BATCH_SERIES environment variable is set to TRUE, the integration assumes that a batch is in effect and operations are logged. When the environment variable is set to FALSE, the next ClearCase operation automatically causes the logged operations to be run. Use this option carefully because Rational® ClearQuest® changes are deferred if a series is in process. The developer can force the batch log to be flushed. For example, a script that checks in a series of files might look like this example (in the Windows® system).

set CQCC_ASSOC_BATCH_SERIES=TRUE
cleartool ci -nc file1
cleartool ci -nc file2
set CQCC_ASSOC_BATCH_SERIES=FALSE
cqcc_launch -vob -op batch 

The last command forces the batch log to be flushed.