IBM Support

About adding a component to a UCM project

Question & Answer


Question

What are the overall steps involved in adding a new component to an IBM Rational ClearCase Unified Change Management (UCM) project? This technote provides an outline and direction to the product documentation for adding a new UCM Component to a UCM Project from ClearCase Project Explorer.

Answer


As there are many different ClearCase UCM configurations, this technote is only intended to provide general guidelines for the overall steps involved when adding a new Component to a UCM Project. However, if additional assistance is required, you should first consult the product documentation referenced in this technote, and if needed, contact IBM Rational Client Support.


Required Product Documentation


Adding a Component to a UCM Project


Recommend a Baseline for the new Component


Rebase the Child Stream


Removing a UCM Component




Required Product Documentation

Managing Software Projects
Developing Software with ClearCase


Documentation

Back to top




Adding a Component to a UCM Project

Over the duration of a Project's Lifecycle, it is expected that the scope of your project typically broadens, and you may need to add components.

Note: There is no predefined limit to the number of components that can be added to a single UCM project.

The steps for adding a component to a UCM Project:
  1. Add the component to the integration stream's configuration
  2. (Optionally) Make the component modifiable. By default, the component is added to the project as read-only, which is ideal for shared resources, such as libraries.
  3. Synchronize the integration view with the stream’s new configuration
  4. Recommend a Baseline for the new Component and Rebase the child stream, see below for details
  5. Synchronize child streams with the project’s new set of modifiable components
  6. Synchronize the child stream’s view with the stream’s new configuration
  7. Update the snapshot view load rules to include the component that you added to the stream, if applicable

These instructions are in IBM Rational ClearCase Managing Software Projects under the topic of Adding Components.

Note: The directions for recommending a baseline and rebasing a child stream have been documented below; follow the sequence of steps for this procedure as numbered above.

Back to top




Recommend a Baseline for the new Component

You can recommend a baseline for the new component that is in the current stream or its foundation.

To manage the baseline that the child streams rebase to, it is advised to recommend a baseline. In the case where a new component is added to a project, the recommended baseline will usually be the baseline that was added to the integration stream's foundation. However, if a new baseline is created in this project, after the component is added, then that baseline should be recommended; such as if data is imported into the component after it is added to the project.
  1. From Project Explorer > right-click the integration stream > select Recommend Baselines... and the following dialogue will open:



  2. Click Add > select the Component > select the baseline to Recommend > click OK:



  3. The Recommend Baselines window will update with the new baseline > click OK:



  4. After recommending the new baseline, you can now proceed to Rebase the Child Stream.


The directions for adding a baseline to the list of baselines that are recommended in the project are detailed in IBM Rational ClearCase Managing Software Projects under the topic of Recommending the Baseline.

Back to top




Rebase the Child Stream

Note: These directions are assuming that the rebase will only detect the recommended baseline for the new component. If other changes are included in the rebase, then you may want to use the Advanced button to only select the recommended baseline for the new component.

  1. To rebase a child stream to the new baseline , from Project Explorer > right-click the stream > select Rebase Stream, and the following dialogue will open, click OK:



  2. You will be prompted with an informational dialogue, you can just click OK:



  3. You will be prompted to complete the Rebase, be sure to click Complete:



  4. When the child stream rebases, it will pick up the recommended baseline for the new component, which will update it's configuration. After the rebase is completed, you will then need to continue with the steps as outlined above:
    • Synchronize child streams with the project’s new set of modifiable components
    • Synchronize the child stream’s view with the stream’s new configuration
    • Update the snapshot view load rules to include the component that you added to the stream, if applicable

The directions for rebasing a stream are found in IBM Rational ClearCase Developing Software under the topic of Starting the Rebase Operation.

Back to top




Removing a UCM Component

Back to top

[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"UCM: Component","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF015","label":"IRIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"2003.06.00;2003.06.16;7.0;7.0.1;7.1;7.1.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"UCM: Component","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
16 June 2018

UID

swg21236928

Page Feedback