FIX: A message of the System.Xml.Xmldocument type that is sent from an orchestration is suspended and a routing failure report is generated when you specify the Direct Binding type for the ports in the orchestrations in BizTalk Server 2006 R2
Consider the following scenario in Microsoft BizTalk Server 2006 R2:
- You have a BizTalk application that uses orchestrations that construct new messages of the System.Xml.Xmldocument type.
- You specify the Direct Binding type for the ports in the orchestrations.
- A routing failure report is a special message that is generated by BizTalk Server. This message does not have a body. However, this message has the context of the failed message.
- The MessageType property indicates the message type of the failed message. BizTalk Server uses the message type to associate messages with their XML schemas.
This problem occurs because of a problem in the BizTalk XLANG engine. The BizTalk XLANG engine does not persist the MessageType property during orchestration dehydration. Also, the XLANG engine does not save the type information for messages of the System.Xml.Xmldocument type in the XLANG metadata cache. Therefore, when the orchestration rehydrates, the MessageType property is lost, and the message is suspended. Then, you receive the routing failure report that is described in the "Symptoms" section.
Hotfix informationA supported hotfix is 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.
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, submit a request to 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 Web site: Note 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.
PrerequisitesYou must have Microsoft BizTalk Server 2006 R2 installed to apply this hotfix.
Restart requirementYou do not have to restart the computer after you apply this hotfix.
Hotfix replacement informationThis hotfix does not replace a previously released hotfix.
File informationWarning After you have applied the hotfix, the MessageType property is always promoted if you have a message of System.Xml.Xmldocument type. There is no switch for this behavior. You should make sure that your subscription design accounts for all System.Xml.Xmldocument messages having a MessageType, regardless if a schema was deployed for your BizTalk application. 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.
|File name||File version||File size||Date||Time||Platform|
To work around this problem, use one of the following options:
- Force the execution of the default XML Receive pipeline on the Construct Message shape and on the Message Assignment shape in orchestration.
- Specify the following element in the BTSNTSvc.exe.config or BTSNTSvc64.exe.config file:
<Dehydration NeverDehydrate="true"> </Dehydration>
- This option may cause an increase in memory consumption. Therefore, you should use this option carefully.
- By default, the BTSNTSvc.exe.config file and the BTSNTSvc64.exe.config file are located in the following folder:<drive>:\Program Files\Microsoft BizTalk Server 2006Note <drive> is a placeholder for the hard disk on which BizTalk Server 2006 is installed.
On 64-bit servers, the 32-bit versions of the files and the 64-bit versions of the files are located in the following folder:C:\Program Files (x86)\
Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the "Applies to" section.
For more information about failed message routing, visit the following Microsoft Web site:
824684 Description of the standard terminology that is used to describe Microsoft software updates
Routing Failure reports; MessageType
Article ID: 968654 - Last Review: 04/07/2010 20:36:37 - Revision: 2.0
Microsoft BizTalk Server 2006 R2 Standard Edition, Microsoft BizTalk Server 2006 R2 Enterprise Edition, Microsoft BizTalk Server 2006 R2 Developer Edition, Microsoft BizTalk Server 2006 R2 Branch Edition
- kbbiztalk2006r2sp1fix kbbtsadapters kbautohotfix kbexpertiseinter kbfix kbhotfixserver kbqfe KB968654