Registry settings for jobs and mappings in the BizTalk Adapter for MQSeries (816468)


The information in this article applies to:

  • Microsoft BizTalk Adapter for MQSeries 1.0

SUMMARY

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

In some circumstances, you must create or modify jobs and mappings in the Microsoft BizTalk Adapter for MQSeries without using the Microsoft Management Console (MMC) interface for the adapter. To do so, you modify the corresponding information in the registry. Modification of this information in the registry is not a good idea unless you cannot modify your settings through the user interface that is provided for the MQSeries adapter. For example, you must programmatically modify your jobs and mappings.

Note For these settings to take effect, you must stop and then restart the BizTalk Adapter for MQSeries service.

MORE INFORMATION

BizTalk Adapter for MQSeries stores configuration information for jobs and mappings in the following registry keys.

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.

Each job creates a key at the following registry setting:

[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\MTBSvc\Parameters\JobList\JobName]

Note In this example, JobName is the name of the job.

The following values are valid under the job key:
Registry valueData typeNotes
HostREG_SZName of the MQSeries server
QueueManagerNameREG_SZQueue Manager
TransmissionQueueNameREG_SZTransmission queue
GetMessageWaitIntervalREG_DWORDMessage wait interval (in milliseconds)
MaxAccumulatedMessageSizePerTransactionREG_DWORDMaximum accumulated size (in KB)
MaxNumMessagesPerTransactionREG_DWORDMaximum number of messages per transaction
PollIntervalREG_DWORDPolling interval (in milliseconds)

Under the JobName key, a child key exists for each mapping for the job. For example, the following registry key specifies a job that is named JobName that has a mapping that is named Mapping:

[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\MTBSvc\Parameters\JobList\JobName\MappingName]

Registry ValueData typeNotes
RemoteQueueNameREG_SZRemote queue name
OpennessREG_DWORDOpenness type
PassthroughFlagREG_DWORDPassthrough flag
EnvelopeNameREG_SZEnvelope name
DocumentDefinitionREG_SZDocument definition
ChannelNameREG_SZChannel name
SourceQualifierREG_SZSource qualifier
SourceIDREG_SZSource identifier
DestQualifierREG_SZDestination qualifier
DestIDREG_SZDestination identifier

To obtain valid value ranges, see your BizTalk documentation and the documentation for BizTalk Adapter for MQSeries.
Modification Type:MinorLast Reviewed:2/24/2004
Keywords:kbinfo KB816468 kbAudDeveloper
©2004 Microsoft Corporation. All rights reserved.