IBM Support

Error: Missing root directory hlink for component

Troubleshooting


Problem

In IBM Rational ClearCase Unified Change Management (UCM) the major link between a project VOB and a component VOB is the Component Root Directory hyperlink. This technote explains the cause of the error, Missing root directory hlink for component, and how to recover from a missing or broken Component Root Directory hyperlink.

Symptom

There are two main types of commands which can receive this error:

1. Commands which access the component object and try to follow the link to the component VOB.

Example:

V:\>cleartool lscomp -long -invob \TestPVOB
"TestComponent"
04-Jun-01.13:51:07 by user1.clearusers@client1
root directory: "\TestComponent"
owner: user1
group: clearusers
"User_test"
04-Jun-01.14:26:09 by user1.clearusers@client1
cleartool: Error: Missing root directory hlink for component "User_test".
"alpha"
04-Jun-01.18:06:39 by user1.clearusers@client1
cleartool: Error: Missing root directory hlink for component "alpha".

You may see this issue when attempting to remove a component where the component VOB is already removed.

2. Commands which access the component VOB and try to follow the link to the component object.

Example:


V:\>cleartool deliver
cleartool: Error: Missing root directory hlink for component "alpha".
cleartool: Error: Unexpected error in deliver.

In this case the component may not be properly identified:

cleartool: Error: Missing root directory hlink for component "???".

[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Component":"UCM: Component","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"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":"LOB77","label":"Automation Platform"}},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Component":"UCM: Component","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB77","label":"Automation Platform"}}]

Log InLog in to view more of this document

This document has the abstract of a technical article that is available to authorized users once you have logged on. Please use Log in button above to access the full document. After log in, if you do not have the right authorization for this document, there will be instructions on what to do next.

Document Information

Modified date:
16 June 2018

UID

swg21134581

Page Feedback