mqsicreatebar command

Supported platforms

  • Windows
  • Linux (x86 platform)

Purpose

The mqsicreatebar command provides a command line compiler that creates deployable broker archive files containing message flows and dictionaries.

Together with the command line repository tools, this enables you to write scripts to repeatedly deploy. Although you are recommended not to perform team development without a repository, a repository is not required.

You can share files using the file system, or using the Eclipse File>Import... and File>Export... capabilities.

Syntax

Parameters

-data workspace
(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.

-b barName
(Required) The name of the bar (zip format) archive file where the result is stored. The bar is replaced if it already exists and the META-INF/broker.xml file is created.
-version versionString
(Optional) Append the _ (underscore) character and the value of the versionString to the names of the objects added to the bar, before the file extension.
-p projectName
(Optional) Projects containing files to link. You can specify multiple projects that can be a message flow project, a message set project, or a message flow plug-in node project.

This option allows you to use the command line tool to open existing or closed projects. The specified project is fully built and added to the workspace used to compile the bar file.

-o filePath
(Required) The workspace relative path (including the project) of a msgflow file to add to the broker archive.
The file can be in a message flow project or a message flow plug-in node project.
Note: msgflow is the extension of the message flow file that, for example, you can call myFlow.msgflow.

You can add more than one deployable file to this command by using the following format -o filePath1 -o filePath2 .... -o filePath'n'

Authorization

The user ID used to invoke this command must have Administrator authority on the local system.

Responses

This command returns the following responses:
  • BIP0956 Unable to start mqsicreatebar
  • BIP0957 Incorrect arguments supplied to mqsicreatebar
  • BIP0958 Nothing to do in mqsicreatebar
  • BIP0959 Incorrect arguments supplied to mqsicreatebar (Project name)
  • BIP0960 Incorrect arguments supplied to mqsicreatebar (Project directory)
  • BIP0961 Error opening workspace in mqsicreatebar (Project could not be created)
  • BIP0962 Error opening workspace in mqsicreatebar (Project could not be opened)
  • BIP0963 Error saving file in mqsicreatebar
  • BIP0964 Incorrect "-o" argument supplied to mqsicreatebar
  • BIP0965 Error compiling files in mqsicreatebar

Examples

The following example assumes that you are working from the product installation Eclipse folder and have a workspace in the folder C:\Workspace:
mqsicreatebar -data C:\Workspace -b myflow.bar -p TestFlowProject -o TestFlowProject\TestFlow\Test.msgflow
Related concepts
Broker domains
Related tasks
Creating a broker