mqsimigratemfmaps command

Use the mqsimigratemfmaps command to create new .msgmap files in the WebSphere® Message Broker Version 6.0 format, based on existing .mfmap from WebSphere Business Integration Message Broker Version 5.0.

Supported platforms

  • Windows®
  • Linux® on x86

Purpose

When the command has completed:

  1. The .mfmap files are left in the workspace, therefore you can run mapping migration again.
  2. The .mfmap files are not included in builds and are not recognized as valid development resources. They are present in the workspace as simple text files and you can delete them at your own discretion. The Version 5.0 map editor is no longer available in Version 6.0; you can view the contents of the .mfmap files only with a text editor.
  3. When the .mfmap files have been migrated, you can edit the .msgmap files in the mapping editor.

The command executable file is located in install_dir/eclipse/.

Syntax

Parameters

-all
(Required) All project names in the workspace are checked and migrated.

You must specify only one of all or p.

-p ProjectName(n)
(Required) The specific project name, or names, in the workspace to be checked and migrated.

You must specify only one of all or p.

-data WorkspacePath
(Required) The path of the workspace in which your projects are created.

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

-log Logfilepath
(Optional) Alternative report file path.

If you do not specify an alternative path, this command generates a detailed migration log in the folder from which you ran the command. The log file has the default name of mqsimigratemfmaps.report.txt. If the file already exists, new information is appended to the existing content.

-o
(Optional) Overwrite files that already exist.

Authorization

No specific authority is required to run this command.

Examples

The following example migrates the sample project in the c:\wmqi\test directory.

mqsimigratemfmaps -p sample -data c:\wmqi\test 

The following example migrates all the mapping definitions that are defined in the project MyFlowProject. The migration process is recorded in the log file c:\temp\migration.log.

mqsimigratemfmaps -p MyFlowProject -data c:\mbtk\workspace -log c:\temp\migration.log

The following example migrates the mappings that you have defined in all the projects in the directory c:\mbtk\workspace. The -log parameter is not specified, therefore the log file mqsimigratemfmaps.report.txt is created in the directory from which the command is started.

mqsimigratemfmaps -all -data c:\mbtk\workspace
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Last updated : 2009-01-07 15:22:39

an26140_