rgy_check: Error: Two View objects have the same pathname on a server

Problem(Abstract)
This technote explains why the error rgy_check: Error: Two View objects have the same pathname on a server occurs when using the IBM® Rational® ClearCase® rgy_check command on Microsoft® Windows®, Linux® and UNIX®.
Symptom

Running rgy_check -views is reporting the following error:

rgy_check: Error: Two View objects have the same pathname on a server.
First object:
-hostname = "integ"
-local_path = "/user/integ/.views/cspatch.vws"
-view_uuid = "0f12a312.75e511d0.a6a1.00:01:55:42:fc:96"
This object:
-hostname = "integ"
-local_path = "/user/integ/.views/cspatch.vws"
-view_uuid = "4422a476.75e511d0.a6a2.00:01:55:42:fc:96"


rgy_check: Error: A view tag duplicates another view's global pathname in region smnos.

Similar errors may be reported if you are running rgy_check with the -vobs option.


Cause

The error message indicates that two view tags are assigned to the same view's physical storage directory which is illegal in ClearCase. Only one view tag can be given for a view's physical storage directory within a single region.

First tag:
-tag = "CS_PATH"
-hostname = "integ"
-global_path = "/usrx/sv1/integ/.views/cspatch.vws"
-region = "smnos"
-view_uuid = "0f12a312.75e511d0.a6a1.00:01:55:42:fc:96"

Second tag:
-tag = "cspatch"
-hostname = "integ"
-global_path = "/usrx/sv1/integ/.views/cspatch.vws"
-region = "smnos"
-view_uuid = "4422a476.75e511d0.a6a2.00:01:55:42:fc:96"

How did this happen?

This usually happens when there is a process hanging around for a particular view which wasn't removed the proper way. When the user then issues a cleartool mkview command with the same name as the view that was improperly removed, a second view tag entry with a different uuid in the same region is inadvertently created.


Resolving the problem

In order to resolve the errors you need to unregister the view and remove the extra view tag.

  1. Issue a cleartool unregister -view -uuid passing the uuid of the view.

    Example:
    cleartool unregister -view -uuid 4422a476.75e511d0.a6a2.00:01:55:42:fc:96

  2. Remove the additional view tag:

    Example:

    cleartool rmtag -view cspatch

Review IBM Rational ClearCase Command Reference on the topics of unregister or rmtag (cleartool man unregister or rmtag) for more information.


No comments:

Post a Comment