migmqbrk (Migrate broker to WebSphere Business Integration Brokers)

Purpose

Use the migmqbrk command to migrate a WebSphere MQ Publish/Subscribe broker to a WebSphere(R) Business Integration Message Broker broker or a WebSphere Business Integration Event Broker broker. This command is available only on platforms that support MQSeries(R) Integrator Version 2.0 and above. Make sure that you have applied any necessary CSD or Fix Pack to the WebSphere MQ base product before running this command. For instructions on applying a CSD or Fix Pack, see the appropriate Quick Beginnings for your platform.

Read the topics in the "Migrating publish/subscribe applications" of the WebSphere Business Integration Message Broker or WebSphere Business Integration Event Broker Help System before deciding to migrate. In particular, read the "Product differences" topic, which outlines the impact that migration will have on your current broker network.

Migration exports the following state to a replacement WebSphere Business Integration Message Broker or WebSphere Business Integration Event Broker broker. This broker must reside on the same queue manager as the Publish/Subscribe broker.

Subscriptions
All client subscriptions are exported from all streams except SYSTEM.BROKER.ADMIN.STREAM
Retained publications
All retained publications in MQRFH format are exported from all streams except SYSTEM.BROKER.ADMIN.STREAM
Local publishers
Registrations for all publishers that produce local publications are exported from all streams except SYSTEM.BROKER.ADMIN.STREAM
Related brokers
If the broker is part of a multi-broker hierarchy, details of all its relations are exported. This includes the names of all streams that the broker to be migrated has in common with each relation.

The WebSphere Business Integration Message Broker broker or WebSphere Business Integration Event Broker broker and the WebSphere MQ Publish/Subscribe broker that it is to replace must have been created on the same queue manager.

When migration is complete, the Publish/Subscribe broker will be deleted automatically. Therefore, you are advised to back up the queue manager that hosts the Publish/Subscribe broker before you start the migration. If migration fails, the Publish/Subscribe broker remains operational and you can restart it.

Syntax

Read syntax diagramSkip visual syntax diagram>>-migmqbrk-- -m QMgrName--------------------------------------><

Optional parameters

-m QMgrName
The name of the queue manager for which the broker function is to be migrated. This must match the queue manager that hosts the replacement WebSphere Business Integration Message Broker or WebSphere Business Integration Event Broker broker.

Return codes

0
Command completed normally
10
Command completed with unexpected results
20
An error occurred during processing

Examples

migmqbrk -m exampleQM Migrates the broker on exampleQM.