Microsoft KB Archive/929900

= A software update is available that improves the tracing capabilities of Transaction Integrator Windows Initiated Processing internal tracing when you use persistent connections in Host Integration Server 2004 =

Article ID: 929900

Article Last Modified on 12/4/2007

-

APPLIES TO


 * Microsoft Host Integration Server 2004 Enterprise Edition

-



INTRODUCTION
This article describes a software update for Microsoft Host Integration Server 2004. This update improves the tracing capabilities of Transaction Integrator (TI) Microsoft Windows Initiated Processing (WIP) internal tracing when you use persistent connections.

You can turn on TI WIP internal tracing to help troubleshoot TI WIP issues. However, the trace data that TI WIP internal tracing captures does not include enough information to accurately troubleshoot issues that are related to persistent connections.

Typically, a network tracing utility such as Microsoft Network Monitor is used together with the TI WIP internal tracing to troubleshoot issues that are related to TI WIP applications.

After you apply this update, TI WIP internal tracing can capture additional persistent connection information.



MORE INFORMATION
The following is a list of some persistent connection information that TI WIP internal tracing can capture after you apply this update:
 * The local TCP/IP port number that the persistent connection uses
 * The connection time-out value
 * The socket number
 * The connection type

Additionally, this update makes several other changes to help clarify the trace data for persistent connection initializations and terminations.

When you use persistent connections, updated trace statements may be included in the TI WIP trace log file. The following are examples of some updated trace statements:

18082 TCP Transport port properties: remote port number=3000, local port number=3542, timeout=0, socket=0x3405, connection type=Open.

18019 TCP Transport Disconnect entered, type = Normal, local port = 3542

10073 Removing reused persistent connection, correlator = 00000000340500000000000000000000.

10075 Removing aborted persistent connection, correlator = 00000000340500000000000000000000.

Note Other trace statements will be included in the TI WIP trace log file. Also, when you view a trace log file, the trace statements may not appear in this particular order.

To turn on TI WIP internal tracing, follow these steps:
 * 1) Click Start, click All Programs, click Microsoft Host Integration Server 2004, and then click TI Manager.
 * 2) Expand Transaction Integrator, right-click Windows-Initiated Processing, and then click Tracing.
 * 3) Under Trace Categories, click to select the check boxes for the trace categories that you want to include in internal tracing.

Note When you select a trace category, the options that are associated with that category are also selected. These options appear under Trace Options. If you want to limit the information that TI WIP internal tracing captures, you can click to clear the check boxes for the individual trace options that apply to each trace category.
 * 1) If you want to immediately apply the new trace settings, click to select the Make Trace settings effective immediately check box.
 * 2) Click OK, and then close TI Manager.

Note To turn off TI WIP internal tracing, repeat the previous steps and click to clear the check boxes for the trace categories that you selected in step 3.

TI WIP internal tracing creates trace files in the Traces folder. The Traces folder is located in the folder where Host Integration Server 2004 is installed. For example, the default path of the Traces folder resembles the following:

C:\Program Files\Microsoft Host Integration Server\Traces

Note Turn off TI WIP internal tracing when you do not have to trace for troubleshooting. When TI WIP internal tracing is turned on, TI WIP internal tracing creates one trace file for each TI WIP process. If you leave TI WIP internal tracing turned on, the trace files may eventually consume lots of hard disk space. Additionally, TI WIP internal tracing may affect system performance.

The following table contains a general overview of the kind of data that the trace categories capture.

Service pack information
This feature is available in the latest service pack for Host Integration Server 2004. For more information, click the following article number to view the article in the Microsoft Knowledge Base:

940313 How to obtain the latest Host Integration Server 2004 service pack

Update information
A supported feature that modifies the default behavior of the product is now available from Microsoft, but it is only intended to modify the behavior that this article describes. Apply it only to systems that specifically require it. This feature may receive additional testing. Therefore, if you are not severely affected by the lack of this feature, we recommend that you wait for the next Microsoft Host Integration Server 2004 service pack that contains this feature.

To obtain this feature immediately, download the feature by following the instructions later in this article or contact Microsoft Product Support Services. For a complete list of Microsoft Product Support Services telephone numbers and information about support costs, visit the following Microsoft Web site:

http://support.microsoft.com/contactus/?ws=support

The English version of this update has the file attributes (or later file attributes) that are listed in the following table. The dates and times for these files are listed in Coordinated Universal Time (UTC). When you view the file information, it is converted to local time. To find the difference between UTC and local time, use the Time Zone tab in the Date and Time item in Control Panel.

