IBM Support

Unable to lock or unlock versioned object base



This technote explains why an IBM® Rational® ClearCase® VOB that has been moved from one server to another has problems being locked or unlocked on Microsoft® Windows®, UNIX® or Linux®.


After moving a VOB to a new server, attempts to unlock the VOB result in the following error message:

%>cleartool unlock vob:\Test
cleartool: Error: Unable to find replica in registry for VOB with object ID:"784756ff.a1034a36.91b9.8a:36:35:a8:de:0b"
cleartool: Error: Unable to locate versioned object base with object id: "784756ff.a1034a36.91b9.8a:36:35:a8:de:0b".
cleartool: Error: Unable to search for process guards
cleartool: Error: Unable to unlock versioned object base "\Test".

An attempt to lock the VOB would result in the same error as above, except the last line would appear as follows:

cleartool: Error: Unable to lock versioned object base "\Test".

Note: The VOB can be a base ClearCase VOB or AdminVOB or a UCM Component VOB or UCM PVOB.


The VOB that was moved has an AdminVOB hyperlink.

The Admin VOB is not or not yet available in the new environment.

The command cleartool checkvob -hlinks can confirm this:

%>cleartool checkvob -hlinks vob:\Test
Unable to determine if the following hyperlink is intact.
AdminVOB@42@\Test  vob:\Test -> <object not available>

Note: Even if the AdminVOB Hyperlink is no longer needed, it is impossible to remove it as the VOB is locked.


Delete it?  [no] y
cleartool: Error: Lock on VOB database "\Test" prevents all write operations.
cleartool: Error: Unable to remove hyperlink "AdminVOB@42@\Test  vob:\Test -> <object not available>".

Note: In most case, this issue arises due to a broken AdminVOB Hyperlink, however this can also occur due to other missing hyperlinks between VOBs, such as a relocation hyperlink.

Resolving The Problem

Here are 3 suggestions that to help resolve this problem:

  1. If the AdminVOB still exists, move it into the new environment, register and tag it. You will be able to unlock your VOB.

  2. Run the checkvob command (cleartool checkvob -hlinks) in the original environment, remove the hyperlink and then move the VOB.

  3. Attempt to unlock the VOB in a command shell, where the following environment variables are set:


    Note: You must be logged in as root (UNIX/Linux) or member of the ClearCase Administrator group (Windows) to be allowed to run this operation.

If for some reasons, option 3 is the only possible option for you and it is failing, contact IBM Rational Client Support.

[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Backup and Restore","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF015","label":"IRIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"2002.05.00;2003.06.00;7.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
16 June 2018