Microsoft KB Archive/259045

From BetaArchive Wiki
Knowledge Base


MSMQ_MQSeries Bridge: Translating Windows NT Machine Names That Contain Hyphens

Article ID: 259045

Article Last Modified on 3/26/2004



APPLIES TO

  • MSMQ - MQSeries Bridge



This article was previously published under Q259045

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

Messages that are sent from IBM MQSeries to MSMQ queues may be rejected for having invalid names.

CAUSE

When sending to MSMQ queues on Microsoft Windows NT, the computer name for Windows NT may contain a hyphen (-). Although this is a valid naming convention, IBM MQSeries does not support hyphens as part of the name (computer name part of the MSMQ computername\queue syntax).

RESOLUTION

To resolve this problem, obtain the latest service pack for SNA Server 4.0. For additional information, click the following article number to view the article in the Microsoft Knowledge Base:

215838 How to Obtain the Latest SNA Server Version 4.0 Service Pack



The Windows NT NetBIOS names for computers where MSMQ queues reside do support the use of hyphens in the computer name. The Windows NT NetBIOS name is ported to the MQSeries side as the queue manager name.

This update allows for the use of periods (.) in the computer names for MQSeries, and the bridge will automatically translate a period in the NetBIOS name to a hyphen if the appropriate registry key is set to enable this feature.

NOTE: When an Export for a server file is done from the MSMQ-MQSeries Bridge, the customer must check the exported file and manually change any computer names with hyphens to periods before processing the Export on the MQSeries computer.

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.


After applying this fix, the translation feature may be turned on by making the following registry key nonzero:

Location: HKey_Local_Machine\Software\Microsoft\MQBridge\Server
Value: SupportMQBridgeNameWith- (REG_DWORD)=1


STATUS

Microsoft has confirmed that this is a problem in MSMQ - MQSeries Bridge.

This problem was first corrected in SNA Server 4.0 Service Pack 4.

Keywords: kbbug kbfix kbsna400presp4fix kbqfe kbsna400sp4fix KB259045