BAR file editor

Use the BAR file editor to create and manage BAR files.

The BAR file editor is available in the IBM® Integration Toolkit. By 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.

BAR file editor views

The BAR editor includes these views:

Prepare view
The Prepare view displays the options for creating a new BAR 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 BAR files, and use the build options to perform the following tasks:
  • Select items to add or remove from the BAR file.
  • 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 BAR before building to remove all existing contents of the BAR file before building the new BAR 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 BAR file.

User Log view
The User view displays the build information for the BAR file 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 BAR file service log. Use the Service Log view to review or clear the details in the service log of the BAR file.