Getting started with Rational Team Concert source control

You can use Rational Team Concert™ source control to manage source code, documents, and other artifacts that you want to place under version control and share with a team.
Rational Team Concert source control is closely integrated with the other application development lifecycle tools included in Rational Team Concert.
  • The Jazz™ Build Engine and Build System Toolkit have built-in support for loading files from Rational Team Concert source control, capturing snapshots of build input so that a build can be reproduced exactly, and direct access to a rich set of tools that you can use to view the component versions that are present in a specific build and compare them with versions in other builds, streams, and workspaces. For more information, see Building with Rational Team Concert Build.
  • Change sets can be linked to work items, enabling traceability of individual changes and insight into the reasons why they were made. For more information, see Tracking work by using work items.
  • Process pre-conditions can be used to control the flow of change sets. For example, you can configure a process so that a change set must be reviewed and approved before it can be delivered to an integration stream. For more information, see Administering change and configuration management projects.

Workspaces, change sets, and change flow

Rational Team Concert source control stores artifacts such as files and folders in the Jazz repository. You create a repository workspace to hold your private copies of the files and folders that you want to work with, and then load the contents of your repository workspace into a sandbox (a directory in your computer's file system) so that the files and folders are accessible to tools like editors, compilers, and integrated development environments. As you make changes to the contents of your sandbox, you periodically check them in, which copies them to the repository workspace, so that the changes are backed up on the server. In the repository workspace, related changes are collected as change sets, which enable changes in multiple files and folders to be delivered in a single operation.

Figure 1 illustrates a simple configuration of a repository workspace and a single component. Check-in copies changes from the sandbox to the repository workspace. Load loads the sandbox with the contents of the repository workspace.
Figure 1. Check-in copies work from your sandbox to your repository workspace
Check-in copies work from your sandbox to your repository workspace
When you work as part of a team, your workspace and the workspaces of other team members are configured to deliver their changes to a shared repository object called a stream. Figure 2 shows how change sets created in a sandbox and then checked in to a repository workspace can be shared by delivering them to a stream that all team members use. Because the stream is a flow target of all team members' repository workspaces, the change sets it contains are accessible to all team members.
Figure 2. Change sets checked in to a repository workspace can be delivered to a stream to make them available to other team members
Change sets checked in to a repository workspace can be delivered to a stream to make them available to other team members

First steps with Rational Team Concert source control

You can take your first steps with Rational Team Concert source control on your own, or as part of a team.

The following diagram demonstrates a sample source control workflow. The diagram is provided only as an example. Although many of the steps can be done using either the Web interface or the Eclipse client, the steps link to topics that refer to the Eclipse client.

Example source control
work flow for Rational Team Concert Click this area to get information about creating a repository workspace from a stream Click this area to get information about accepting incoming change sets Click this area to get information about sharing an Eclipse project with your team Click this area to get information about checking in change sets Click this area to get information about delivering change sets

video icon Watch videos

CLM playlist
Jazz.net channel
User Education channel

learn icon Learn more

CLM learning circle
Agile learning circle
Learning circles

ask icon Ask questions

Jazz.net forum
developerWorks forums

support icon Get support

Support Portal
Deployment wiki
Support blog