Microsoft KB Archive/929900
Article ID: 929900
Article Last Modified on 12/4/2007
- Microsoft Host Integration Server 2004 Enterprise Edition
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:
- Click Start, click All Programs, click Microsoft Host Integration Server 2004, and then click TI Manager.
- Expand Transaction Integrator, right-click Windows-Initiated Processing, and then click Tracing.
- 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.
- If you want to immediately apply the new trace settings, click to select the Make Trace settings effective immediately check box.
- 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.
|General||This category provides high-level information about end-to-end global processing.|
|Transport||This category provides detailed connection information about activities on the SNA network or on the TCP/IP network.|
|Convert||This category provides detailed information about how data is converted from COM and .NET data on the servers to COBOL or RPG data on the host computer.|
|Read Lib||This category provides information about the contents of the type library. You can use this category to augment the information in the Convert trace.|
|TI Proxy||This category provides detailed information about object instantiation, about state transitions, and about method calls.|
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
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:
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.
|File name||File version||File size||Date||Time||Platform|
For more information about another TI WIP tracing improvement, click the following article number to view the article in the Microsoft Knowledge Base:
913671 A software update is available for Transaction Integrator Windows Initiated Processing internal tracing in Host Integration Server 2004
For more information about software update terminology, click the following article number to view the article in the Microsoft Knowledge Base:
824684 Description of the standard terminology that is used to describe Microsoft software updates
Additional query words: tracebits wip TI tcp trace
Keywords: kbhotfixserver kbqfe kbpubtypekc kbinfo KB929900