Using BizTalk Adapter Tracing

This topic describes how to install the Trace Log tool and how to enable BizTalk adapter tracing.

Install the Trace Log Tool

To install the Trace Log tool (tracelog.exe)
  1. To download the Trace Log tool, visit the following Microsoft Platform SDK download Web site:

    Windows Server 2003 R2 Platform SDK Web Install

  2. Start the Platform SDK Web installation program by clicking the link for the PSDK-x86.exe file at the bottom of the Web page.

  3. When you are prompted, choose the option for a custom installation.

  4. In the Custom Installation dialog box, click to clear all the available features.

  5. Expand the Microsoft Windows Core SDK feature, and then expand the Tools feature.

  6. Choose the Tools (Intel 64-bit) feature, and then click Will be installed on local hard drive.

  7. Click Next, and then click Next again to start the installation.

    Aa561459.note(en-us,BTS.20).gifNote
    After installing the Platform SDK you will be prompted to reboot because certain components of the Platform SDK will not function correctly until the reboot has been completed. You do not need to reboot to use the Trace Log tool.

Enable BizTalk Adapter Tracing with trace.cmd

To enable BizTalk adapter tracing
  1. At a command prompt, change the current directory to the directory where BizTalk Server 2006 is installed. By default, BizTalk Server 2006 is installed in the Program Files\Microsoft BizTalk Server 2006 directory.

  2. Type the following command, and then press ENTER:

    trace -tools "Path of the Trace Log tool"

    By default, the Trace Log tool is located in the C:\Program Files\Microsoft Platform SDK\Bin directory. You must enclose the path of the Trace Log tool in quotation marks.

    For example, type the following command, and then press ENTER:

    trace -tools "C:\Program Files\Microsoft Platform SDK\Bin"

    Aa561459.note(en-us,BTS.20).gifNote
    The -tools switch indicates to the Trace.cmd file the location of the Tracelog.exe file.

Capture Trace output with trace.cmd

To capture trace output
  1. At a command prompt, change the current directory to the directory where BizTalk Server 2006 is installed. By default, BizTalk Server 2006 is installed in the Program Files\Microsoft BizTalk Server 2006 directory.

  2. At a command prompt, type the following command, and then press ENTER:

    trace -start

  3. Reproduce the scenario for which you want to capture trace output.

  4. At a command prompt, type the following command, and then press ENTER:

    trace -stop

  5. After you stop the trace, a binary file that is named Bts2006.bin is generated in the folder where BizTalk Server 2006 is installed.

  6. Send the Bts2006.bin file to Microsoft Product Support Services for analysis.

See Also

Other Resources

Using Adapters
Troubleshooting the Windows SharePoint Services Adapter

Tags :


Page view tracker