IBM Support

Execution of a hook error, when using ClearQuest 7.0.x Import Tool



This technote identifies an issue that can occur in the IBM Rational ClearQuest Import Tool. Incorrect conversion of line breaks can cause "execution of a hook" errors.


The ClearQuest 7.0.x Import Tool converts the return code <LF> to <CRLF> in multi-line fields. This can result in an "execution of a hook" error, similar to this:

Execution of a hook failed during the action Modify.  It was the ACTION_NOTIFICATION hook attached to the Defect "SAMPL00000001".  The reason for the failure was:
Error processing Email Rule "Modifications" : An error was detected retrieving information from the ClearQuest database.
There is a reference to an object that does not exist:
  Object Type: Field
  Object: "Headline

" of record type "Defect"
This error was detected at: ClearQuest Core:adentity.cpp:685
Recommendation: If you cannot determine how to resolve this issue, contact Rational Support and provide all the above information as well as a description of the context in which the message occurred.

Notice how in this example, the object Headline has a line break.


This issue was identified as a product defect under APAR PM05779. This problem was introduced by the fix to defect APAR PK35251. Particular versions affected by the problem are listed in the "Software version" section of this technote.

Resolving The Problem

This defect is fixed starting in ClearQuest Upgrade to the latest patch to resolve this problem.

The ClearQuest 7.1.x import tool is built in the ClearQuest Eclipse RCP client. It is not affected by this problem. Also, consider upgrading to the latest 7.1.x version to avoid this problem.

[{"Product":{"code":"SSSH5A","label":"Rational ClearQuest"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Import tool","Platform":[{"code":"PF033","label":"Windows"}],"Version":";;;;;;;;;;;","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
16 June 2018