MSMQ-MQSeries Bridge Translates String Bodies to Unicode in SNA Server 4.0 SP4 (319787)


The information in this article applies to:

  • MSMQ - MQSeries Bridge, when used with:
    • the operating system: Microsoft Windows NT 4.0
  • Microsoft SNA Server 4.0 SP4
This article was previously published under Q319787
IMPORTANT: This article contains information about modifying the registry. Before you modify the registry, make sure to back it up and make sure that you understand how to restore the registry if a problem occurs. For information about how to back up, restore, and edit the registry, click the following article number to view the article in the Microsoft Knowledge Base:

256986 Description of the Microsoft Windows Registry

SYMPTOMS

When data is sent from MQSeries through the MSMQ-MQSeries Bridge with an indicated format of MQFMT_STRING, the Bridge automatically translates the data to Unicode. Any format type other than MQFMT_STRING is not translated. This may cause problems with data that must be maintained in its native format (for example, ASCII). This may also cause problems when applications specify MQFMT_STRING if the data contains non-character data.

CAUSE

This action is by design, but you can override it. A new registry key is available for the Bridge that forces the MSMQ-MQSeries Bridge to not translate data that is coded as MQFMT_STRING.

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.

To resolve this problem immediately, download the fix by clicking the download link later in this article or 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/default.aspx?scid=fh;EN-US;CNTACTMS

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 usual 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 should have the following file attributes or later: 
   Date         Time   Version     Size     File name
   --------------------------------------------------
   07-Apr-2002  04:52  4.0.0.616   787,216  Q2qgw.exe

STATUS

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

MORE INFORMATION

WARNING: If you use Registry Editor incorrectly, you may cause serious problems that may require you to reinstall your operating system. Microsoft cannot guarantee that you can solve problems that result from using Registry Editor incorrectly. Use Registry Editor at your own risk.

This fix adds a registry controlled option to suppress translation of any message body that contains the MQFMT_STRING format type from MQSeries. After you apply the fix, you must add the following DWORD registry value and set it to a non-zero value:

HKEY_LOCAL_MACHINE\Software\Microsoft\MQBridge\Server\DisableUnicodeConversion

This fix is a port to the SNA Server 4.0 version of the MSMQ-MQSeries Bridge that is first fixed on the Microsoft Host Integration Server 2000 version of the MSMQ-MQSeries Bridge. For additional information about the Host Integration Server 2000 version of this fix, click the article number below to view the article in the Microsoft Knowledge Base:

301985 MSMQ-MQSeries Bridge Translates MQSeries String Bodies to Unicode

Modification Type:MinorLast Reviewed:9/27/2005
Keywords:kbHotfixServer kbQFE kbbug kbfix kbQFE KB319787
©2004 Microsoft Corporation. All rights reserved.