rgy_check: Error: This VOB object is stranded (it has no tags in any region)

Problem(Abstract) This technote explains how to resolve the error rgy_check: Error: This VOB object is stranded (it has no tags in any region) when running the IBM® Rational® ClearCase® utility rgy_check.

Symptom

Running the rgy_check utility returns the following output. rgy_check: Error: This VOB object is stranded (it has no tags in any region): -hostname = "host1" -local_path = "d:\ClearCase_Storage\usr_name_tut\input.vob" -vob_replica = "d8b54141.3b1011d4.9719.00:60:08:cc:c1:65" -vob_family = "d8b54140.3b1011d4.9719.00:60:08:cc:c1:65" Similar errors like the following may be reported if the issue is related to a View: The rgy_check command reports the following error: # /opt/rational/clearcase/etc/rgy_check -views rgy_check: Error: This view object is stranded (it has no tags in any region): -hostname = "host1" -local_path = "/views/dev_debug.vws" -owner = "vobadm" -view_uuid = "b86d5c88.d1cf11db.8fa7.00:01:83:44:97:72" -attributes = "sumview" rgy_check: Error: This view object is stranded (it has no tags in any region): -hostname = "host1" -local_path = "/views/dev.vws" -owner = "vobadm" -view_uuid = "56ad2448.d1c811db.8fa3.00:01:83:44:97:72" -attributes = "sumview" rgy_check: Error: 2 total registry errors/inconsistencies detected. Email notification from the nightly scheduled job, Daily View Space, reports the following error: Job 5 "Daily View Space" (16091) Completed: OK but with messages: "cleartool: Error: Storage directory "/views/dev.vws" does not exist. cleartool: Error: Storage directory "/views/dev_debug.vws" does not exist. Note: Daily View Space is a default job in the ClearCase Schedule.

Cause

The VOB has been removed, but the vob_object (uuid) entry still exists in the ClearCase registry. In the case of a view, it may have been removed improperly , which left a stranded reference to it in the ClearCase registry.

Resolving the problem

Use the cleartool unregister command to manually remove the VOB or View references from the ClearCase Registry. For a VOB: Example: cleartool unregister -vob -uuid d8b54141.3b1011d4.9719.00:60:08:cc:c1:65 For a View: Example: cleartool unregister -view -uuid b86d5c88.d1cf11db.8fa7.00:01:83:44:97:72 Review the IBM Rational ClearCase Command Reference Guide on the topic of rgy_check (cleartool man rgy_check) as well as the topic of unregister (cleartool man unregister) for more information. Also refer to technote 1134700 for more information about Manually removing a VOB or View from the ClearCase registry whose storage has been deleted.