Notice: This website is an unofficial Microsoft Knowledge Base (hereinafter KB) archive and is intended to provide a reliable access to deleted content from Microsoft KB. All KB articles are owned by Microsoft Corporation. Read full disclaimer for more details.

FIX: BizTalk Adapter for Orders included in Commerce Server 2009 R2 intermittently stops processing messages


View products that this article applies to.

Symptoms

Consider the following scenario:
  • You install the Commerce Server Adapters for BizTalk Server on a computer that is running Microsoft BizTalk Server. These adapters are included in Microsoft Commerce Server 2009 R2.
  • You create and configure an Orders receive location for an endpoint by using the BizTalk Adapter for Orders to receive orders from Commerce Server 2009 R2.

In this scenario, the receive location for the endpoint may stop processing messages intermittently. This condition continues until the endpoint is restarted.

Additionally, an error message that resembles the following is logged in the Application log:
Event Type: Error
Event Source: BizTalk Server 2009
Event Category: BizTalk Server 2009
Event ID: 5673
Description:
The Messaging Engine received an error from transport adapter "adapter_name" when notifying the adapter with the BatchComplete event. Reason "Object reference not set to an instance of an object."
Note The adapter_name placeholder in this error message is the name that you specified for the BizTalk Adapter for Orders in BizTalk Server, such as Commerce Server Orders.

↑ Back to the top


Cause

This problem occurs because an infinite waiting state may occur when BizTalk Adapter for Orders does not receive signals from other parties during a transaction. When this occurs, the adapter stops polling Commerce Server Order Web Services.

↑ Back to the top


Resolution

To resolve this problem, apply this hotfix. After you apply this hotfix, a new registry entry is introduced for you to configure the transaction time-out value for BizTalk Adapter for Orders. To enable this hotfix, see the Enable the hotfix section.

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: 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.


Prerequisites

To apply this hotfix, you must have the Commerce Server adapters for BizTalk Server installed.


Enable the hotfix

To enable this hotfix, follow these steps:
  1. Restart the endpoint.
  2. Apply this hotfix.
  3. In the registry, locate the following subkey:
    HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\CommerceServer\9.0\BizTalk Adapters\Orders\subkey
    Note In this case, the subkey placeholder is the value that is specified in the Transport Properties of the Order Receive location.
  4. Add the following registry entry and value to the subkey:
    String Value name: TransactionTimeoutMinutes
    String Value data: 5

    Note When you set the time-out value for TransactionTimeoutMinutes, do not set the value too small. Make sure that you set the value to be greater than the Microsoft Distributed Transaction Coordinator (MSDTC) time-out value. If you set the value too small, a time-out might occur before the BizTalk Server can finish processing the orders. Also, do not set the value too large, because the adapter will wait that long before it times out and continues.

After you enable this hotfix, an error message that resembles the following is logged in the Application log when a transaction time out occurs:
Log Name: Application
Source: Commerce Server Orders Receive Adapter
Date: datetime
Event ID: 0
Task Category: None
Level: Error
Keywords: Classic
Description:
SubmitBatch: Transaction timeout occurred with timeout value of 300000
Note The time-out value in this error message is in milliseconds.



Restart information

You do not have to restart the computer after you apply this hotfix. However, you must restart the BizTalk host instance 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.

File nameFile versionFile sizeDateTimePlatform
Microsoft.commerceserver.adapter.orders.receiveadapter.dll9.0.4260.21751,86418-Feb-201320:28x86
Note Because of file dependencies, the most recent fix that contains these files may also contain additional files.

↑ Back to the top


Status

Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the "Applies to" section.

↑ Back to the top


More Information

If you want more information about the BizTalk Server adapters, go to the following Microsoft Developer Network (MSDN) webpage:

↑ Back to the top


Keywords: kbautohotfix, kbqfe, kbhotfixserver, kbfix, kbbug, kbexpertiseinter, kbsurveynew, kb

↑ Back to the top

Article Info
Article ID : 2817157
Revision : 1
Created on : 1/7/2017
Published on : 6/20/2014
Exists online : False
Views : 343