IBM Integration Bus, Version 9.0.0.8 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

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 IBM® Integration Toolkit and the IBM Integration 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 IBM Integration 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
To display resources with specific names, type a filter string in the Filter by field. For example, to display all resources that contain SWIFT in the name, type SWIFT into the Filter by field.

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 IBM Integration 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
Refresh Build Builds a broker archive file, making any changes that have been specified
Remove Remove Removes message flows, message model schema files, or other items from this archive
Edit Edit Edits selected message flows, message model schema files, or other items in this archive
Add Add Adds message flows, message model schema files, or other items to this archive

af14700_.htm | Last updated Friday, 21 July 2017