Microsoft KB Archive/324529

= Parameters for Polling Interval and Threshold After Failure =

Article ID: 324529

Article Last Modified on 11/15/2007

-

APPLIES TO


 * Microsoft BizTalk Adapter for MQSeries

-



This article was previously published under Q324529



SYMPTOMS
In a communication failure with MQSeries, the BizTalk Adapter for MQSeries is hard-coded to retry five times in ten-second intervals. The job is ended if the BizTalk Adapter cannot establish its communication with the MQSeries during these pollings. The ended job can only be started by restarting the BizTalk Adapter for MQSeries service.



RESOLUTION
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

The English version of this fix has the file attributes (or later) 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 tool in Control Panel.   Date         Time   Version      Size    File name --  28-Jun-2002  7:42   1.0.45.4   33,792   Mtbsvc.exe 28-Jun-2002 7:42   1.0.45.4   27,136   Aicmq.dll 28-Jun-2002 7:42   1.6.1.1    51,200   Lkrhash.dll 20-Jun-2002 7:42   1.0.45.4  171,520   Mmcmqs.dll 20-Jun-2002 7:42   1.0.45.4   27,648   Mqadaptersetup.dll 20-Jun-2002 7:42   1.0.45.4   54,784   Mqhelper.dll 20-Jun-2002 7:42   1.0.45.4    7,680   Mqhelperps.dll 20-Jun-2002 7:42   1.0.45.4   36,352   Mtbworker.dll 20-Jun-2002 7:42   1.0.45.4   20,480   Svcevent.dll 21-Jun-2002 13:01            136,974   Mmcmqs.chm 14-Jun-2002 14:27              1,294   Aicmq_mqpipeline_1.asp 14-Jun-2002 14:27              1,248   Aicmq_mqpipeline_1_post.asp

Installation Instructions
Note The fix must be applied on an RTM installation. It is a cumulative package and includes the fixes that are described in the following Microsoft Knowledge Base articles:

316405 FIX: You Cannot Send Messages from MQSeries to BizTalk on the Chinese Version of a Windows 2000-Based System

320738 FIX: BizTalk Adapter for MQSeries Service Requires an Administrator Account

320726 Implement Custom Post-Processor to Add Header Properties in AIC


 * 1) Stop the BizTalk Adapter for MQSeries service.
 * 2) In Component Services, remove the MQHelper COM component from the BizTalk Adapter for MQSeries COM+ application.
 * 3) Install the Btsmqs_q324529.exe fix, and then restart the server.
 * 4) Add MQHelper COM+ components to the BizTalk Adapter for MQSeries COM+ application by using the new binary (C:\Program Files\Microsoft BizTalk Adapter for MQSeries\Mqhelper.dll).
 * 5) Replace the RTM Active Server Pages (ASP) pages that are installed under the BizTalk folder (C:\Program Files\Microsoft BizTalk Server\MessagingManager\pipeline) with the ASP pages that are in the attached .zip file (Aicmq_mqpipeline_1.asp and Aicmq_mqpipeline_1_post.asp).
 * 6) Use the header file (Bts_mqs_sdk_guids.h) in the .zip file to create the post-processor component.



STATUS
Microsoft has confirmed that this is a problem in the Microsoft products that are listed at the beginning of this article.



MORE INFORMATION
After you apply this fix, two parameters control the BizTalk Adapter polling interval and threshold after communication failure with MQSeries: FailureWaitInterval and FailureThreshold. They are per job parameters. To set up these parameters:
 * 1) Add the value FailureWaitInterval of data type REG_DWORD under the following registry key: . This value is the polling interval in milliseconds.
 * 2) Add the value FailureThreshold of data type REG_DWORD under the following registry key:  . This value is the number of times the BizTalk Adapter polls MQSeries before it ends the job.

After you set up these two parameters, the BizTalk Adapter can recover from communication failure with MQSeries if the communication is reestablished within FailureWaitInterval X FailureThreshold milliseconds.

Keywords: kbhotfixserver kbqfe kbbug kbfix kbqfe KB324529

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.