ccollab addchangelist (for Rational Team Concert)

Applies to Collaborator 14.6, last modified on July 10, 2024


The ccollab addchangelist command attaches all files from a submitted Rational Team Concert changelist to a review on the Collaborator server.

In order to use Rational Team Concert integration from command-line client, you need to configure both Collaborator server and clients and RTC server. See configuration instructions.

Command Line Syntax

ccollab [global-options] addchangelist <review> <changelist> [<changelist> ...] --exclude <file-mask list> --include <file-mask list>

Command Options






A number of global or RTC-specific global options. See Command-line Global Options Reference.



Identifier of the desired review (an integer number), or a new, ask, or last keyword. Where keywords define the following behaviour:

  • new - the command will create a new review,
  • ask - the command will pause execution and prompt for the identifier of the desired review,
  • last - the command will use the last review that was created on the current machine via Command-Line Client (that is, it does not know about reviews created elsewhere).

<changelist> [<changelist> ...]


Identifier(s) of the desired changeset(s) in your source control.

--exclude <file-mask list>


Exclude files from changelist(s), that match specified mask(s), will be ignored (changelist command uploads to review only files that don’t match the masks).

When no files in changelist are matches to the mask(s) then whole changelist is uploaded ('exclude' option is ignored)

--include <file-mask list>


Includes only files that match specified mask(s) will be uploaded to review.

When no files in changelist are matches to the mask(s) then nothing is uploaded.



Set whether to skip changelist if it already exists in review.



Set whether empty changelist errors will be ignored when multiple changelists are uploaded. If all changelists are empty the command will throw an exception anyways.


To upload changelists __Uz3kBZzEeix-IUSbGNKOg and _x2fOcBubEeix-IUSbGNKOg to a new review:

ccollab addchangelist new __Uz3kBZzEeix-IUSbGNKOg _x2fOcBubEeix-IUSbGNKOg

To upload changelist __Uz3kBZzEeix-IUSbGNKOg and _x2fOcBubEeix-IUSbGNKOg to review 111:

ccollab addchangelist 111 __Uz3kBZzEeix-IUSbGNKOg _x2fOcBubEeix-IUSbGNKOg

To upload changelist __Uz3kBZzEeix with all .java and .txt files except that started with 'test' to a new review

ccollab addchangelist new __Uz3kBZzEeix --include '*.java, *.txt' --exclude 'test*.*'

See Also

IBM Rational Team Concert Integration
ccollab addchangelist

Highlight search results