Microsoft KB Archive/917599

= FIX: Transaction Integrator (TI) logs an event in Host Integration Server 2004 when the first segment of data that TI receives from an IBM IMS application begins with the &quot;DFS&quot; character string =

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:

Method:

Exception description: (2168) The TCP transport received an error message from IMS when using IMS Connect or OTMA. Message=DFS, Transaction. IP Address:, port:

This problem occurs when the first segment of data that TI receives from an IBM Information Management System (IMS) application begins with the &quot;DFS&quot; character string.



CAUSE
This problem occurs because TI interprets the data that begins with the &quot;DFS&quot; character string as an IMS error message when TI receives the data from an IBM IMS application.



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:

http://go.microsoft.com/?linkid=6294451

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:

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

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.

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 &quot;Applies to&quot; section.



MORE INFORMATION
IBM defined IMS error messages to have the following format:

DFS A

Note The  placeholder represents three digits or four digits. The &quot;A&quot; 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 &quot;DFS&quot; 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:

 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.</li> In the Value data box, type TRUE, and then click OK.</li> Exit Registry Editor.</li></ol>

Note If you enable the  registry key, TI processes the data that begins with the &quot;DFS&quot; 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 &quot;DFS&quot; 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  registry key only if the following conditions are true:
 * IBM IMS applications in your environment return the &quot;DFS&quot; 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.

<div class="references_section">