Microsoft KB Archive/835451

= How to use the BizTalk Adapter Trace Utility in BizTalk Server 2006 and in BizTalk Server 2004 =

Article ID: 835451

Article Last Modified on 10/25/2007

-

APPLIES TO


 * Microsoft BizTalk Server 2006 R2 Branch Edition
 * Microsoft BizTalk Server 2006 R2 Developer Edition
 * Microsoft BizTalk Server 2006 R2 Enterprise Edition
 * Microsoft BizTalk Server 2006 R2 Standard Edition
 * Microsoft BizTalk Server 2006 Developer Edition
 * Microsoft BizTalk Server 2006 Enterprise Edition
 * Microsoft BizTalk Server 2006 Standard Edition
 * Microsoft BizTalk Server 2004 Developer Edition
 * Microsoft BizTalk Server 2004 Enterprise Edition
 * Microsoft BizTalk Server 2004 Partner Edition
 * Microsoft BizTalk Server 2004 Standard Edition

-



SUMMARY
This step-by-step article describes how to install the Microsoft BizTalk Adapter Trace Utility. It also discusses how to run the BizTalk Adapter Trace Utility and how to have the generated trace file analyzed.

Install the BizTalk Adapter Trace Utility
To install the BizTalk Adapter Trace Utility, follow these steps:  To download the Tracelog.exe file, visit the following Microsoft Platform SDK download Web site:

http://go.microsoft.com/fwlink/?LinkId=21975

 Start the Platform SDK Web installation program by clicking the link for the PSDK-x86.exe file at the bottom of the Web page. When you are prompted, choose the option for a custom installation. In the Custom Installation dialog box, click to clear all the available features. Expand the Microsoft Windows Core SDK feature, and then expand the Tools feature. Choose the Tools (Intel 64-bit) feature, and then click Will be installed on local hard drive. Click Next, and then click Next again to start the installation. Locate the following folder, and then copy the Tracelog.exe file to the BizTalk Server 2006 installation folder or to the Microsoft BizTalk Server 2004 installation folder:



The BizTalk Server 2006 installation folder or the BizTalk Server 2004 installation folder also contains the Trace.cmd file.</li></ol>

Enable the BizTalk Adapter Trace Utility
To enable the BizTalk Adapter Trace Utility in BizTalk Server 2006 or in BizTalk Server 2004, follow these steps: <ol> At a command prompt, change the current directory to the directory where BizTalk Server 2006 or BizTalk Server 2004 is installed. By default, BizTalk Server 2006 and BizTalk Server 2004 are installed in the following directories, respectively: <ul> Program Files\Microsoft BizTalk Server 2006</li> Program Files\Microsoft BizTalk Server 2004</li></ul> </li> Type the following command, and then press ENTER:

trace -tools &quot; &quot;

By default, the BizTalk Adapter Trace Utility is located in the following directory:

C:\Program Files\Microsoft Platform SDK for Windows Server 2003 R2\Bin

Note You must enclose the path of the BizTalk Adapter Trace Utility in quotation marks.

For example, type the following command:

trace -tools &quot;C:\Program Files\Microsoft Platform SDK for Windows Server 2003 R2\Bin&quot;

The -tools switch indicates to the Trace.cmd file the location of the Tracelog.exe file.</li></ol>

Run the BizTalk Adapter Trace Utility
To run the BizTalk Adapter Trace Utility on a scenario, follow these steps: <ol> At a command prompt, type the following command, and then press ENTER:

trace -start -high

</li> Reproduce the scenario that you want to trace.</li> At a command prompt, type the following command, and then press ENTER:

trace -stop

</li></ol>

After you stop the trace, a binary file for BizTalk Server 2006 named BtsTrace.bin is generated in the folder where BizTalk Server 2006 is installed. Or, a binary file for BizTalk Server 2004 named Bts2004.bin is generated in the folder where BizTalk Server 2004 is installed.

You can send the BtsTrace.bin file or the Bts2004.bin file to Microsoft Customer Support Services for analysis.

Keywords: kbinfo kbbtsorchestration kbbtsmessaging KB835451

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.