mqsicreatemsgdefs command

Supported platforms

  • Windows
  • Linux (x86 platform)

Purpose

The mqsicreatemsgdefs command takes as a parameter a directory where source files of various types, for example, C and COBOL, are located (in addition to various other parameters) and invokes the appropriate operation based on the extensions to the files.

The command then generates message definition files (*.mxsd), according to a set of import options specified in an option file. The generated files are placed in the specified message set folder.

Note:
  1. Ensure that only the files that are required for the command to run exist in the directory and subdirectory structure you specify. One of the actions the mqsicreatemsgdefs command performs is to copy all the files in the directory and subdirectories into the workspace prior to creating the message definition. This could include any files not associated to the message definitions you are trying to create.
  2. You must specify the -dataworkspace parameter to specify the target workspace.

Syntax

Parameters

-p message set project name
(Required) The name of the message set project. If the project does not exist, a new one is created.
-d pathname of source files folder
(Required) The absolute or relative pathname of the directory of definition files (source files).

All relevant files located in any subfolders under the source files folder are scanned and imported.

-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.

-base
(Optional) If a new message set is to be created, this is the existing message set project and message set, on which it is based.
-rmp
(Optional) Replaces the existing project of the same name.
-rmd
(Optional) Replaces an existing message definition file of the same name.
Note:
  1. If this flag is omitted, and a message definition file of the same name exists, you receive a warning.
  2. The location of the generated message definition file in the message set is determined by the target namespace.
-ns
(Optional) If a new message set is to be created, the message set is enabled for namespace support
-msg
(Optional) Creates messages from complex global elements
-opt xxx.xml
(Optional) The absolute or relative pathname of the options file:
C language
C options file
COBOL language
COBOL options file
XSD_NO_NS
XSD options file
If you do not specify a specific option, the default options file called mqsicreatemsgdefs.xml is used; see Default options file.
Note: If you use the default options file, take a copy and customize the copy.
-v
(Optional) Verbose report.
-log report file pathname
(Optional) Absolute or relative pathname of the report file. If omitted, the report is written to the default log file named mqsicreatemsgdefs.report.txt in the Eclipse current directory.
Note: If -log is specified without the report file pathname or an invalid pathname, the command issues an error message and stops.

Examples

mqsicreatemsgdefs -p <newproject> -d <c:\myproject\source>
   -rmp -rmd
Related concepts
Message definition files