IBM Support

Using Microsoft Desktop Heap Monitor (dheapmon) to determine desktop heap space and troubleshoot FileNet P8 and Image Services (IS) issues

Question & Answer


Question

How do I use dheapmon to determine desktop heap space and troubleshoot FileNet P8 and Image Services (IS) issues?

Cause

On busy systems, it is possible to exhaust the Windows desktop heap space reserved for non-interactive sessions. The dheapmon tool is used to determine the desktop heap usage. Ideally, this tool should be scripted, and the output captured throughout the day during peak processing periods.

Answer

The desktop heap size is set in the Registry under HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Session Manager\SubSystems in the Windows key SharedSection parameter. For example:

Under the HKEY_LOCAL_MACHINE subtree, find the subkey:

\System\CurrentControlSet\Control\Session Manager\SubSystems

In the Windows key the default data for this value will look similar to the following (all on one line):

%SystemRoot%\system32\csrss.exe ObjectDirectory=\Windows SharedSection=1024,3072,2048 Windows=On SubSystemType=Windows ServerDll=basesrv,1 ServerDll=winsrv:UserServerDllInitialization,3 ServerDll=winsrv:ConServerDllInitialization,2 ProfileControl=Off MaxRequestThreads=16

In “SharedSection=1024,3072,2048” the second value (3072) represents the heap size for desktops associated with interactive Windows stations. The third value (2048) represents the desktop heap for desktops associated with non-interactive Windows stations.

NOTE: It is recommended that the desktop heap for non-interactive sessions be set to 2048.

The dheapmon tool can be downloaded from the Microsoft website.

Sample usage: The output from the dheapmon tool reports the percentage of desktop heap used by each session.

Desktop Heap Information Monitor Tool (Version 7.0.2727.0)
Copyright (c) 2003-2004 Microsoft Corp.
-------------------------------------------------------------
Session ID: 0 Total Desktop: ( 15488 KB - 8 desktops)

WinStation\Desktop Heap Size(KB) Used Rate(%)
-------------------------------------------------------------
WinSta0\Default 3072 6.6
WinSta0\Winlogon 128 3.9
Service-0x0-3e7$\Default 2048 4.1
Service-0x0-db39$\Default 2048 14.8
SAWinSta\SADesktop 2048 0.1
TelnetSrvWinSta\TelnetSrvDesktop 2048 0.1
Service-0x0-b0168$\Default 2048 0.7
Service-0x0-b10d4$\Default 2048 0.4


Data to collect: The output generated by dheapmon.

For more information: Reference Microsoft Article 184802

[{"Product":{"code":"SSNW2F","label":"FileNet P8 Platform"},"Business Unit":{"code":"BU053","label":"Cloud \u0026 Data Platform"},"Component":"Content Engine","Platform":[{"code":"PF033","label":"Windows"}],"Version":"3.5.2;3.5.1;3.5","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSNW2F","label":"FileNet P8 Platform"},"Business Unit":{"code":"BU053","label":"Cloud \u0026 Data Platform"},"Component":"Process Engine","Platform":[{"code":"PF033","label":"Windows"}],"Version":"3.5","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSRA77","label":"FileNet Rendition Engine"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":" ","Platform":[{"code":"PF033","label":"Windows"}],"Version":"3.5;3.5.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSNVUD","label":"FileNet Image Services"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":" ","Platform":[{"code":"PF033","label":"Windows"}],"Version":"4.1;4.0;3.6.10;3.6;3.5","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSNVNV","label":"FileNet Content Manager"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":" ","Platform":[{"code":"PF033","label":"Windows"}],"Version":"4.1;4.0;3.6;3.5.1;3.5","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
23 March 2023

UID

swg21397660

Page Feedback