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.

Although you do not have to use a repository, if you do use a repository to store your message flows and dictionaries, you can write scripts to deploy the message flow applications using the mqsicreatebar command and the repository's command line tools.

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 versionString to the names of the objects added to the bar, before the file extension.
-p projectName
(Optional) Projects containing files to include in the bar file. You can specify multiple projects, which can include a message flow project, a message set project, or a message flow plug-in node project.

If a project that you specify is not currently part of your workspace, the command links the project to the workspace so that the files in the project can be included in the bar file. The command does not copy the files into your workspace directory.

If a project that you specify is part of your workspace but is currently closed, the command opens and builds the project so that the files in the project can be included in the bar file.

-o filePath
(Required) The workspace relative path (including the project) of a msgflow file to add to the broker archive.

Start of changeYou can add more than one deployable file to this command by using the following format: -o filePath1 filePath2 .... filePath'n'End of change

Authorization

Start of changeOn Windows, the user ID used to invoke this command must have Administrator authority on the local system. On Linux, your user ID must have write access to the -data (workspace) and -b (bar file location) directories.End of change

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 on Windows from the product installation eclipse folder (the default location of the eclipse folder on Windows is C:\Program Files\IBM\MessageBrokersToolkit\6.0\eclipse) and you 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