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

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.

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: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.
4. If you want to immediately apply the new trace settings, click to select the Make Trace settings effective immediately check box.
5. 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: 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:

Update information

A supported feature that modifies the default behavior of the product is available from Microsoft. However, this feature is intended to modify only the behavior that this article describes. Apply this feature only to systems that specifically require it. This feature might receive additional testing. Therefore, if the system is not severely affected by the lack of this feature, we recommend that you wait for the next software update that contains this feature.

If the feature is available for download, there is a "Hotfix download available" section at the top of this Knowledge Base article. If this section does not appear, contact Microsoft Customer Service and Support to obtain the feature.

Note If additional issues occur or if any troubleshooting is required, you might have to create a separate service request. The usual support costs will apply to additional support questions and issues that do not qualify for this specific feature. For a complete list of Microsoft Customer Service and Support telephone numbers or to create a separate service request, visit the following Microsoft Web site: Note The "Hotfix download available" form displays the languages for which the feature is available. If you do not see your language, it is because the feature is not available for that language. 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.

For more information about another TI WIP tracing improvement, click the following article number to view the article in the Microsoft Knowledge Base: For more information about software update terminology, click the following article number to view the article in the Microsoft Knowledge Base: