FIX: MQHRF2 header is included in the message body when you use the MQSC Adapter in a Host Integration Server 2006 environment

Article translations Article translations
Article ID: 2427231 - View products that this article applies to.
Expand all | Collapse all

On This Page

SYMPTOMS

In a Microsoft Host Integration Server 2006 environment, when you use the client-based BizTalk Adapter for WebSphere MQ (MQSC Adapter) to receive messages that contain a header type of MQHRF2, the header information is moved into the message body. This may not be what you want because the downstream parser may be expecting a message body that does not contain the header information.

CAUSE

This problem occurs because the MQSC receive location does not parse MQHRF2 header properties and promote the information. To preserve the data in the header, the MQSC adapter just moves it into the message body.

RESOLUTION

To resolve this problem, apply this hotfix. This hotfix enables two options for MQHRF2 handling:
  • To preserve the header properties as part of the message body.
  • To completely remove the MQHRF2 header properties from the message body and to discard the header data.
After the hotfix is applied, if you set Data Offset for Headers option to Yes for the MQSC receive location, the MQHRF2 header is removed from the message body. If you set Data Offset for Headers to No, the MQHRF2 header will be part of the message body.

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:
http://support.microsoft.com/contactus/?ws=support
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

You must have Microsoft Host Integration Server 2006 installed to apply this hotfix.

Restart information

You do not have to restart the computer 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.

For Microsoft Host Integration Server 2006, 32-bit Edition
Collapse this tableExpand this table
File nameFile versionFile sizeDateTimePlatform
Microsoft.biztalk.adapter.mqsc.dll2.1.619.0137,08818-Nov-201016:03x86
Microsoft.biztalk.adapter.mqsc.imqwrapper.common.dll2.1.619.035,23218-Nov-201016:03x86
Microsoft.biztalk.adapter.mqsc.imqwrapper.dll2.1.619.0122,77618-Nov-201016:03x86
Microsoft.biztalk.adapter.mqsc.imqwrappertxn.dll2.1.619.0120,73618-Nov-201016:03x86
Microsoft.biztalk.adapter.mqscadmin.dll2.1.619.087,94418-Nov-201016:03x86
Mqseries.dll2.1.619.0198,48018-Nov-201016:03x86
Mqseriesex.dll2.1.619.038,74418-Nov-201016:03x86
Note Because of file dependencies, the most recent fix that contains these files may also contain additional files.


STATUS

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

MORE INFORMATION

For more information about MQSC Adapter, visit the following Microsoft Developer Network (MSDN) website:
BizTalk Adapter for WebSphere MQ
For more information about Receive Location properties, visit the following Microsoft Developer Network (MSDN) website:
How to Configure a Receive Port and a Receive Location for the MQSC Adapter

Properties

Article ID: 2427231 - Last Review: January 21, 2011 - Revision: 1.0
APPLIES TO
  • Microsoft Host Integration Server 2006 Enterprise Edition
  • Microsoft Host Integration Server 2006 Service Pack 1
  • Microsoft Host Integration Server 2006
Keywords: 
kbautohotfix kbqfe kbhotfixserver kbfix kbexpertiseinter kbprb kbsurveynew kbbug KB2427231

Give Feedback

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com