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


Creating a BAR file

Create a separate BAR file for each configuration that you want to deploy to integration servers on your integration nodes.

Before you begin

When you create a BAR file, by default it is created in an integration project called BARfiles. You can choose an alternative location when you use the New BAR file wizard, but you can also customize the default location for the BAR files that you create. For more information, see Customizing the default location of BAR files.

About this task

Creating a BAR file with the IBM Integration Toolkit

About this task

To create a BAR file by using the IBM Integration Toolkit, complete the following steps.

Procedure

  1. Click File > New > BAR file.
  2. Select the location for your BAR file.

    You can select an existing application, library, or integration project, or you can create a new integration project by clicking New.

  3. Enter a name for the BAR file that you are creating.
  4. Click Finish.

Results

A file with a .bar extension is created and is displayed under the application, library, or integration project, in a folder called BARs. The BAR File editor opens. All BAR files are also shown in a separate category in the Application Development view called BARs. Each BAR file that is listed here displays information about the project in which the BAR file is stored.

What to do next

Add files to the BAR file by following the instructions in Adding resources to a BAR file.

Creating a BAR file with the mqsipackagebar command

Before you begin

If you want to use the mqsipackagebar command to create your BAR file, you must compile any message sets or Java™ code before you create the BAR file. For more information, see Packaging resources that include Java code or message sets.

About this task

You can create BAR files on computers that do not have IBM Integration Bus installed by using the mqsipackagebar command. To configure your environment so that you can run the mqsipackagebar command on a computer that does not have IBM Integration Bus installed, see Configuring environments without IBM Integration Bus installed.

When you create BAR files by using the mqsipackagebar command, add deployable resources to ensure that your BAR file can be deployed.

To create a BAR file by using the mqsipackagebar command, complete the following steps:

Procedure

  1. Open a command window that is configured for your environment.
  2. Enter the command, typed on a single line. For example:
    mqsipackagebar -a barName -k applicationNames -v traceFile

    You must specify the -a (BAR file name) parameter. The -k (application names) parameter is optional. You can also use the -o parameter to specify the path for a specific file, the -y parameter to specify a static library, or the -s parameter to specify a shared library. For further details, see mqsipackagebar command.

    To see trace information for BAR file deployment, add the -v parameter.

    A file with a .bar extension is created.

Creating a BAR file with the mqsicreatebar command

About this task

To create a BAR file by using the mqsicreatebar command, complete the following steps.

Procedure

  1. Open a command window that is configured for your environment.
  2. Enter the command, typed on a single line. For example:
    mqsicreatebar -b barName -a applicationNames -trace

    You must specify the -b (BAR file name) parameter. The -a (application names) parameter is optional. You can also use the -o parameter to specify the path for a specific file, or the -l parameter to specify a library. For further details, see mqsicreatebar command.

    If you have changed resources in the BAR file by using external tools, add the -cleanBuild parameter to refresh all the projects and run a clean build.

    To see trace information for BAR file deployment, add the -trace parameter. To force compilation of the BAR file if errors exist in the workspace, add the -skipWSErrorCheck parameter.

    A file with a .bar extension is created.

What to do next

Add files to the BAR file by following the instructions in Adding resources to a BAR file.


af03870_.htm | Last updated 2015-05-28 20:51:07