Microsoft KB Archive/331136

= FIX: Support for Message Formats in Addition to MQFMT_STRING =

Article ID: 331136

Article Last Modified on 11/15/2007

-

APPLIES TO


 * Microsoft BizTalk Adapter for MQSeries

-



This article was previously published under Q331136





SYMPTOMS
When messages are sent to an IBM MQSeries server on back-end systems, the message must comply with certain formats other than the MQFMT_STRING format, such as MQFMT_IMS and MQFMT_CICS. However, the Adapter for MQSeries only supports the MQFMT_STRING format.



RESOLUTION
A supported hotfix is now available from Microsoft. However, this hotfix is intended to correct only the problem that this article describes. Apply this hotfix only to systems that are experiencing this specific problem.

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 ---  12-Mar-2003  18:43  1.0.45.9    27,648  Aicmq.dll 12-Mar-2003 18:43  1.6.1.1     51,200  Lkrhash.dll 12-Mar-2003 18:43  1.0.45.9   172,544  Mmcmqs.dll 12-Mar-2003 18:43  1.0.45.9    27,648  Mqadaptersetuplibrary.dll 12-Mar-2003 18:43  1.0.45.9    67,584  Mqhelper.dll 12-Mar-2003 18:43  1.0.45.9     7,680  Mqhelperps.dll 12-Mar-2003 18:43  1.0.45.9    58,880  Mtbworker.dll 12-Mar-2003 18:43  1.0.45.9    20,480  Svcevent.dll 12-Mar-2003 18:43  1.0.45.9    33,792  Mtbsvc.exe 12-Mar-2003 18:45             145,392  Mmcmqs.chm 20-Nov-2002 13:19               1,294  Aicmq_mqpipeline_1.asp 20-Nov-2002 13:19               1,248  Aicmq_mqpipeline_1_post.asp Note Because of file dependencies, the most recent hotfix or feature that contains these files may also contain additional files.

Installation Instructions
Note You must apply the fix on an RTM installation. If you have earlier hotfixes installed, you must roll back to the RTM version when you remove the hotfixes.
 * 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_q331136.exe fix. You receive a prompt to 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 .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 your custom components.

Note Postprocessors that you create by using Visual Basic are not supported because Visual Basic does not support some data types.



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 the hotfix is applied, the Adapter converts the outbound data to ANSI only if the message format property is set to MQMFT_STRING. If the message format property is not set to MQFMT_STRING, the Adapter sends the message without any conversion, and the custom post and preprocessor components must specify a special format and construct the message in the correct format. For more information, see the online help.

This hotfix is a cumulative package that 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

324529 Parameters for Polling Interval and Threshold After Communication Failure

325165 Implement a Custom Preprocessor to Read Header Properties

Keywords: kbhotfixserver kbqfe kbbug kbfix kbqfe KB331136

-

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

© Microsoft Corporation. All rights reserved.