Using the Microsoft adplus to capture a Windows process dump to troubleshoot FileNet P8 and Image Services (IS) issues

Technote (FAQ)


Question

How do I use adplus to capture a Windows process dump to troubleshoot FileNet P8 and Image Services (IS) issues?

Cause

Often Engineering requests a process dump of a process that is hung or appears to be hung, or a crash dump when the software fails. On a Windows server you can capture such a dump using the adplus tool that is included in the “Debugging Tools for Windows” package from Microsoft.

Answer

Install the adplus tool as described on the Microsoft “Debugging Tools for Windows” download website.

To use adplus, you must run it from the folder where adplus is located, include the adplus path name in your PATH, or specify the full path name when running the tool.

To capture a dump of a hung process: Once the hung process has been identified, collect the process dump by entering one of the following types of commands:

cscript adplus.vbs -hang -pn <process_name>.exe -o <output_directory>

In this example, the –pn option is used to indicate the name of the hung process. For example, to dump the “VWJs.exe” processes:

cscript adplus.vbs -hang -pn VWJs.exe -o c:\temp\VWJS_dump.txt

Alternatively, the PID (process ID number) can be used:

cscript adplus.vbs -hang –p <PID#> -o <output_directory>

For example, if the hung PID is 6144, enter:

cscript adplus.vbs -hang -p 6144 -o c:\temp\\dump_6144.out

If time permits, repeat these commands two or three more times, specifying a different output directory for each run. The additional collections will show if the process is truly hung or just processing very slowly.

To capture a dump on a crash condition: If a specific process is crashing, the following commands can be used to force a dump at the time of failure. The adplus command must be executed prior to the failure, so that the crash will automatically trigger the dump. For example:

cscript adplus -quiet -crash -pn <process_name>.exe -nodumponfirst -ctcf -o <output_directory> -y c:\winnt\symbols

The above command allows First Chance Exceptions to be logged without forcing a dump.

However, the following command will force a dump on any exception:

cscript adplus -crash -pn <process_name>.exe -ctcf -o <output_directory> -y c:\winnt\symbols

Data to collect: All files in the output directory specified on the adplus command. Include a description of how the dump was captured and any known circumstances leading up to the issue. Also provide the Application and System Event Logs, and document the time at which the issue occurred.

For more information: See the Microsoft website.


Cross Reference information
Segment Product Component Platform Version Edition
Enterprise Content Management FileNet P8 Platform Application Engine Windows 3.5
Enterprise Content Management FileNet P8 Platform Process Engine Windows 3.5
Enterprise Content Management FileNet Image Services Windows 4.1.2, 4.1.1, 4.1, 4.0, 3.6.10, 3.6, 3.5
Enterprise Content Management FileNet Content Federation Services Windows 4.1, 4.0, 3.6, 3.5.1, 3.5

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

FileNet P8 Platform
Content Engine

Software version:

3.5, 3.5.1, 3.5.2

Operating system(s):

Windows

Reference #:

1394543

Modified date:

2011-04-09

Translate my page

Machine Translation

Content navigation