Troubleshooting a Rational DOORS document generation

If a document does not generate properly, verify that the module path, view name, and baseline are the correct case-sensitive values. If the module, view, and baseline are correct, it is possible that there is a limit on the amount of memory that can be used to run background processes, which is interfering with the document generation.

In both cases, Rational DOORS client memory is being used to open and close the modules in the background. You can configure a registry key so that when a memory limit is reached, the background processes close when they finish reading the current object and only reopen the object again if necessary.

Before you begin

Memory management permissions are not enabled by default. Before completing this task, the com.ibm.rational.rpe.dxl.enable.memory.management flag must be set to true. For more information, see the topics about setting flags for the Document Studio and Launcher applications, the Remote services application on WebSphere® Application Server, or the Remote services application on Apache Tomcat.

About this task

Note: There are situations when completing this task to set the registry key is not appropriate. For example, you might generate a document on a module that has objects in it that link to a large number of objects in other modules. Every time one of those objects are accessed during document generation, the module is opened and closed, which could increase the document generation time rather than decrease it.

Procedure

To configure the MEM_LEVEL_CLOSE registry key:

  1. Open the system registry for your computer. For more information, see the documentation for your operating system.
  2. Locate the Rational DOORS registry. Examples:
    • Rational DOORS 9.4 on a 64-bit Windows registry entry example: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Telelogic\DOORS\9.4\Config
    • Rational DOORS 9.3 on a 32-bit Windows registry entry example: HKEY_LOCAL_MACHINE\SOFTWARE\Telelogic\DOORS\9.3\Config
  3. Create a registry key entry.
  4. For the name of the registry key, enter the name: MEM_LEVEL_CLOSE
  5. For the value, enter a memory limit value in megabytes so that when the specified memory limit is reached, the background processes close when they complete. By default, the memory limit set in the DXL code is 2GB. When selecting a value, choose the maximum memory value that Rational DOORS used to complete other processes. Open your system task manager to see how much memory the doors.exe process is using to help you select an appropriate value.
    Remember:
    • Setting a value too low might cause the DXL execution time to increase.
    • The value that is entered only controls how the background processes are handled by Rational Publishing Engine. The value does not prevent Rational DOORS from consuming more memory than the value that is set.
  6. Click OK to save the changes.

Feedback