IBM Support

Removing change set versions of a UCM activity from the GUI

Question & Answer


Question

This technote illustrates how to use the IBM® Rational® ClearCase® Version Tree to remove change set versions from the Properties dialog of a UCM activity.

Answer

Important Considerations

The following procedure is used to remove checked in versions from the change set of a UCM activity.

Note: For any checked out version listed in the change set, cancel the checkout and the version will no longer appear in the change set list. Refer to technote 1146869 for directions.

Removing checked in versions should be done with discretion and under conditions that warrant such action. Instances where a deliver or rebase fails leaving checked in versions which are preventing the operation from being canceled, as detailed in technote 1125189 and technote 1179696.

When removing versions as a result of a failed rebase, then the checked in versions will be listed on the development stream, and vice-versa when removing versions as the result of a failed deliver operation (the checked in versions will be listed on the target stream).

This is important because this procedure requires that the checked in versions be removed from within the ClearCase Version Tree. You need to know specifically what stream the change set versions are on to be sure and remove the correct ones.

Note: Merge arrows are removed from the source to the target version that was created as a result of a deliver or rebase operation; hence, there are no dangling hyperlinks left to cleanup.

File versions should be removed before removing the versions of directory elements. This will help avoid stranding any elements and causing them to get put into the lost+found; refer to technote 1120317 for more details.

IMPORTANT: The eye graphic in the Version Tree should not be relied on when using this procedure, as it may or may not be selecting the version that needs to be removed. The eye points to the version that is selected by your view's config spec, which may not be the version you need to remove.


Removing Checked In Versions

  1. Open ClearCase Explorer > select the UCM view and click My Activities:



  2. Right-click the activity > select Properties > select the Change Set tab:



  3. Right-click the first file element listed (and note the version listed to its right as this is the version that will need to be removed) > select Version Tree:

    Note: If there are multiple versions listed for a file element, as seen in the above screen capture, then you will need to remove each of them. The order in which they are removed is insignificant, you can remove version 1 first or last.




  4. Right-click the version that was listed in the change set > select Delete > review the details in the Delete Confirmation window > click Yes to proceed:



  5. The Version Tree should update dynamically with the change, if not, then click F5 to refresh the window, and the version will be gone:



    Note: The Delete must be repeated to remove all versions for this file element from the change set.

  6. The change set pane will not update dynamically and cannot be refreshed using F5, you must close the Properties window and reopen it to see that the version has been removed from the change set:




  7. Repeat the steps as needed to remove all file element versions from the change of the UCM activity.

  8. After removing all versions, the activity can be removed from Project Explorer > select the stream > highlight the activity in the left-hand pane > go to File > Delete (or click the Delete key) > click Yes to Proceed:



    Note: An error will occur, if either of the following are true:
    • The activity is not empty:



    • The activity is still set in a UCM view:




[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"UCM: Activity","Platform":[{"code":"PF033","label":"Windows"}],"Version":"2002.05.00;2003.06.00;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: Activity","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"GUI: Version Tree","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"GUI: Version Tree","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
16 June 2018

UID

swg21146901