IBM Support

About removing elements in UCM

Question & Answer


Question

Where is there information documented that explains why removing elements in an IBM® Rational® ClearCase® UCM environment using the cleartool rmelem command is not recommended? The preferred method is using cleartool rmname.

Answer

In a UCM environment, it is strongly recommended to use rmname instead of rmelem when it comes to removing elements.

The two main reasons against using rmelem are:

  1. There are currently no supported methods to recover an element in a UCM environment after the element has been removed using cleartool rmelem due to the restrictions on UCM and commands such as clearexport_ccase and relocate.

    Note: Restoring an individual element from backup after the object has be removed using rmelem in UCM is possible; however, you would need to restore the entire VOB to recover the removed element along with restoring the PVOB, all related components to that PVOB up to and including any Rational ClearQuest databases used with Projects.

    The only way to reintroduce a backup of the element into UCM is to add the file to source control and re-create the version tree.

  2. After using rmelem to remove a file, hyperlinks which exist between versions of that element and activities may still exist especially in a replicated PVOB. This could cause future deliver/rebase operation to fail.

    Note: For Microsoft® Windows® users, the ClearCase Explorer GUI performs an rmname operation when you use the DELETE key to delete a file. There is currently no way to perform and rmelem in the GUI.

Restoring an rmnamed Element

An element that has been rmnamed can be restored, refer to technote 1149206 for directions to Restore an element that has been rmnamed.

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

Document Information

Modified date:
16 June 2018

UID

swg21119222