IBM Support

Configuring Rational DOORS to find Rational Publishing Engine DXL

Troubleshooting


Problem

Attempts to use IBM Rational Publishing Engine in Rational DOORS results in DXL error "could not open include file".

Symptom

To use IBM Rational Publishing Engine (RPE) within DOORS, DOORS needs to be able to find the RPE DXL scripts. DOORS is configured automatically for this when RPE is installed, but certain configuration changes may override these default settings.

Attempt to use RPE in DOORS results in DXL errors:

-E- DXL: <C:\Program Files (x86)\IBM\Rational\Publishing Engine\1.1.1.2\source\DOORS\dxl\doors driver\getDOORSVersion.dxl:3>
could not open include file (source/DOORS/dxl/doorsdriver/getDOORSVersion.inc)
(No such file or directory)

-E- DXL: <C:\Program Files (x86)\IBM\Rational\Publishing Engine\1.1.1.2\source\DOORS\dxl\doors driver\doorsToXml.dxl:3>
could not open include file (source/DOORS/dxl/doors driver/fileutils.inc) (No such file or directory)

Cause

IBM Rational DOORS is not configured to find the Rational Publishing Engine DXL scripts. In addition, this can happen in later versions of DOORS if DXL Security is enabled.

Environment

This is common when IBM Rational DOORS is configured to access custom DXL scripts, either via the registry or via the -addins switch in the DOORS startup shortcut.

Diagnosing The Problem

Inspect your Microsoft Windows Registry and look for a registry key similar to:

  • 64-bit Windows:
    HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Telelogic\DOORS\9.3\Config\Addins
  • 32-bit Windows:
    HKEY_LOCAL_MACHINE\SOFTWARE\Telelogic\DOORS\9.3\Config\Addins

Also check for Addins registry keys in the HKEY_CURRENT_USER equivalent of the above paths -- on 64-bit systems, check both paths.

If IBM Rational DOORS DXL Security is enabled, make sure it is configured so that Rational Publishing Engine users can run DXL scripts.

Resolving The Problem

If you are using the Microsoft Windows Registry to set the IBM Rational DOORS Addins value, all the custom DXL paths, including the RPE DXL path, need to be specified in the HKEY_LOCAL_MACHINE Addins registry key. Do not specify custom DXL paths in the HKEY_CURRENT_USER Addins registry key, as that will override any existing HKEY_LOCAL_MACHINE Addins registry key.

If you are using the -addins (-a) switch to configure Addins, ensure that any existing paths from the HKEY_LOCAL_MACHINE Addins registry key are also included in the -addins switch.

You can specify multiple paths by separating them with a semi-colon (no extra spaces after the semi-colon). If using the -a switch, use double quotes around all the paths, if any of the paths have spaces in their names. For more details on Addins configuration and syntax, please refer to Tech Note #1421641.

If DXL Security is enabled, please make sure it is configured so that Rational Publishing Engine users can run DXL scripts. If you do not need DXL Security, you can also disable it. For more details about DXL Security, please refer to the "Setting up DXL security" topic in the DOORS documentation:

[{"Product":{"code":"SSUBFB","label":"IBM Engineering Lifecycle Optimization - Publishing"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"General Information","Platform":[{"code":"PF033","label":"Windows"}],"Version":"1.1.1;1.1.1.1;1.1.1.2;1.1.2;1.1.2.1;1.1.2.2;1.2;1.2.0.1;1.2.1;1.2.1.1","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}},{"Product":{"code":"SSKR2T","label":"IBM Engineering Requirements Management DOORS"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Integrations: IBM","Platform":[{"code":"PF033","label":"Windows"}],"Version":"9.3;9.3.0.1;9.3.0.2;9.3.0.3;9.3.0.4;9.3.0.5;9.3.0.6;9.3.0.7;9.3.0.8;9.4;9.4.0.1;9.4.0.2;9.5;9.5.0.1;9.5.0.2;9.5.1;9.5.1.1;9.5.1.2;9.5.1.3;9.5.2;9.5.2.1;9.5.2.2;9.6;9.6.0.1","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Product Synonym

Rational Publishing Engine

Document Information

Modified date:
01 May 2020

UID

swg21573912

Page Feedback