mqsimigratemsgsets command

Supported platforms

  • Windows 2000, Windows XP

Purpose

The mqsimigratemsgsets command imports all the files with the extension .mrp in the directory specified by the -d parameter. Files with any other extension are ignored.
Note:
  1. This command is for one way migration to the WebSphere Business Integration Message Broker V5.0 Message Brokers Toolkit from the previous V2.1 release only.
  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 you run the command from another location, specify the -data parameter to correctly specify the target workspace.
  5. If you are importing a very large .mrp file, you might find that the mqsimigratemsgsets command ends with a Java OutOfMemoryException.

    If your -d directory contains several .mrp files, try running the command repeatedly, each time with the -d directory holding a single .mrp file.

    Alternatively you can increase the amount of memory available using the mqsimigratemsgsets argument -vmargs -Xmx<nnn>M, where <nnn> is the number of megabytes of memory. For example:
    
    mqsimigratemsgsets ... -vmargs -Xmx256M

A report file with a default filename of mqsimigratemsgsets.report.txt is produced as a record of the command invocation. You can specify the -log parameter to override the default name and location for the report file; and the -v parameter to add additional information to the report file.

Syntax

Parameters

-d <Directory>
(Required) The directory path, either absolute or relative, containing the .mrp files to import.
-data <workspace>
(Optional) Workspace location.
-rm
(Optional) Replace message set projects if they already exist. If the message set project already exists, a warning message is issued if this parameter is not specified and the .mrp file is ignored.
-g
(Optional) Always create global elements and global complex types.
-log <filename>
Optional) Name and location of the generated report file
-v
(Optional) Instructs the importer to produce a verbose report detailing exactly what was created.
-part
(Optional) Partition the message sets into multiple .MXSD files, if the message set is large enough to warrant partitioning.

For information on what this command creates, and other points that you need to be aware of, see Message set migration notes.

Authorization

No specific authority is required to invoke this command.

Examples

mqsimigratemsgsets -d c:\wmqi\test -v

Related concepts
Message modeling concepts

Related tasks
Migrating a message set

Related reference
Syntax preference
mqsimigratemsgflows command
Message set migration notes