IBM Support

About eclipsed files and ClearCase

Technote (FAQ)


What is an eclipsed IBM Rational ClearCase object and how can it be resolved?


The definition of a ClearCase eclipse:
A VOB object that is not visible because another object with the same name is currently selected by the view.

Eclipsed elements
The objects that become eclipsed most frequently are elements. An eclipsed element is created when it is obscured by a view-private file.

An eclipsed file will be listed in a GUI window with a partially shadowed moon icon as in the example below:

This event may occur when the dynamic view is not able to delete the local copy of the file after you have checked it in.

Note that another view will not have the eclipse, because the view-private file will not be there.

Certain applications will create a temporary file within the view, thus creating the eclipsed file situation. In the case described here, a third-party tool is locking the local file and preventing ClearCase from deleting it during check-in.

Note: Shutting down the application prior to performing the initial copy operation will avoid the eclipse problem. On Windows hosts you may be able to determine the application using a third party tool, such as Process Monitor, which can be downloaded from


The following example illustrates how an eclipsed file is created:

  1. In a dynamic view create a view private file (test.txt)

  2. In another dynamic view with the same config spec create a view private file with the same name as the first view (test.txt).

  3. In one of the views, add the view private file to source control.

  4. The other view will now display the file (test.txt) as eclipsed.


The solution for resolving eclipsed objects is to rename or remove the local / view-private copy of the object that is obscuring the VOB copy.

In the scenario where a third party application is holding a lock on the local copy, you will need to shut down the application in question to release the lock and then refresh the view. The local copy should be removed at that point; however, if for some reason the element is still eclipsed, you should then be able to rename the local copy to resolve the problem.


The 'cleartool ls' command can assist in finding eclipsed files; it will show "[eclipsed]" by eclipsed versions. For example:

Microsoft Windows:

cleartool ls -r | find "eclipsed"

M:\def1\dmm>cleartool ls -r |find "eclipsed"
.\make-class\makefile.dist@@ [eclipsed]
.\make-class\special.o@@ [eclipsed]

UNIX and Linux:

cleartool ls -r | grep eclipsed

Related information

Definition of branch type in AdminVOB would be eclipsed
A Korean translation is available

Document information

More support for: Rational ClearCase

Software version: 7.0, 7.1, 7.1.2, 8.0, 8.0.1

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

Reference #: 1132484

Modified date: 18 February 2010

Translate this page: