mqsimigratemsgflows command

Supported platforms

  • Windows
  • Linux (x86 platform)

Purpose

Use the mqsimigratemsgflows command to create new flows in the WebSphere Business Integration Event Broker Version 5.0 format, based on existing exported flows from a WebSphere MQ Event Broker Version 2.1 Configuration Manager.

Note:
  1. This command is for one way migration to the WebSphere Business Integration Event Broker Version 5.0 Message Brokers Toolkit from the previous Version 2.1 release.
  2. Stop your Message Brokers Toolkit session before you invoke the command.
  3. Invoke the command from the Eclipse directory where the default workspace is located, in order for the command to operate on the default workspace.
  4. If the workspace is in a different location, specify the location using the -data flag.
Start of changeIf your path contains spaces, enclose the entire path name in double quotation marks.End of change

Syntax

Parameters

-data WorkspacePath
(Optional) The path of the workspace on which to run the Eclipse platform.

The workspace location is also the default location for projects. Relative paths are interpreted as being relative to the directory from which Eclipse was started.

-p ProjectName
(Required) The project name where the new flows are created. If the project already exists, the flows are added to this project. If the project does not exist, this command creates it.
Note: You must specify the p parameter before the d parameter.
-d DirectoryPath
(Required) The directory path where the exported flows can be found.

A relative path is interpreted from the current working directory. You can specify a full path. All nested directories are ignored.

The flow name becomes the name of the .msgflow file. You can change this name to meet the local file naming conventions.

Duplicate message flows are ignored; any error of this form is reported in the migration report file.

-rm
(Optional) Replace message flow projects if they already exist.
-log <filepath>
(Optional) Report file.

Start of changeIf you do not specify an alternative, this command generates a detailed migration log in the <install_dir>/eclipse/ folder. The log-file has the default name of "mqsimigratemsgflows.report.txt".End of change

For further information on flow migration, see Migrating message flows from Version 2.1.

Authorization

No specific authority is required to invoke this command.

Examples

mqsimigratemsgflows -p sample -d c:\wmqi\test