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:
Related Information
Product Synonym
Rational Publishing Engine
Was this topic helpful?
Document Information
Modified date:
01 May 2020
UID
swg21573912