Adding configurations to a stream

Use a stream to group configurations contributed by this and other IBM® Engineering Lifecycle Management (ELM) applications, such as IBM Engineering Workflow Management (EWM), IBM Engineering Test Management (ETM), IBM Engineering Requirements Management DOORS® Next (DOORS Next), and IBM Engineering Systems Design Rhapsody® - Model Manager (RMM).

Before you begin

  • To add configurations to streams, you must be assigned the Configuration Lead or Administrator role or be assigned the Modify stream attributes + replace configurations + change hierarches permission. For details about this permission, see Role-based permissions for Global Configuration Management (GCM).
  • By default, team members can add or remove configurations only in their own personal streams. Only administrators or team members with permission can modify other team members' personal streams.

About this task

An empty initial stream is created automatically after a component is created. You can add configurations to the stream from this and other contributing ELM applications. Configurations that you add to the stream from this and other ELM applications can be streams, change sets, snapshots, baselines, and global configurations. If you need to create a component, see Creating a component to establish a work context.

Recall that a stream is modifiable while a baseline is frozen. In the Global Configuration Management (GCM) application, streams, change sets, snapshots, baselines, and global configurations are all called configurations when the state of the asset does not matter. When the state does matter, then the GCM application and documents use the more specific terms.

After adding configurations from this and other ELM applications to global configurations in the GCM application, you see a larger context. Rather than seeing just the configurations you are working with in a contributing ELM application, such as requirements configurations, the tree view also shows you test configurations, design configurations, and other global configurations organized in a hierarchy. Your tree view might look similar to the following image:

Example of configurations in tree view

Global configurations show configuration hierarchies only, not the artifacts that reside within each contributing application's configurations. If you want to view the artifacts, such as artifacts in a test stream, you can do so in the contributing Quality Management (QM) application.

Adding contributions from other GCM instances

Sometimes, you need to build configuration hierarchies that include external contributions, which are configurations from GCM instances on other Jazz™ Team Server instances. A GCM administrator must enable GCM servers to contribute configurations to other GCM servers.

You can add only one external contribution from any GCM instance. To add more than one external contribution from a GCM instance, you must group configurations in that instance, and then add the group configuration to the hierarchy on the home GCM server, as shown in the following example.

Conventions in the following image:
  • Green boxes represent global configurations on the home GCM server.
  • Yellow boxes represent external contributions from another GCM instance.
Image showing a grouping configuration that contributes to a configuration on the home server, and also two examples that are not valid

On the home GCM server, you can add only one global contribution from any GCM instance. Suppose you need to add GC B1 and GC B2 to the GC A1 configuration. As shown in the example, with the check mark, because you can add only one contribution from another GCM instance, you must create a group configuration (GC B3) that contains the GC B1 and GC B2 configurations, and then add GC B3 to GC A1 on the home server.

You can't add multiple contributions from the same instance to a configuration on the home server, as shown in the second and third examples.

To create a group configuration like the one shown in the example with the check mark, complete these steps:
  1. In the GCM instance that contains GC B1 and GC B2, create global configuration GC B3 and add the other two configurations to it.
  2. On the home server of the GC A1 configuration hierarchy:
    1. Remove any external contributions from the server that contains the GC Bx configurations.
    2. Add the GC B3 configuration you created. In the configuration picker, external contributions are decorated with a cloud icon superimposed on a global configuration icon, as in this example: External contribution icon shows a cloud superimposed on a global stream icon.

You can add the group configuration to a configuration hierarchy on another GCM server that a GCM administrator has configured to allow external contributions. If you don't see the project area from the other GCM instance in the configuration picker, contact your GCM administrator.

To add configurations to a stream, complete the steps in the Procedure.


  1. In the configuration hierarchy, select the global stream to add configurations to, and then click Add Configurations.
  2. Add as many configurations as you need to the stream.
    1. From the menu, select a ELM application.
    2. From the Project Area menu, select the project area to search.
      If you select the GCM application in step 2.a:
      • After you select a project area, you can use a query to find global configurations: click the menu beside the search field and choose a query type.
      • If you belong to multiple GCM projects, you can select All project areas to search for global configurations across project areas that you have access to. See the menu options.
    3. QM and RM applications only: From the Component menu, select the component that contains the configuration to add.
    4. Choose the configurations from the list and click OK, or drag them into position in the tree view.
      • Change sets can be added only to personal streams.
      • Filter results by entering a tag or configuration name in the search field.
      • RM and QM applications: You can drag configurations from the pages in the Manage Components and Configurations section in one browser window into position in the tree view in another browser window.
      • DM application: You can drag configurations from the Manage Configurations page in one browser window into position in the tree view in another window.


Now that you have added configurations from this and other ELM applications to your stream, the configurations are part of a larger context. Teams refer to this larger context as a high-level configuration, a grouping configuration, or a global configuration. All of the names mean the same thing: a configuration that groups related configurations that were contributed by this and other ELM applications.

What to do next

You can move, rename, replace, remove, or reorder configurations. See Managing configurations.

video icon Video channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community forums library

support icon Support

IBM Support Community
Deployment wiki