Configuring an environment for developing and running custom integration applications

Prepare the environment in which you want to run your custom integration applications.

Before you begin

To develop and run Java™ applications that use the IBM® Integration API, you must install the following prerequisite software in your local computer environment:
  • An IBM Java Development Kit (JDK) at a supported Java level. Java support is defined in the IBM Integration Bus system requirements; see IBM Integration Bus system requirements.

    IBM Integration Bus does not supply a JDK; you must acquire and install a suitable product yourself.

    You must use an IBM JDK to develop custom integration applications and an IBM Java Runtime Environment (JRE) to run these applications.

About this task

To set up your computer in preparation for building and running custom integration applications, you must configure your class path environment variable so that it includes the IntegrationNodeConnectionParameters classes for Java, and the JAR file that defines the IBM Integration API.
Follow the instructions for the appropriate environment:

You can also run custom integration applications, and therefore control one or more integration node components, from computers on which you have not installed IBM Integration Bus. For more information, see Configuring environments without IBM Integration Bus installed.

The JAR file IntegrationAPI.jar contains the English message catalog for displaying integration node (BIP) messages from the Administration log of the integration node. If you want a custom integration application to display integration node messages in a language other than English, you must also add the directory that contains the localized message catalogs to your class path; for example, C:\Program Files\IBM\IIB\10.0.0.n\server\messages on Windows operating systems. The default directory includes the version, release, modification, and fix of the product, in the format v.r.m.f (version.release.modification.fix).

You can also use the IBM Integration API to display or log messages from a catalog that you create yourself.