Symptoms
Consider the following scenario:
-
You have a Transaction Integration (TI) application that is running on a Microsoft Host Integration Server 2006 server or an earlier version.
-
The TI application uses custom TRM or ELM headers as described in the following Microsoft Knowledge Base article:
810956 FIX: A new feature in the COM Transaction Integrator gives the client program full control over a TRM request and lets the client program process the TRM reply
-
You use TRMIN, TRMOUT, ELMIN, or ELMOUT as the names for the user-defined type definitions for the custom TRM or ELM headers.
In this scenario, when the TI application is migrated to Host Integration Server 2009, you receive an exception that resembles the following when you run the TI application:
Unhandled Exception: System.ArgumentOutOfRangeException: Index and length must refer to a location within the string.
Parameter name: length
at System.String.InternalSubStringWithChecks(Int32 startIndex, Int32 length,Boolean fAlwaysCopy)
at Microsoft.HostIntegration.TI.ClientContext.OldContextToNew(Object[] contextArray)
at Microsoft.HostIntegration.TI.ClientContext..ctor(Object[] contextArray)
Cause
This problem occurs because the update that added the ability to use custom TRM or ELM headers intended for the names of the user-defined type definitions for the custom headers to be in a certain format. This is described in the following article in the Microsoft Knowledge Base:
810956 FIX: A new feature in the COM Transaction Integrator gives the client program full control over a TRM request and lets the client program process the TRM replyInformation for the TRM request or the TRM reply, or both, is passed to the TI run time through an optional parameter that contains an array of data. Formatting for the TRM request and the TRM reply is defined in the user-defined type definitions in the TI type library. The name of the user-defined type must start with the characters TRMIN for the TRM request and with TRMOUT for the TRM reply. This prefix is case-sensitive. TRM requests and TRM replies may have multiple user-defined type definitions. For example, you may have the following user-defined type definitions:
-
TRMINExample1
-
TRMINExample2
-
TRMINExample3
-
TRMOUTSample
In order to support TI Client Context objects that you created in earlier versions of Transaction Integrator, Host Integration Server 2009 checks for various keywords that were used in the older Client Context objects. In this case, TI was checking whether the lengths of the names that are used for the custom TRM and ELM header user-defined definitions were greater than 5 bytes for the TRMIN or ELMIN headers and greater than 6 bytes for the TRMOUT or ELMOUT headers. This check was implemented because it was expected that the headers would include a suffix following the TRMIN, TRMOUT, ELMIN, and ELMOUT prefix. The exception occurred because the length check was failing.
Resolution
Hotfix information
A supported hotfix is available from Microsoft. However, this hotfix is intended to correct only the problem that described in this article. Apply this hotfix only to systems that are experiencing the problem described in this article. This hotfix might receive additional testing. Therefore, if you are not severely affected by this problem, we recommend that you wait for the next software update that contains this hotfix.
If the hotfix 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 hotfix.
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 hotfix. For a complete list of Microsoft Customer Service and Support telephone numbers or to create a separate service request, visit the following Microsoft website:
http://support.microsoft.com/contactus/?ws=supportNote The "Hotfix download available" form displays the languages for which the hotfix is available. If you do not see your language, it is because a hotfix is not available for that language.
Prerequisites
You must have the following installed to apply this hotfix:
-
Microsoft Host Integration Server 2009
-
BizTalk Adapters for Host Systems 2.0
Restart information
You do not have to restart the computer after you apply this hotfix.
Replacement information
This hotfix does not replace a previously released hotfix.
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.
Microsoft Host Integration Server 2009, 32-bit Edition
|
File name |
File version |
File size |
Date |
Time |
Platform |
|---|---|---|---|---|---|
|
Hipobjects.dll |
8.0.3801.2 |
1,272,152 |
01-Mar-2011 |
00:22 |
x86 |
|
Mgddtcob390.dll |
8.0.3801.2 |
596,312 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.adapters.msti.management.dll |
8.0.3801.2 |
67,496 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.adapters.msti.runtime.dll |
8.0.3801.2 |
83,872 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.aggregateconverter.dll |
8.0.3801.2 |
67,488 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.clientcontext.dll |
8.0.3801.2 |
51,096 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.dpcaggregateconverter.dll |
8.0.3801.2 |
79,784 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.dpctransport.dll |
8.0.3801.2 |
63,384 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.elmtransport.dll |
8.0.3801.2 |
63,384 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.genericuserdatastatemachine.dll |
8.0.3801.2 |
25,528 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.globals.dll |
8.0.3801.2 |
116,616 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.hipadminclasses.interop.dll |
7.0.2302.0 |
79,792 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.httptransport.dll |
8.0.3801.2 |
42,904 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.imsconnectstatemachine.dll |
8.0.3801.2 |
34,736 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.imsconnecttransport.dll |
8.0.3801.2 |
75,688 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.libraryreader.dll |
8.0.3801.2 |
63,384 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.mgddtcob390.interop.dll |
7.0.2302.0 |
71,592 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.systemiprimitiveconverter.dll |
8.0.3801.2 |
15,280 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.systemzprimitiveconverter.dll |
8.0.3801.2 |
97,712 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.tcptransport.dll |
8.0.3801.2 |
47,000 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.trmtransport.dll |
8.0.3801.2 |
63,384 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.wipruntimeadministration.dll |
8.0.3801.2 |
47,024 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.tidesigner.app.dll |
8.0.3801.2 |
702,352 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.tidesigner.cobolimporter.dll |
8.0.3801.2 |
63,400 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.tidesigner.ctrl.dll |
8.0.3801.2 |
120,728 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.tidesigner.editparser.dll |
8.0.3801.2 |
22,432 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.tidesigner.itioutputmessagemgd.dll |
8.0.3801.2 |
12,728 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.tidesigner.pkg.dll |
8.0.3801.2 |
227,216 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.tidesigner.rpgimporter.dll |
8.0.3801.2 |
67,496 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.tidesigner.wizards.dll |
8.0.3801.2 |
440,224 |
01-Mar-2011 |
00:22 |
x86 |
Microsoft Host Integration Server 2009, 64-bit Edition
|
File name |
File version |
File size |
Date |
Time |
Platform |
|---|---|---|---|---|---|
|
Hipobjects.dll |
8.0.3801.2 |
1,272,152 |
01-Mar-2011 |
00:22 |
x86 |
|
Mgddtcob390.dll |
8.0.3801.2 |
596,312 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.adapters.msti.management.dll |
8.0.3801.2 |
67,496 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.adapters.msti.runtime.dll |
8.0.3801.2 |
83,872 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.aggregateconverter.dll |
8.0.3801.2 |
67,488 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.clientcontext.dll |
8.0.3801.2 |
51,096 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.dpcaggregateconverter.dll |
8.0.3801.2 |
79,784 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.dpctransport.dll |
8.0.3801.2 |
63,384 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.elmtransport.dll |
8.0.3801.2 |
63,384 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.genericuserdatastatemachine.dll |
8.0.3801.2 |
25,528 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.globals.dll |
8.0.3801.2 |
116,616 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.hipadminclasses.interop.dll |
7.0.2302.0 |
79,792 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.httptransport.dll |
8.0.3801.2 |
42,904 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.imsconnectstatemachine.dll |
8.0.3801.2 |
34,736 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.imsconnecttransport.dll |
8.0.3801.2 |
75,688 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.libraryreader.dll |
8.0.3801.2 |
63,384 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.mgddtcob390.interop.dll |
7.0.2302.0 |
71,592 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.systemiprimitiveconverter.dll |
8.0.3801.2 |
15,280 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.systemzprimitiveconverter.dll |
8.0.3801.2 |
97,712 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.tcptransport.dll |
8.0.3801.2 |
47,000 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.trmtransport.dll |
8.0.3801.2 |
63,384 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.ti.wipruntimeadministration.dll |
8.0.3801.2 |
47,024 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.tidesigner.app.dll |
8.0.3801.2 |
702,352 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.tidesigner.cobolimporter.dll |
8.0.3801.2 |
63,400 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.tidesigner.ctrl.dll |
8.0.3801.2 |
120,728 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.tidesigner.editparser.dll |
8.0.3801.2 |
22,432 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.tidesigner.itioutputmessagemgd.dll |
8.0.3801.2 |
12,728 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.tidesigner.pkg.dll |
8.0.3801.2 |
227,216 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.tidesigner.rpgimporter.dll |
8.0.3801.2 |
67,496 |
01-Mar-2011 |
00:22 |
x86 |
|
Microsoft.hostintegration.tidesigner.wizards.dll |
8.0.3801.2 |
440,224 |
01-Mar-2011 |
00:22 |
x86 |
|
Hipobjects.dll |
8.0.3801.2 |
2,225,496 |
01-Mar-2011 |
00:26 |
x64 |
|
Microsoft.hostintegration.adapters.msti.management.dll |
8.0.3801.2 |
67,496 |
01-Mar-2011 |
00:26 |
x86 |
|
Microsoft.hostintegration.adapters.msti.runtime.dll |
8.0.3801.2 |
83,872 |
01-Mar-2011 |
00:26 |
x86 |
|
Microsoft.hostintegration.ti.aggregateconverter.dll |
8.0.3801.2 |
67,488 |
01-Mar-2011 |
00:26 |
x86 |
|
Microsoft.hostintegration.ti.clientcontext.dll |
8.0.3801.2 |
51,096 |
01-Mar-2011 |
00:26 |
x86 |
|
Microsoft.hostintegration.ti.dpcaggregateconverter.dll |
8.0.3801.2 |
79,784 |
01-Mar-2011 |
00:26 |
x86 |
|
Microsoft.hostintegration.ti.dpctransport.dll |
8.0.3801.2 |
63,384 |
01-Mar-2011 |
00:26 |
x86 |
|
Microsoft.hostintegration.ti.elmtransport.dll |
8.0.3801.2 |
63,384 |
01-Mar-2011 |
00:26 |
x86 |
|
Microsoft.hostintegration.ti.genericuserdatastatemachine.dll |
8.0.3801.2 |
25,528 |
01-Mar-2011 |
00:26 |
x86 |
|
Microsoft.hostintegration.ti.globals.dll |
8.0.3801.2 |
116,616 |
01-Mar-2011 |
00:26 |
x86 |
|
Microsoft.hostintegration.ti.httptransport.dll |
8.0.3801.2 |
42,904 |
01-Mar-2011 |
00:26 |
x86 |
|
Microsoft.hostintegration.ti.imsconnectstatemachine.dll |
8.0.3801.2 |
34,736 |
01-Mar-2011 |
00:26 |
x86 |
|
Microsoft.hostintegration.ti.imsconnecttransport.dll |
8.0.3801.2 |
75,688 |
01-Mar-2011 |
00:26 |
x86 |
|
Microsoft.hostintegration.ti.libraryreader.dll |
8.0.3801.2 |
63,384 |
01-Mar-2011 |
00:26 |
x86 |
|
Microsoft.hostintegration.ti.systemiprimitiveconverter.dll |
8.0.3801.2 |
15,280 |
01-Mar-2011 |
00:26 |
x86 |
|
Microsoft.hostintegration.ti.systemzprimitiveconverter.dll |
8.0.3801.2 |
99,760 |
01-Mar-2011 |
00:26 |
x64 |
|
Microsoft.hostintegration.ti.tcptransport.dll |
8.0.3801.2 |
47,000 |
01-Mar-2011 |
00:26 |
x86 |
|
Microsoft.hostintegration.ti.trmtransport.dll |
8.0.3801.2 |
63,384 |
01-Mar-2011 |
00:26 |
x86 |
|
Microsoft.hostintegration.ti.wipruntimeadministration.dll |
8.0.3801.2 |
47,024 |
01-Mar-2011 |
00:26 |
x86 |
Note Because of file dependencies, the most recent fix 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.
