This topic contains sections marked as revised for this release

WebSphere Message Brokers
File: an19540_
Writer: Bill Oppenheimer

Reference topic

This build: July 31, 2007 21:33:47

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.
-cleanBuild
(Optional) Refreshes the projects in the workspace and then invokes a clean build before new items are added to the broker archive.
Use the -cleanBuild parameter to refresh all the projects in the broker archive and invoke a clean build if amendments have been made to broker-archive resources using external tools.
-version VersionString
(Optional) Appends the _ (underscore) character and the value of VersionString to the names of the objects added to the bar, before the file extension.
-Esql21
(Optional) Compile ESQL for brokers at Version 2.1 of the product.
-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 or messageSet.mset file to add to the broker archive.

You can add more than one deployable file to this command by using the following format: -o FilePath1 FilePath2 .... FilePath'n'

Authorization

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

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

You must run the command from the eclipse directory. The default location of the eclipse directory on Windows is C:\Program Files\IBM\MessageBrokersToolkit\6.0\eclipse

The following example creates a bar file called myflow.bar in the workspace at C:\Workspace. The Test.msgflow message flow from the TestFlowProject is added to the bar file:
mqsicreatebar -data C:\Workspace -b myflow.bar -p TestFlowProject -o TestFlowProject\TestFlow\Test.msgflow
The following example creates a bar file called mySet.bar in the workspace at C:\Workspace. The messageSet.mset message set from the TestSetProject is added to the bar file:
mqsicreatebar -data C:\Workspace -b mySet.bar -o TestSetProject\TestSet\messageSet.mset
The following example creates a bar file called mySet.bar in the workspace at C:\Workspace. The messageSet.mset message set from the TestSetProject and Test.msgflow message flow from the TestFlowProject are added to the bar file:
mqsicreatebar -data C:\Workspace -b mySet.bar -o TestFlowProject\TestFlow\Test.msgflow
TestSetProject\TestSet\messageSet.mset 
Related concepts
Broker domains
Related tasks
Creating a broker
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:33:47

an19540_ This topic's URL is: