IBM Support

Remove and recreate UCM baselines

Technote (FAQ)


How do you undo (remove and recreate) an IBM® Rational® ClearCase® UCM baseline that may have been created inadvertently or if it is found to be unstable after testing?


To undo a baseline, the baseline must be removed and then a new one can be created.

Here are some considerations before proceeding:

  1. The baseline cannot have already been modified in any UCM stream of any project, or removing the baseline will fail. You will not be able to remove the baseline, but rather, you will need to make any necessary changes to correct the baseline, then make a new baseline, recommend it, and rebase all streams.

  2. If the component is read-only in the project, but there is an error that changes have already been made in the stream, then refer to technote 1150870 to address that error.

  3. An error will occur if the baseline has been rebased to any development or child streams. To remove the baseline from the foundation of a UCM stream, using cleartool rebase -dbaseline baseline@\ProjectVOB. This must be run against each stream reported in the error to remove the baseline from the foundation of the stream.

  4. If this is a recommended baseline, then you should first remove it from the recommended list:
    • Reset the recommended baseline list by specifying all the baselines, except the one you are going to remove:

      cleartool chstream -recommended BL1@\ProjectVOB,BL2@\ProjectVOB


    • Clear all the recommended baselines that are currently set for the stream:

      cleartool chstream -nc -nrecommended stream:stream-name@\ProjectVOB

    Note: If you are seeing errors because you have removed a recommended baseline refer to technote 1226431.

    Removing the UCM Baseline:

    The baseline can only be removed from the command line interface (CLI), see the below example:

    1. Find the baseline, cleartool lsbl -component component_name@\ProjectVOB

      C:\>cleartool lsbl -component chowchow@\BigDog
      08-Jan-03.13:42:31  Cust_Test_01_08_03  UserName   "Cust_Test_01_08_03"
      stream: Cust_Test_Integration@\BigDog
      component: chowchow@\BigDog

    2. Remove the baseline, cleartool rmbl baseline_name\@ProjectVOB
      Note: After removing the baseline, all the activities that were in this baseline will be available to be added in a new baseline.

      C:\>cleartool rmbl Cust_Test_01_08_03@\BigDog
      Remove baseline "Cust_Test_01_08_03@\BigDog"?  [no] y
      cleartool: Warning: Searching PVOB "\BigDog" for baselines that depend
      upon baseline "Cust_Test_01_08_03".  This may take a few minutes...

      Removed baseline "Cust_Test_01_08_03@\BigDog".

    3. Make a new baseline,

      CLI: cleartool mkbl -view integration_view activity_name

      C:\>cleartool mkbl -view UserName_Cust_Test_integration Cust_Test_01_08_03
      No changes in component "removecomp" since last baseline;
      no baseline created.
      No changes in component "disappear" since last baseline;
      no baseline created.
      No changes in component "smalltalk" since last baseline;
      no baseline created.
      Created baseline "Cust_Test_01_08_03" in component "chowchow".
      Begin incrementally labeling baseline "Cust_Test_01_08_03".
      Done incrementally labeling baseline "Cust_Test_01_08_03".

      Note: By default this will pick up all the activities to be baselined. There are additional options for use with the cleartool mkbl command, see the IBM Rational ClearCase Command Reference, or run cleartool man mkbl.

      From the graphical user interface (GUI):
      1. Start Project Explorer
      2. Right-click the integration stream
      3. Select Make Baseline.

        Note: There is a Help button on the Make Baseline applet for additional information.

Related information

About checkout disallowed for element
Removing objects in UCM environments

Cross reference information
Segment Product Component Platform Version Edition
Software Development Rational ClearCase Documentation
Software Development Rational ClearCase UCM: Baseline

Document information

More support for: Rational ClearCase
UCM: Baseline

Software version: 7.0

Operating system(s): AIX, HP-UX, IRIX, Linux, Solaris, Windows

Reference #: 1147318

Modified date: 19 July 2010