Creating streams

A stream is a repository object that includes one or more components. Streams are typically used to integrate the work that is done in workspaces. Team members deliver their own changes to the stream and accept changes from other team members into their repository workspaces from the stream.

Before you begin

Before creating a stream, your Jazz® Administrator must create the project area and the team area. After that, you must log on to the repository and connect to the project area.

About this task

Whether you are part of a team, you can create a stream to hold the versions of components that represent an important configuration of a system. A milestone release of a software development project is an example of one such configuration. A stable version of an open source software package is another. When team members deliver change sets from their workspaces to a stream and accept change sets that are delivered to the stream by other team members, the stream represents the current state of the development effort for the entire team. When deliveries to a stream are constrained by process controls (requiring code to be free of compilation errors, or reviewed and approved before delivery), the stream becomes a stable source of shared artifacts. All streams are flow targets of workspaces or other streams. Some streams (such as integration streams) have their own flow targets, which are typically established when the stream is created.

A stream can include a number of components. Any component in the repository can be made part of a stream, though typically the components in a stream have dependencies or functional relationships that make it sensible to group them. After you have created a stream, you can use the Stream editor to add components to it, remove them from it, or change the versions of one or more components in the stream.

To create a stream:


  1. In the Team Artifacts window, browse to your project area and right-click Source Control; then click New Stream.
    Note: You can also create a stream from a repository workspace, snapshot, or build result.
  2. In the Stream editor, in the Repository field, select a repository. If you are not logged on to the repository, click Login.
  3. In the Name field, type a stream name.
  4. In the Owned by field, select a project or team area to own the stream.
  5. Optional: In the Visibility field, select which team has access to the stream.
  6. Optional: In the Description field, type a brief description.
  7. Optional: To add a component, in the Components area, click Add and complete the Add Component wizard.
  8. Optional: To create a component, click New. In the New Component dialog box, type a component name and click OK.
  9. Optional: To change a component owner, complete these steps:
    1. Click Change Owner.
    2. In the Change Component Ownership window, click OK.
    3. In the Select a User or Team Area window, select the new owner.
    4. To restrict component access to the owner's team area, select Restrict to members who can see this team area.
    5. Click OK.
  10. Optional: To load components when you save the stream, select Load component additions on save.
  11. Optional: To add a flow target, in the Flow Targets area, click Add and complete the Select a Stream or Workspace dialog box.
  12. Click Save.