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.
When a Rational® DOORS® module
is linked to other modules, Rational Publishing Engine must
open those linked modules in the background as a document generates.
Also, when layout DXL code is used, modules are opened in the background
until the DXL completes.
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.
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:
- Open the system registry for your computer. For more information, see the documentation for your operating
system.
- 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
- Create a registry key entry.
- For the name of the registry key, enter the name: MEM_LEVEL_CLOSE
- 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.
- Click OK to save the changes.