This problem was first addressed in the Host Integration Server 2004 update that is described in article 917599. The information in this article supersedes the information in Microsoft Knowledge Base article 917599.
For more information, click the following article number to view the article in the Microsoft Knowledge Base:
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 "DFS" character string
The changes that are implemented in update 917599 are included in Host Integration Server 2004 SP1.
Based on customer feedback, additional changes were made to better handle incoming IBM IMS application data that begins with the "DFS" character string. The additional changes are described in this article.
By default, TI processes the data that begins with the "DFS" character string as an IMS error message when TI receives the data from an IBM IMS application. Therefore, event ID 102 is logged.
Host Integration Server 2004 and Host Integration Server 2004 SP1
Important This section, method, or task contains steps that tell you how to modify the registry. However, serious problems might occur if you modify the registry incorrectly. Therefore, make sure that you follow these steps carefully. For added protection, back up the registry before you modify it. Then, you can restore the registry if a problem occurs. For more information about how to back up and restore the registry, click the following article number to view the article in the Microsoft Knowledge Base:
322756 How to back up and restore the registry in Windows
After you apply one of the updated Host Integration Server 2004 hotfixes that are described in this article, you can configure TI to process the data that begins with the "DFS" character string as regular application data. 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.
If you enable the
AllowDFSAsUserData
registry key, TI processes the data that begins with the �DFS� character string as regular application data unless the MOD_NAME value in the Request Mode Message (*REQMOD*) structure equals DFSMO. If the MOD_NAME value equals DFSMO, TI still processes the data that begins with the �DFS� character string as an IMS error message.
Host Integration Server 2006
After you apply the Host Integration Server 2006 hotfix that is described in this article, a TI remote environment (RE) that is defined to communicate with an IBM IMS application by using TCP/IP includes the
Error Recognition configuration options. You can use the
Error Recognition configuration options to specify how TI processes the data that begins with the "DFS" character string.
The
Error Recognition configuration options are as follows:
- DFS at beginning of 1st Data Segment
If you select this option, TI processes all the data that begins with the �DFS� character string as an IMS error message. - MFS MOD name returned in RMM
If you select this option, the MFS Mode name box becomes available. You use the MFS Mode name box to specify the MOD_NAME value that is used to determine whether the incoming data is an IMS error message. For example, if the MOD_NAME value equals DFSMO, TI still processes the data that begins with the �DFS� character string as an IMS error message. Otherwise, TI processes the data as regular application data, and TI returns the data to the calling TI application.
To access the
Error Recognition configuration options in a TI RE configuration, follow these steps:
- Click Start, click All Programs, click Microsoft Host Integration Server 2006, and then click TI Manager.
- Expand Windows-Initiated Processing, and then expand Remote Environments.
- Right-click the TI RE that is defined to communicate with the IBM IMS application, and then click Properties.
- Click the IMS tab.
- Configure the Error Recognition configuration options.
Note The
AllowDFSAsUserData
registry key does not apply to Host Integration Server 2006.
An IBM IMS application may return a valid error message that contains the "DFS" character string. In this case, TI may not process the valid error message as an IMS error message if you change the way that TI processes the data that begins with the "DFS" character string. This behavior could lead to other unexpected errors in the calling TI application or in the TI run-time environment. Therefore, change the default behavior only if the following conditions are true:
- The 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.
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
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.