Page title:Introduction

Closed Captioning text:Jazz source control manages the source code, documents, and other artifacts that a team creates. It provides change-flow management to facilitate sharing, retains a history of changes made, and enables the simultaneous development of multiple versions of shared artifacts, so that teams can work on several development lines at the same time. Jazz source control also integrates with other Rational Team Concert components, such as builds and work items, and with other source control products, such as IBM Rational ClearCase and Subversion.

Page text: You can access Jazz source control from an Eclipse client or Web client. You can also use a command line interface to access essential Jazz source control operations from any command shell.


Page title:Streams, workspaces, and flow targets

Closed Captioning text:A stream is a repository object that includes one or more components. A component is a collection of related artifacts, such as an Eclipse project or a group of documents that comprise Web site content. A local workspace is a directory on your computer’s file system where you can view and modify components. A repository workspace is an object in the repository that stores components as versionable artifacts that you can load into your local workspace. Flow targets specify the source of incoming change sets and destination of outgoing change sets. In a team setting, most workspaces have flow targets. Streams have flow targets only if they are part of a stream hierarchy.

Page text: A team shares work in a stream. You can check in your work to a private repository workspace, which tracks the sets of logically-related changes in change sets. All streams are flow targets of workspaces or other streams.


Page title:Change sets

Closed Captioning text:A change set is a repository object that collects a related group of changes, so that they can be applied to a flow target in a single operation. The change set is the fundamental unit of work in Jazz source control. The contents of a workspace, component, or stream can be expressed as a collection of change sets.

Page text:Change sets are visible in the Pending Changes view. This view lists all of your loaded repository workspaces. A message in the view's message area indicates how many change sets are pending, and what kind they are.


Page title:Revision history

Closed Captioning text:The history of a component comprises an ordered list of change sets, each of which includes one or more items. The history of an item in a change set comprises an ordered list of change sets in which the item appears.

Page text:You can use the History view to list the change set history of a component or file, and the Change Explorer view to see more detail about the changes in a change set.


Page title:Component baselines

Closed Captioning text:A baseline is a repository object that provides a record of the configuration of a component in a workspace or stream. The change history of a component includes baselines, each of which includes exactly one version of every artifact in the component. Baselines are fixed points of reference, useful for reverting a component to an earlier configuration and for initializing streams and workspaces where new development can begin.

Page text:Baselines are numbered automatically when created. If you want, you can also give a baseline a name and a description.


Page title:Conflict resolution

Closed Captioning text:When two or more team members modify the same file or folder, conflicts result. These conflicts must be resolved when one team member accepts the other's changes. Jazz source control detects conflicts and warns you about them before you accept them. It also provides tools and methods for resolving conflicts.

Page text:Jazz source control detects potential conflicts in incoming or outgoing change sets and makes them visible in the Pending Changes view.


Page title:Integrations with work items and builds

Closed Captioning text:Jazz source control integrates closely with other Rational Team Concert components, such as work items and builds. With work items, you can link change sets with activities, such as feature development and defect fixing. With builds, you can specify the repository from which to build. You can also create component load rules, so that only some Jazz source control components are built.

Page text:You can associate source code change sets with work items, so that you can navigate from a work item to code and back. The Jazz Build Engine and Build System Toolkit have built-in support for loading files from Jazz source control and capturing snapshots of build input so that a build can be reproduced exactly.


Page title:Integrations with ClearCase and Subversion

Closed Captioning text:Rational Team Concert includes a connector that supports flexible interoperation between Jazz source control and Rational ClearCase. A synchronization process retrieves changes created in Jazz source control and checks them in to Rational ClearCase as new versions. It also retrieves changes created in Rational ClearCase and delivers them to a Jazz source control stream called a ClearCase Synchronized Stream. When conflicts occur because a file or folder has been modified in both Rational ClearCase and Jazz source control, they appear as incoming change sets for a special repository workspace known as a merge workspace. Rational Team Concert also supports integration with Subversion source control. You can import the contents of a Subversion repository to one or more Jazz source control components. If you install a Subversion client for Eclipse into Rational Team Concert, you can link Subversion revisions to work items.

Page text:After you create a ClearCase Synchronized Stream, you specify files and folders from Rational ClearCase, Jazz source control, or both, to synchronize between the two systems.


Page title:Summary

Closed Captioning text:Jazz source control allows you to store, retrieve and share source code and other artifacts in your Rational Team Concert project. Jazz source control also integrates closely with other Rational Team Concert components, such as builds and work items and supports integration with other products, such as Rational ClearCase and Subversion.

Page text:Jazz source control is closely integrated with the other application development lifecycle tools included in Rational Team Concert.