IBM Support

The entity's Named Hook "UCM_CkBeforeDeliver" failed

Troubleshooting


Problem

This technote explains why attempts to post an IBM® Rational® ClearCase® UCM deliver from a Rational ClearQuest® enabled project that is replicated using MultiSite® results in the error []The entity's Named Hook "UCM_CkBeforeDeliver" failed[] and provides instructions to resolve the issue.

Symptom

When posting a UCM deliver from a ClearQuest enabled project that is replicated, the following error occurs:


Error posting a delivery for this stream.

Unexpected error in deliver.

IDispatch error #14090
The entity's Named Hook "UCM_CkBeforeDeliver" failed, the error message is:

There is no result from this process.

Invoking "Check Before ClearCase Delivery" policy for UCMUtilityActivity "ACTIVITYNAME" encountered an error.
Unable to begin delivery, ClearQuest error. Unexpected error in deliver.
Unable to perform ClearQuest policy check.
Unable to do integration.

Cause

By default the UCM_CkBeforeDeliver hook (part of the ClearQuest database schema) is executing a script which for a result, is returning an empty string. The script is a place holder for any custom script that has to be executed before delivery.

In case of an error, it is possible that the script cannot be executed, or the empty value is not recognized by the operating system as being valid.

Resolving The Problem

If the default script has not been replaced by a custom script, at the mastering site, use the Rational ClearCase Project Explorer to open the project properties and disable the policy Perform ClearQuest Action Before Delivery.

Send synchronization packets from ClearCase and ClearQuest to the remote site and try to post the delivery again.

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

Document Information

Modified date:
16 June 2018

UID

swg21202162