Running on a WebSphere DataPower SOA Appliance

About this task

When you run a DataPower map, the compiled map, and input files are attached to a request message that is sent to the WebSphere DataPower SOA Appliance. All RUN maps referenced by the DataPower map that is run on the appliance, must be in the specified RUN map URL paths. RUN maps are not packaged and sent to the appliance in the request message for the Interoperability Test Service. After processing completes, a response message is returned with the output and audit log files.

If you built a map to be run on a WebSphere DataPower SOA Appliance, to test it from the Map Designer, the Interoperability Test Service must be running on the appliance.

To run a DataPower map on a WebSphere DataPower SOA Appliance:


  1. In the Outline view or Composition view, select the map and do one of the following choices:
    • On the Map menu, click Run.
    • On the toolbar, click the Run icon.
    • Right-click the map and on the menu, click Run.

    If you configured the Interoperability Test Service using HTTPS in the Map Designer, after you click Run to test the DataPower map, you are prompted through a standard Certificate window to dynamically select the option to trust the certificate from the appliance, and add it to the certificate store.

  2. Click Cancel to close the IBM DataPower SOA Appliances window.
  3. To view results, right-click the map and click Run Results on the menu. The Run Results window opens.
  4. Select the items you want to view and click OK. The results are displayed.


The IBM DataPower SOA Appliances window opens and displays the executable map name, host and port information, status, and elapsed time. These statistics indicate the progress of the map run while the data is being mapped. After the mapping process completes, the outputs are saved as specified in the settings of the output cards, and the map audit log file is saved as specified in the map settings.

What to do next

When you completed testing your maps so that they run without errors and are ready for production, there are additional tasks to complete. You can deploy the maps to the production environment using the Deploy to DataPower option in the menu of the selected maps. For information about running maps in a production environment, see the IBM DataPower SOA Appliances: Integrating with Transformation Extender documentation that is published on the IBM WebSphere DataPower Support website.