A software update is available for Transaction Integrator Windows Initiated Processing internal tracing in Host Integration Server 2004

Hotfix Download Available
View and request hotfix downloads

View products that this article applies to.

INTRODUCTION

This article discusses a software update that enhances Microsoft Host Integration Server 2004 tracing capabilities for Transaction Integrator (TI) Microsoft Windows Initiated Processing (WIP) internal tracing.

You can enable TI WIP internal tracing to help troubleshoot TI WIP issues. However, the trace data that is captured when TI WIP internal tracing is enabled does not include the actual application data that is being sent to and received from the host application.

Typically, a network tracing utility such as Network Monitor is used together with TI WIP internal tracing to view the actual data that is sent to or received from the host application.

Back to the top

MORE INFORMATION

This software update enhances the tracing capabilities of TI WIP to capture application data that is being sent to and received from the host application. Additionally, the application data is traced in an EBCDIC format and in an ASCII format.

The following is an excerpt of a TI WIP internal trace that captures application data that is being sent to the Cedarbank sample application:

18161	TCP Transport sent user data: Offset=0x00000000    d1819585 40c49685 40404040 40404040     Jane Doe         
18161	TCP Transport sent user data: Offset=0x00000010    40404040 40404040 40404040 4040f1f0                     10 
18161	TCP Transport sent user data: Offset=0x00000020    f0f14040 00000010 0d                    01

The following is an excerpt of the same trace that captures data that is being received from the Cedarbank sample application:

18162	TCP Transport received user data: Offset=0x00000000    d1819585 40c49685 40404040 40404040     Jane Doe         
18162	TCP Transport received user data: Offset=0x00000010    40404040 40404040 40404040 4040f1f0                   10 
18162	TCP Transport received user data: Offset=0x00000020    f0f14040 00007771 2c                    01

The additional tracing will correctly convert the data to ASCII characters and will display the ASCII characters between a space character (X’20’) and a tilde character (X’7E’). Additionally, some data types that the TI WIP application uses will not be converted to ASCII or displayed in the ASCII section of the trace data.

In the sample trace, the host application returned 77712c. However, the data was not converted to ASCII or displayed in the ASCII section of the trace data. This behavior occurred because the data was defined as a packed decimal data type in the Type Library or in the Assembly.

To enable TI WIP internal tracing, follow these steps:

In TI Manager, right-click Windows Initiated Processing, and then click Tracing.
Click to select the check boxes for the trace categories for which you want to enable tracing.

Note When a trace category is enabled, the trace options that are associated with that category are also enabled. If you want to limit the information that will be traced, you can disable individual trace options.
If you want to immediately apply the new trace settings, verify that Make Trace settings effective immediately is selected.
Click OK, and then close TI Manager.

To disable TI WIP internal tracing, clear the check boxes for the trace categories in TI Manager.

Trace files are created in the Traces folder. The Traces folder is located in the folder where Host Integration Server 2004 is installed. For example, the path of the Traces folder may be the following:

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

Note Disable TI WIP internal tracing when you do not need it for troubleshooting. When tracing is enabled, trace files will continue to be created. One trace file is created for each TI WIP process. If you leave tracing enabled, the trace files may eventually consume lots of hard disk space. Additionally, tracing may affect system performance.

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

Collapse this tableExpand this table

Trace category	Data
General	Provides high-level information about end-to-end global processing.
Transport	Provides detailed connection information about the activities on the SNA network or on the TCP network.
Convert	Provides detailed information about how the data is converted from COM and .NET data on the servers to COBOL or RPG data on the host.
Read Lib	Provides information about the contents of the type library. You can use this category to augment the information in the Convert trace.
TI Proxy	Provides detailed information about object instantiation, about state transitions, and about method invocation.

If you want to capture only the application data that is being sent to and received from the host application, enable the following TI WIP trace categories and trace options.

Collapse this tableExpand this table

Trace categories	Trace options
Transport	Details
Convert	Extended Error Info

You can enable additional trace categories and trace options to capture trace data together with the application data.

Back to the top

Software 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:

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

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.

File information

The English version of this software 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 tool in Control Panel.

Collapse this tableExpand this table

File name	File version	File size	Date	Time	Platform	SP requirement
Capture.dll	6.0.2020.0	25,600	15-Mar-2006	02:00	x86	SP1
Dcgen.dll	6.0.2020.0	98,816	15-Mar-2006	02:00	x86	SP1
Microsoft.hostintegration.ti.dcgen.interop.dll	6.0.1701.0	4,096	15-Mar-2006	02:00	x86	SP1
Mobase.dll	6.0.2020.0	249,344	15-Mar-2006	02:00	x86	SP1
Playback.dll	6.0.2020.0	24,064	15-Mar-2006	02:00	x86	SP1
Tagen.dll	6.0.2020.0	94,720	15-Mar-2006	02:00	x86	SP1
Tracing.dll	6.0.2020.0	541,184	15-Mar-2006	02:00	x86	SP1
Tranlu62.dll	6.0.2020.0	53,760	15-Mar-2006	02:00	x86	SP1
Trantcp.dll	6.0.2020.0	102,912	15-Mar-2006	02:00	x86	SP1
Turnaround.dll	6.0.2020.0	34,304	15-Mar-2006	02:00	x86	SP1

Note Because of file dependencies, the most recent software update that contains these files may contain additional files.

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

824684 (http://support.microsoft.com/kb/824684/ ) Description of the standard terminology that is used to describe Microsoft software updates

Back to the top