Using precompiled maps

Configure the TX Map node in your message flow to use a precompiled map.

To use a compiled map:

  1. Switch to the IBM® Integration Development perspective, and open your message flow in the project.
  2. Select a TX Map node, and navigate to the Basic tab of the Properties view.
  3. To select the compiled map when it is located on an external file system, which is on the same machine as where you develop the message flow and where the broker runs:
    1. Select Use external map.
      External maps are compiled outside any projects. They must exist at design time for the map node to determine the number of output cards, and create the output terminals. They would not be transferred to the server because this scenario is using compiled maps that are on the same machine.
    2. Enter the fully qualified path to the compiled map that is located on your local machine in the Local compiled map field, or click Browse [...], select the compiled map from the file system in the Browse Compiled Map dialog, and click OK.
      IBM Integration Toolkit creates one output terminal for each output card in the map on the TX Map node.
      The TX Map node is configured to use the compiled map from an external location.
  4. To select the compiled map when you have a copy of the map in the machine where you are developing the message flow, and have to import it into your workspace project.
    1. Import the map and type trees into your workspace project.
      1. Select File > Import. The Import wizard starts.
      2. Expand the Other folder, select Project Interchange, and click Next.
      3. Navigate to the directory in which your map and type trees are located, select them, and click Open.
      4. Select the check box next to the displayed project, and click Finish. The map and type trees are imported into your workbench project.
    2. Select Use map from project.
    3. Enter the map in the Executable map field, or click Browse [...], select the executable map from the file system in the Select executable map dialog, and click OK.
      This populates the Executable map and Source map edit fields. The source map is read only and is derived from the executable map selection. IBM Integration Toolkit also creates output terminals automatically for each output card of the map on the TX Map node.
      The TX Map node is configured to use the compiled map from your workspace.
  5. To select the compiled map when you do not have a copy of the map in the machine where you are developing the message flow, and the map and broker are both on the same remote machine.
    1. Select Use external map.
      External maps are compiled outside any projects. An external map must exist at design time and be compiled for the correct platform. If the server is a different machine, you must manually transfer the map to the server.
    2. Enter the fully qualified name of the compiled map in the Map Server Location field.
      The TX Map node is configured to use the compiled map from a remote location.
The TX Map node does not use the bar file mechanism to deploy the map. You deploy the map outside of the bar file deployment. You must manually create and build the bar file, without a mar file, and then deploy it to the broker. At run time, IBM Integration Bus finds and runs the compiled map.
If you want to use a different compiled map than the one you specified in the TX Map node, specify it in the LocalEnvironment. At run time, the compiled map specified in the LocalEnvironment overrides the map that you specified in the TX Map node. For more information about the LocalEnvironment, see the specific IBM Integration Bus product documentation.