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
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.
| 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.
| 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.
Software update information
A supported feature that modifies the product's default behavior 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 the system is not severely affected by the lack of this feature, we recommend that you wait for the next Host Integration Server 2004 service pack that contains this feature.
To obtain this feature immediately, 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:
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.
|
| 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
Description of the standard terminology that is used to describe Microsoft software updates