Parameters for Polling Interval and Threshold After Failure (324529)


The information in this article applies to:

  • Microsoft BizTalk Adapter for MQSeries 1.0
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 fix is now available from Microsoft, but it is only intended to correct the problem that is described in this article. Apply it only to computers that are experiencing this specific problem. This fix may receive additional testing. Therefore, if you are not severely affected by this problem, Microsoft recommends that you wait for the next service pack that contains this hotfix.

To resolve this problem immediately, contact Microsoft Product Support Services to obtain the fix. For a complete list of Microsoft Product Support Services phone numbers and information about support costs, visit the following Microsoft Web site:

http://support.microsoft.com/contactus/?ws=support

NOTE: In special cases, charges that are ordinarily incurred for support calls may be canceled if a Microsoft Support Professional determines that a specific update will resolve your problem. The typical support costs will apply to additional support questions and issues that do not qualify for the specific update in question.

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:HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\MTBSvc\Parameters\JobList\<yourjobname>. This value is the polling interval in milliseconds.
  2. Add the value FailureThreshold of data type REG_DWORD under the following registry key: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\MTBSvc\Parameters\JobList\<yourjobname>. 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.
Modification Type:MinorLast Reviewed:10/11/2005
Keywords:kbHotfixServer kbQFE kbbug kbfix kbQFE KB324529
©2004 Microsoft Corporation. All rights reserved.