Working with personal streams in the GCM application

A personal stream contains your changes only and is modifiable by only you or an administrator. Use a personal stream to privately test one or more insulated changes before you deliver them to a shared stream. You can create a personal stream from any global stream in the Global Configuration Management (GCM) application.

Before you begin

  • By default, all project area members can create a personal stream and add or remove its configurations.
  • You can archive your personal streams and them restore later if you need them, but you cannot permanently delete them.
  • Personal streams are not strictly private. Team members with a direct URL to your personal stream can view its contents, even without permission to modify others' personal streams or view them in searches and query results.
  • By default, only GCM administrators or those with permission can complete tasks for other team members' personal streams. For details, see Administering personal streams in the GCM application.

Creating personal streams

In the GCM application, you can create a personal stream from any global stream.

About this task

Note: Personal streams can also be created automatically, for example, when you create a change set in the Requirements Management (RM) application. For details, see the Working with RM change sets in personal streams section in this topic.


  1. Open a stream, and in the configuration tree view, complete one of the following steps:
    • Right-click a stream and click Create Personal Stream.
    • On the Attributes tab, beside My Personal Stream, click Click to create.
  2. Optional: Add tags to help you find and organize personal streams.


Your personal stream opens in a new window. You can now add other configurations and change sets to test your changes privately.

Finding personal streams

By default, you see only your personal streams, and only GCM administrators can see all team members' personal streams.


Find personal streams in a project area by using any of these methods:
  • Welcome page: In the Search section, choose Personal Streams and search by name or tags.
  • Browse Components page: Click a component; then, click the Personal Streams tab. If a personal stream doesn't exist, go to the Streams tab, click a stream, and create a personal stream as described in the previous section.
  • Quick Search (near the upper right): Choose Personal Streams and type a name, tag, or asterisk *) to list your personal streams.
  • Create a query: From the Queries menu on the banner, choose a query type, and build your query. For example, you might search for configuration types that are personal streams; you might also search by name or tags.
  • Run a find use report: Select a configuration in the tree view, right-click, and select Find Where Used. Then, select an option from the Personal Streams menu. To show everyone's personal streams, you must be assigned the View team members' personal streams permission.

Working with RM change sets in personal streams

Your personal stream can contain multiple change sets but only one change set from any specific component.

About this task

If you are working in a global configuration context in an ELM application that supports change sets such as RM, and a personal stream doesn't exist, a personal stream is created for you when you create a change set. The change set is added automatically to your personal stream, and the configuration context is set to your personal stream. If you switch the configuration context back to the global stream and create another change set, your personal stream is updated with the new change set. For details about working with multiple change sets, see Working with multiple change sets.

When you add change sets manually to a personal stream, ensure that they are based on a contribution that already exists in the original global stream.


Open a personal stream and work with change sets in these ways:
  • Add: Click Add additional configurations or change sets.
  • Remove: Beside the change set name, click Actions > Remove.
  • Replace: Remove the change set and add a different one.
  • Deliver: Click the change set name. The application it was created in (for example, the RM application) opens. On the banner of that application, click Current Configuration > Deliver Change Set, and follow the prompts.

    After you deliver the change set, it is removed from your personal stream.

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