IBM Support

Displaying the hierarchy of a UCM stream structure

Troubleshooting


Problem

This technote provides guidance for displaying the stream structure in an IBM® Rational® ClearCase® UCM project to see the nested streams under a parent stream, which can be achieved from the GUI in []Project Explorer[], and CLI using []cleartool lsstream -fmt[].

Resolving The Problem

GUI

From within Project Explorer, the stream structure is displayed simply by expanding the project and any subsequent streams you are interested in.

Starting the Project Explorer is detailed in IBM Rational ClearCase Tutorials, and more information for Using the UCM Project Explorer is available from the Help option within the tool.


CLI

While set in a view of the parent stream, you can use the following command to list out peer and child streams.

The stream you start from will dictate what streams that get displayed in the output. This command is used to show same-level and lower-level streams only, and cannot display parent (or higher-level) streams.

By default, this command will show all equal and subordinate streams or you can use the -depth option to set the number of levels to be displayed. The minimum is one level, which will list out peer streams.

Command syntax:


    cleartool lsstream -fmt %[dstreams]p -tree

Example:
    M:\project1_int_vu>cleartool lsstream -fmt %[dstreams]p -tree
    admin_proj1_dev ccrc_proj1_dev admin_proj1_dev2 admin_proj1 admin_project1admin_proj_devstr

To learn more about this command and its available options refer to lsstream (cleartool man lsstream) in IBM Rational ClearCase Command Reference.

[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"UCM: Stream","Platform":[{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"2003.06.16;7.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"UCM: Stream","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
16 June 2018

UID

swg21257829