BAR file contents

The BAR file is a compressed file to which you can add a number of deployable resources.

When you select resources to add to the BAR file, the following files are added for each resource type:
Applications
A .appzip file for each application.

The .appzip file contains all resources that belong to the application, such as .msgflow, .cmf, .esql, .map, .xsd, and any message set .dictionary and .xsdzip files. If an application refers to one or more libraries, .libzip or .shlibzip files for the referenced libraries are also added to the BAR file.

Static libraries
A .libzip file for each static library.

This file contains all resources that belong to the static library, such as .msgflow, .cmf, .esql, .map, .xsd, and any message set .dictionary and .xsdzip files. If a static library refers to other static libraries, .libzip files for the referenced libraries are also added to the BAR file.

Shared libraries
A .shlibzip file for each shared library.

This file contains all resources that belong to the shared library, such as .cmf, .esql, .map, .xsd, and any message set .dictionary and .xsdzip files. If a shared library refers to other shared libraries, .shlibzip files for the referenced libraries are also added to the BAR file.

Message flows
  • If you select Compile and in-line resources in the BAR File editor, a .cmf file is added to the BAR file for each message flow. This file is a compiled version of the message flow.
    The following limitations apply when you are testing compiled message flows:
    • You cannot use the Flow Exerciser with compiled message flows.
    • The flow diagram that is shown in the web user interface does not match how the flow is shown in the IBM® App Connect Enterprise Toolkit.
    • Monitoring events and statistics records do not match the points in the original flow diagram.
  • If you do not select Compile and in-line resources in the BAR File editor, a .msgflow file is added to the BAR file for each message flow. This file contains a definition for the message flow. This file is not compiled.
You cannot add the same message flow to a BAR file as both a .cmf file and a .msgflow file. If your flow contains one of the following nodes, you cannot add the flow as a .msgflow file:
  • A user-defined node that is created from a subflow
  • A subflow node that represents a subflow that is defined in a .msgflow file
  • A WebSphere® Message Broker Version 7.0 Mapping node
Subflows
A .subflow file for each subflow that is contained in an integration project. This file is not compiled.

Subflows that are defined in .msgflow files are not displayed in the BAR file as separate items, and are added to the BAR file automatically when the BAR file is built. To include these subflows, you must add only the parent flow. Subflows that are defined in .subflow files are displayed in the BAR file as separate items and can be deployed as individual resources.

.NET assemblies
A .appdomainzip file for each AppDomain that contains .NET assemblies that are used by a message flow in the BAR file.

.NET assemblies that are required by .NETCompute nodes in message flows are added to the BAR file from your integration project automatically when you add the message flow.

Message set dictionaries
A .dictionary file for each message set dictionary.

DFDL, XML schema, or WSDL files
The following files are added:
  • A .xsd file for each DFDL or XML schema file that is defined in an application or library.
  • XSD compressed files (.xsdzip) for each XML schema and WSDL that is defined in a message set.
XML files, stylesheets, and XSLT files
XML files (.xml), stylesheets (.xsl), and XSLT files (.xslt), if required by nodes in the message flows that you added to this BAR file. For example, the XSLTransform node might require these files.

XML and XSL files are added to the BAR file automatically if they are required by the flow

JAR files
JAR files (.jar), if required by JavaCompute nodes in the message flows that you added to this BAR file.

JAR files that are required by JavaCompute nodes in message flows are added to the BAR file from your Java™ project or integration project automatically when you add the message flow.

JAR files that are available to the integration server include JAR files that you deployed and JAR files that exist in the classes directories in the installation directory. For example, the files IntegrationAPI.jar, jplugin2.jar, and javacompute.jar are always visible to the integration server, and do not have to be deployed separately.

WebSphere Adapter files
Inbound or outbound adapter files (.inadapter or .outadapter), if required by WebSphere Adapter nodes (for example, the SiebelInput node) in the message flows that you added to this BAR file.
ESQL files
  • If you select Compile and in-line resources in the BAR File editor, ESQL code is embedded in the .cmf file that references it.
  • If you do not select Compile and in-line resources in the BAR File editor, ESQL files (.esql) are added to the BAR file as individual resources.

If your BAR file contains a mixture of resources that are compiled and resources that are not compiled, you might see unexpected results. For example, if you select the Compile and in-line resources option to create a BAR file that contains an ESQL file and a message flow, the ESQL is embedded in the compiled message flow (.cmf) file. If you then update the ESQL and add it to the BAR file with the Compile and in-line resources option cleared, the ESQL file is added as an individual resource, but the .cmf file uses the original ESQL because the original ESQL remains embedded in the .cmf file. To ensure that all your resources are either compiled or not compiled, when you change the Compile and in-line resources option, also select Remove contents of BAR before building, and rebuild the BAR file.

Graphical maps
A .map file for each graphical data mapping routine.
Policies
A .policyxml file for each policy.

The .policyxml file contains a list of property values that override, at run time, properties that are set on deployed message flows, message flow nodes, or the integration server.

Other files that you might want to associate with this BAR file
You might want to include Java source files, .msgflow files, or .wsdl files for future reference. BAR files can contain all files types. If you choose to include source files in the BAR file, source projects for all applications, libraries, and other compiled resources are added to the src folder of the BAR file.