Migrating a message set

This task topic describes how migrate a message set into WebSphere Business Integration Message Broker Version 5.0.

Before you start:

Before you attempt this task topic it is recommended that you read the following reference topic:

Note: This task topic only applies to migrating a message set from WebSphere MQ Integrator Version 2.1 or WebSphere MQ Integrator Broker Version 2.1 to WebSphere Business Integration Message Broker Version 5.0.

It is possible to use message sets created using WebSphere MQ Integrator Version 2.1 or WebSphere MQ Integrator Broker Version 2.1 in WebSphere Business Integration Message Broker Version 5.0. You should note that if the *.mrp file is modified by hand between the export from WebSphere MQ Integrator Version 2.1 or WebSphere MQ Integrator Broker Version 2.1, and then imported into WebSphere Business Integration Message Broker Version 5.0, the results are not guaranteed and errors could occur.

To migrate a message set:

  1. Export the message set or sets from WebSphere MQ Integrator Broker Version 2.1. For more detailed information on this task refer to the WebSphere MQ Integrator Broker Version 2.1 documentation library.
  2. Transfer the exported *.mrp file or files to the system on which you are running the WebSphere Business Integration Message Broker Version 5.0 workbench. Check that the directory in which you store these files only contains files that you want to import.
  3. Close the workbench. This must not be running when you invoke the mqsimigratemsgsets command.
  4. From a command line invoke the mqsimigratemsgsets command specifying the parameters you require (see mqsimigratemsgsets command for full details of this command).
  5. Check the report file mqsimigratemsgsets.report.txt that is written to the directory from which you invoked the command. The command provides the following information:
    • The parameters specified when mqsimigratemsgsets was invoked.
    • The name of each message set file (*.mrp file) that has been migrated.
    • Any warnings that have been generated.
    • Details of the objects created.
    • The time taken to process the message set.
    • The number of warnings for the message set.
    • The number of objects created for the message set.
    • The number of exported files processed.
  6. Start the workbench and switch to the Broker Application Development perspective.
  7. You can now examine and manipulate the newly created message set project(s). The created project(s) appear closed in the Broker Application Development perspective and must be opened (right-click the project then click Open Project).

Related concepts
Message sets
Migration

Related tasks
Working with a message set
Generating information from message sets

Related reference
mqsimigratemsgsets command
Message set migration notes