Renaming a UCM Component

Answer

Components are the UCM mechanism for simplifying the organization of your files and directories.

The directory and file elements of a component reside physically in a VOB, which is referred to as the component's root directory.

Renaming the UCM component does not change the name of its root directory, and this is not required.

Composite baselines are commonly stored in components that do not contain a root directory, but these components can be renamed also.

If you choose, you can also rename the component's root directory, refer to technote 1144219 for directions.

Note: The root directory of a sub-VOB component, which is a component that is created within a VOB, cannot be renamed, refer to technote 1135606 for more details.

CLI:

Renaming the component can be done using the following command:

cleartool rename component:<old_component_name>@\PVOB component:<new_ component_name>@\PVOB


Example:

C:\>cleartool rename component:comp1@\pvob1 component:comp@\pvob1


Renamed component from "comp1" to "comp".

C:\>cleartool rename component:comp1@\pvob1 component:"new comp"@\pvob1
cleartool: Error: Invalid name: "new comp".
cleartool: Error: Unable to rename component from "comp1" to "new comp".

GUI:

The name of the component can be changed from within the graphical interface, ClearCase Project Explorer.

1. Open ClearCase Project Explorer (Exploring ClearCase Projects) from the Rational ClearCase Start menu options, or go to Start > Run > type clearprojexp in the Open field > click OK:
   
   
   
   
2. Right-click the UCM component to be renamed > select Properties:
   
   
   
   Note: Since the root directory of this component is located in a Multiple Component VOB it cannot be renamed, refer to technote 1135606 for more details.
   
   
3. Rename the component by changing the Name field to the desired name > click OK to apply the changes and exit the Properties dialogue:
   
   
   
   Note: the following error will occur if a name is specified that contains a space:
   
   
   
   
4. ClearCase Project Explorer should dynamically update with the change, however, if it does not, then use F5 to refresh the window: