IBM Support

Error: cqaxrform.ocx failed to register during ClearQuest installation

Troubleshooting


Problem

This technote describes the error, "cqaxrform.ocx failed to register". This occurs during the installation of IBM® Rational® ClearQuest® on a Microsoft® Windows® operating system.

Symptom

When installing or updating ClearQuest, it is possible for one or more .ocx or .dll files to fail registration. Here is an example of such an error:

Error 1904. Module C:\Program Files\Rational\ClearQuest\cqaxrform.ocx failed to register.  HRESULT 3

Cause

There are multiple causes for this problem:

  • There are existing Rational products on the machine that may be accessing the .ocx files.
  • There may be conflicting versions of the Rational products installed on the machine.
  • The anti-virus program was not disabled during installation.
  • There is a high level of security on the machine that prevents the Installer from registering files.

Resolving The Problem

Assure that all core Rational products installed on the machine are installed as the same base version or release. See technote 1251131 for more details in that regard. Should other Rational products be installed, all related Windows services should be disabled prior to installing or updating. Additionally, if integrated with other Rational products, use Windows Task Manager to make sure there are no CQIntServer processes running before running the installer.


Users should also make sure that the anti-virus is disabled during installation or updating.

In the event that the installer was not allowed to register the file due to high security, try to manually register the file:

  1. Go to the Windows Start button, then select Run
  2. Type in the command:
    regsvr32 C:\Progra~1\Rational\ClearQuest\cqaxrform.ocx
    then click the OK button.
    Note: This command assumes that ClearQuest is installed in the default directory.
  3. You should get a message that the file was successfully registered.
    1. If you get an error such as:

      LoadLibrary ("C:\Progra~1\Rational\ClearQuest\cqaxrform.ocx")
      failed -- Could not find procedure
      or
      LoadLibrary ("C:\Progra~1\Rational\ClearQuest\cqaxrform.ocx")
      failed - The specified module could not be found.

      Then verify that the file exists in the directory specified.
    2. If an older version of the file is conflicting with the needed file, try to unregister the existing file first prior to manually registering. Use the regsvr32 /u /s <File Name> command to perform an unregistering. The /u argument denotes the unregister function, and /s suppresses unneeded messages.
    3. In the event of further problems, make sure that the folder that the file resides in is in the system path.
  4. Once the file is registered, restart the machine and rerun the ClearQuest install program. This time the installation should complete.
  5. If this step does not work, please speak with the system administrator to have the machine's security settings temporarily lowered for installation.


Users can repair the installation via Add/Remove Programs, or reinstall to assure the proper registration after engaging troubleshooting measures.

[{"Product":{"code":"SSSH5A","label":"Rational ClearQuest"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Installation","Platform":[{"code":"PF033","label":"Windows"}],"Version":"2003.06.00;2003.06.12;2003.06.13;2003.06.14;2003.06.15;2003.06.16;7.0;7.0.0.1;7.0.0.2;7.0.0.3;7.0.0.4;7.0.0.5;7.0.0.6;7.0.1;7.0.1.1;7.0.1.2;7.0.1.3;7.0.1.4;7.0.1.5","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSCTQH","label":"Rational Common Components"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Rational Common Installer","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
16 June 2018

UID

swg21208173

Page Feedback