Article ID: 917599
Article Last Modified on 12/4/2007
APPLIES TO
- Microsoft Host Integration Server 2004 Enterprise Edition
- Microsoft Host Integration Server 2004 Standard Edition
SYMPTOMS
In Microsoft Host Integration Server 2004, Transaction Integrator (TI) logs an event that resembles the following:
Event ID: 102
Source: COMTI
Description: (102) COM Transaction Integrator reported the following exception to the client:
Component: Component_Name
Method: Method_Name
Exception description: (2168) The TCP transport received an error message from IMS when using IMS Connect or OTMA. Message=DFSData, Transaction Transaction_Name. IP Address: TCP/IP_Address, port: Port_Number
This problem occurs when the first segment of data that TI receives from an IBM Information Management System (IMS) application begins with the "DFS" character string.
CAUSE
This problem occurs because TI interprets the data that begins with the "DFS" character string as an IMS error message when TI receives the data from an IBM IMS application.
RESOLUTION
Hotfix information
A supported hotfix is now available from Microsoft. However, this hotfix is intended to correct only the problem that is described in this article. Apply this hotfix only to systems that are experiencing this specific problem. This hotfix might receive additional testing. Therefore, if you are not severely affected by this problem, we recommend that you wait for the next service pack that contains this hotfix.
To resolve this problem, submit a request to Microsoft Online Customer Services to obtain the hotfix. To submit an online request to obtain the hotfix, visit the following Microsoft Web site:
Note If additional issues occur or 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 hotfix. To create a separate service request, visit the following Microsoft Web site:
File information
The English version of this hotfix 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 | SP requirement |
|---|---|---|---|---|---|---|
| Capture.dll | 6.0.2029.0 | 25,600 | 04-May-2006 | 18:50 | x86 | SP1 |
| Comticontext.dll | 6.0.2029.0 | 25,600 | 04-May-2006 | 18:51 | x86 | SP1 |
| Dcgen.dll | 6.0.2029.0 | 99,328 | 04-May-2006 | 18:50 | x86 | SP1 |
| Microsoft.hostintegration.ti.clientcontext.dll | 6.0.2029.0 | 12,288 | 04-May-2006 | 18:50 | x86 | SP1 |
| Microsoft.hostintegration.ti.dcgen.interop.dll | 6.0.1701.0 | 4,096 | 04-May-2006 | 18:51 | x86 | SP1 |
| Microsoft.hostintegration.ti.tracing.interop.dll | 6.0.1701.0 | 4,608 | 04-May-2006 | 18:50 | x86 | SP1 |
| Mobase.dll | 6.0.2029.0 | 249,344 | 04-May-2006 | 18:50 | x86 | SP1 |
| Playback.dll | 6.0.2029.0 | 24,064 | 04-May-2006 | 18:50 | x86 | SP1 |
| Tagen.dll | 6.0.2029.0 | 95,744 | 04-May-2006 | 18:50 | x86 | SP1 |
| Tracing.dll | 6.0.2029.0 | 542,208 | 04-May-2006 | 18:50 | x86 | SP1 |
| Tranlu62.dll | 6.0.2029.0 | 53,760 | 04-May-2006 | 18:50 | x86 | SP1 |
| Trantcp.dll | 6.0.2029.0 | 103,936 | 04-May-2006 | 18:51 | x86 | SP1 |
| Turnaround.dll | 6.0.2029.0 | 34,304 | 04-May-2006 | 18:51 | x86 | SP1 |
Note Because of file dependencies, the most recent hotfix that contains these files may also contain additional files.
STATUS
Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the "Applies to" section.
MORE INFORMATION
IBM defined IMS error messages to have the following format:
DFSxxxxA
Note The xxxx placeholder represents three digits or four digits. The "A" suffix represents a suffix that has a specific meaning for IMS.
After you apply this hotfix, you can configure TI to process the data that begins with the "DFS" character string as regular application data instead of as an IMS error message. To do this, follow these steps:
- Click Start, click Run, type regedit, and then click OK.
- Locate the following registry subkey:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Cedar\Defaults - Right-click Defaults, point to New, and then click Key.
- Type AllowDFSAsUserData, and then press ENTER.
- Click AllowDFSAsUserData.
- Right-click (Default), and then click Modify.
- In the Value data box, type TRUE, and then click OK.
- Exit Registry Editor.
Note If you enable the AllowDFSAsUserData registry key, TI processes the data that begins with the "DFS" character string as regular application data when TI receives the data from an IBM IMS application. If an IBM IMS application returns a valid error message that contains the "DFS" character string, TI does not process the valid error message as an IMS error message. This behavior could lead to other unexpected errors in the calling TI application or in the TI run-time environment. Therefore, enable the AllowDFSAsUserData registry key only if the following conditions are true:
- IBM IMS applications in your environment return the "DFS" character string as application data.
- This application data must be processed by TI, and then this application data must be passed to the calling TI application.
REFERENCES
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
For more information about IMS Distributed File System (DFS) error messages, see the "IBM IMS Messages and Codes Volume 2" manual. To do this, visit the following IBM Web site:
Microsoft provides third-party contact information to help you find technical support. This contact information may change without notice. Microsoft does not guarantee the accuracy of this third-party contact information.
The third-party products that this article discusses are manufactured by companies that are independent of Microsoft. Microsoft makes no warranty, implied or otherwise, about the performance or reliability of these products.
Additional query words: tagen DFS IMS 2168
Keywords: kbbug kbfix kbqfe kbpubtypekc kbhotfixserver KB917599
