Creating change sets

A change set is a collection of related modifications to artifacts. You can create change sets to create convenient groupings of changes; for example, a group of changes that resolves a problem. Other team members can load your change set to review your changes before you deliver them.

Before you begin

  • Ensure that you are familiar with project areas, components (if supported), baselines, streams, and change sets (if supported).
  • Ensure that you are familiar with global configurations and personal streams (if your organization uses them).
  • Ensure that you are logged in to a project.
  • Ensure that the current configuration is a stream.
  • You must have permission to create change sets.
  • Understand how your organization uses streams, baselines, and change sets based on how many teams need to work in parallel on different versions of the same artifacts. To learn more, see Patterns for stream usage on Jazz®.net.

About this task

When you change artifacts in the context of a change set, all the changes that you make are grouped into one logical unit. This grouping facilitates the review process and makes it easy to share changes with other teams or team members that use different streams.

If you do not create change sets, each time that you save your changes to an artifact or link in a stream, the application automatically creates and delivers a change set. Then, your changes are available immediately to other team members who share the stream. Even though working this way is simple, it can be harder to identify and deliver specific change sets to other streams. Ask your team lead or configuration lead for guidance about whether to manually create change sets to manage your changes.

Procedure

On the toolbar, click Current Configuration > Create Change Set, and follow the prompts.

Results

The artifacts that you change or create are now grouped in this change set. When you finish changing artifacts, deliver your changes to the stream.
If you are working in a global configuration, the change set is automatically added to your personal stream, and the current configuration is set to your personal stream. You can create or view links to artifacts in other project areas while you work in the change set. After you deliver the change set, it is removed from your personal stream.
Note: Your personal stream can contain only one change set from a component (if supported) or project area (if components aren't supported). Typically, you should have only one change set at a time in your personal stream. To add a different change set to your personal stream, you must manually replace the change set that is already there. See the related topic about working with multiple change sets.

To increase traceability in the development lifecycle and prevent the delivery of unauthorized changes, you can link the change set to a work item.