migmqbrk (Migrate broker to WebSphere Business Integration Brokers)
Purpose
Use the migmqbrk command to migrate a WebSphere MQ Publish/Subscribe broker to a WebSphere Business Integration Message Broker broker or a WebSphere Business Integration Event Broker broker.
This command is available only on platforms that support MQSeries Integrator V2.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.
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 we can restart it.
Syntax
>>-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
Migrate the broker on exampleQM.
migmqbrk -m exampleQM
Home