Rename elements

When you use Eclipse to rename a file or folder that is under Rational ClearCase source control, ClearCase checks out the parent directory, renames the file or folder, and checks in the parent directory if the Window > Preferences > Team > Rational ClearCase > When parent directory is automatically checked out to move, rename, or delete an element preference is set to Automatically check in parent directory. If the parent directory is checked out when you perform a rename operation, ClearCase does not check in the directory after you rename the elements.

If you want to rename multiple files or folders in Eclipse that reside in the same directory as a single directory version change, check out the parent directory out of ClearCase, rename the files or folders in Eclipse, and check in the directory.

If you are using UCM, a rename operation always uses the current activity.

Conflicts can arise if a developer working on a shared branch checks in the parent directory but not the corresponding changes. To avoid problems, set the Window > Preferences > Team > ClearCase SCM Adapter > When parent directory is automatically checked out to move, rename, or delete an element preference to Do nothing and verify that all files or folders containing code changes related to the renamed files or folders are checked in to ClearCase, along with the source and destination directories.

If you cancel the checkout (Undo Check Out) on the directory before checking it in, the rename process is also cancelled and file or folder names revert to their previous state. To undo an Eclipse renaming operation in ClearCase, verify that neither the parent directory nor the renamed elements are checked in before canceling the checkout. When you are finished, right-click the parent directory in Eclipse and click Team > Refresh Status.

Related tasks
When parent directory is automatically checked out to move, rename, or delete an element