When properly deployed, ADPlus will provide at least the 2 following valuable

pieces of diagnostic information:

A readable text file or log that shows the thread(s) context, or stack trace(s)
A memory dump file ( .DMP ) that is a complete copy of the entire memory of the
time of the failure. This dump file can be loaded into a debugger and analyzed for
more detailed, context-specific information by Escalation engineers in BMC Support.

A. Debugging Tools Installation

ADPlus is a utility included in Microsoft�s �Debugging Tools for Windows�. This
suite of tools, along with on-line documentation and terminology can be downloaded
and installed from

http://www.microsoft.com/whdc/devtools/debugging/default.mspx.

For detailed information on ADPlus operation, see:

http://support.microsoft.com/support/kb/articles/q286/3/50.asp

If you require more detailed information on ADPlus and debugging methodology,

please request just the Debugging Help file �debugger.chm� with is part of the
Debugging Tools install set.

The default installation location is �C:\Program Files\Debugging Tools for Windows�

Once the files are installed on your target server, run the following command in a
Command Prompt window to see ADPlus� command options and setup CSCRIPT.EXE as your
command line Visual Basic interpreter

cd C:\Program Files\Debugging Tools for Windows

cscript adplus.vbs
Note: cscript.exe is located at �C:\windows\system32\cscript.exe�

If ADPlus version and usage information does not appear, please stop here and
contact Technical Support for assistance.

Additionally, create a directory on the host server to use for files generated by
ADPlus. These files can become quite large depending on your crash or hang
frequency, so chose a file system with plenty of space ( several gigabytes
available). BMC Tech Support recommends creating a directory like:

C:\ADPlus

B. Debuggable aie.exe and Associated DLL�s

In most hanging or crashing cases, tech support will provide for you and request
you replace your standard AIE install binaries with their equivalent debuggable
counterparts. These �debuggable� builds contain symbols which make the ADPlus log
creation, and DUMP file reading easier.

AIE.exe requires several dynamically linked libraries (DLL�s) in order to operate.

Stop your AIE services (All the instances need to be stopped).

Deactivate all AIE Data Exchanges that are not needed to replicate this issue.
Please find the Zip with the debug binaries.
Make a backup of the AIE bin directory.
Then unzip and overwrite the bin folder with the files included in the debug zip.
NOTE: Not all files will be replaced, because not all files need to be debuggable.

When these debuggable binaries are installed and operational, we are ready to
deploy ADPlus.

C. Preparing to run ADPlus

Start your AIE Service. It's better to run only one AIE instance at this time, for
easy tracing.

ADPlus must be run from a command window ( Example: Click Start->All Progam-
>Accessories->Command Prompt)

Additionally, it is best to run the ADPlus command while �in� the same directory
where adplus.vbs resides. The default location is �C:\Program Files\Debugging Tool
for Windows�

Identify the process identifier (ID) of the process targeted for debugging, in this
case, aie.exe. We will call this process id �AIE_PID�

There are several ways to perform this feat, one of which is to use Windows Task
Manager.

Example:

Right mouse click on your Desk top Tool bar

Click on Task Manager
Click on the Processes tab.
If your Task Manager Processes View does not include Process ID�s (PID�s), add this
column by clicking on View->Select Columns. Check the box by �PID Process ID�.
Click on OK to exit Column selection.
Search for aie.exe in the column labeled �Image Name�
When it�s located, record aie.exe�s PID. We will refer to this as �AIE_PID�

D. For Crashing aie.exe Issues

Before aie.exe encounters thread termination or process abort,

In the command window:

adplus -crash -p AIE_PID -o C:\ADPlus -FullOnFirst

Wait until crash occurs, or do the steps needed to replicate the crash.

Do not close icon related to new command prompt window which contains the ADPlus
command output. This will terminate your aie.exe process.

Note: ADPlus may catch 1 or more crashes of aie.exe depending on the location
and/or severity of the failure. Consequently, you may have more than a single DMP
file to send.

Once a crash is detected and ADPlus completes the writing of the log file and DMP
file, please ZIP the resultant file and transfer them to Tech Support. Be sure to
alert Support of their transfer.

E. Deliver ADPlus generated files to Tech Support

Follow Tech Support instruction as to where to transfer the ADPlus files created in
C:\ADPlus.