Creating streams in configuration-enabled projects

A stream is modifiable set of versioned artifacts. You can add, edit, and delete versions of artifacts in a stream. All team members who have access to the project area can access its streams.

Before you begin

Ensure that you are familiar with project areas, components (if supported), baselines, streams, and change sets (if supported).
Log in to a project area in an IBM® Engineering Lifecycle Management application.
In configuration-enabled projects, you must have permission to create streams.
For Engineering Test Management application to exclude test results and test execution records when you create streams, set the corresponding configuration management preference. You might exclude them if the test results or test execution records from one project do not matter to another project.
When you create a new stream, the test suite or test case results that are part of an in-progress test suite or test case execution record are archived for the new stream. Complete or cancel the test in the original stream.
Understand how your organization uses streams and baselines that are 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

Multiple streams in a project area can contain a copy of the same artifact. Changing an artifact in your stream does not affect the same version of that artifact in other streams until other team members choose to bring your changes into their stream by using the Accept Incoming Changes operation in DOORS® Next or the Merge Configuration operation in the application.

Procedure

On the toolbar, click the current configuration name, and then click Create Stream.
Follow the prompts.

If your current configuration is a stream, a baseline of the stream is created automatically before creating the new stream. The new baseline has the same name as the new stream, with "Initial Baseline" appended. Then, the new stream is created from that baseline.

Results

The new stream is populated with the artifacts of the baseline that it was created from.

What to do next

DOORS Next application only:
- Child streams inherit the change management constraints set on the Details tab of the stream editor. For details, see Controlling changes by enforcing change sets and links to work items in the DOORS Next application.
- If you do not use change sets, your changes are visible in the stream when you save your changes to the artifacts. Use change sets to group your changes, which isolates your changes from other team members who might use this stream.
Engineering Test Management application only: To receive an email when artifacts are changed in specific streams, on the product banner click User Profile; then, in the My Preferences for Quality Management dialog box, click Change Notifications > Send an email notification and select the streams.

To find and switch to the new stream later, click Current Configuration on the toolbar and click Switch; then, in the search field of the Select the Configuration Context dialog box, enter an asterisk (*) to show all the streams.

If you have permission, you or a configuration lead for the Global Configuration Management application might also add the stream to a global configuration, to provide a view of all the artifacts that are used in a version of your product or system.