See information about the latest product version
Broker Archive editor
Use the Broker Archive editor to create and manage broker archive (BAR) files.
The Broker Archive editor is available in both the WebSphere® Message Broker Toolkit and the WebSphere Message Broker Explorer. Using this editor, you can add, edit, build, and remove deployable resources to a BAR file. You can also use command-line tools to create BAR files.
Broker Archive editor views
The Broker Archive editor includes these views:
- Prepare view
- The Prepare view displays the options for creating a new broker
archive file. The Prepare view is available only in the WebSphere Message Broker Toolkit. Use the Prepare view to
add and build deployable resources to the BAR file. All available
resources in the current workspace (including Java™, XML and XSL/XSLT files, message flows, message model schema files, and adapters) are included
with each build type. Resources that are identified but that do not
match resources in the workspace are highlighted. You can select the items that you want to include in the broker archive, and use the build options to perform the following tasks:
- Select items to add or remove from the broker archive
- Include source files
- Override the properties of configurable items
The Build options are:- Compile and in-line resources to include message flows as compiled message flow (.cmf) files and include the ESQL code from ESQL files directly in the .cmf files of the compiled message flows that reference it
- Remove contents of Broker Archive before building to remove all existing contents of the broker archive file before building the new broker archive file
- Override configurable properties values to override the existing configurable property values. Check this option to override any value set by the flow compiler, that is, the values from the message flow. If you do not check this option the properties in the broker.xml file are used when compiling a message flow.
- Add workspace project source files to include source files
- Manage and Configure view
- The Manage and Configure view displays the message flows, message model schema files, and other files that
are currently in the BAR file. Use the icons to add, edit, and remove
files from the BAR file. When you select a message flow in the list,
its properties, including configurable properties, are displayed in
the Properties view. You can also expand the message flows to display
the nodes in the message flow. When you select a node the associated
configurable properties are displayed in the Properties view. To edit
a property, replace the current value with a new value.You can filter the content in the Manage and Configure view, by selecting one of the available options from the Filter by list:
- Built resources
- Built resources with source
- Build resources that are configurable
The Manage and Configure view displays information about creating the BAR file by using the mqsipackagebar command. Creating the BAR file by using the mqsipackagebar command is an alternative to creating the BAR file in the WebSphere Message Broker Toolkit. Expand Command for packaging the BAR contents to see a guide to the syntax of the command that you can run to create the same BAR file that you are working with in the Manage and Configure view. To check that the syntax is correct and for more information about creating BAR files by using the mqsipackagebar command, see Creating a broker archive (BAR) file.
- User Log view
- The User view displays the build information for the broker archive user log. Use the User Log view to review or clear the details in the user log of the BAR file.
- Service Log view
- The Service view displays system information for the current build in the broker archive Service log. Use the Service Log view to review or clear the details in the service log of the BAR file.
Broker Archive editor toolbar
The icons on the toolbar in the Manage and Configure page, and their actions are shown in the following table.
Icon | Label | Action |
---|---|---|
![]() |
Build | Builds a broker archive file, making any changes that have been specified |
![]() |
Remove | Removes message flows, message model schema files, or other items from this archive |
![]() |
Edit | Edits selected message flows, message model schema files, or other items in this archive |
![]() |
Add | Adds message flows, message model schema files, or other items to this archive |