Setting up the Error Handler sample

When you have imported the Error Handler sample, you must configure the sample to use transactionality before you can deploy the sample to the integration node.

Complete the following tasks to set up the Error Handler sample to use transactionality:

  1. Stop the integration node.

    1. On Windows: Start a command console in which you can run IBM Integration Bus commands.

      On Linux: Run the mqsiprofile command in a terminal window.

    2. Enter the following command on the command line to stop your integration node, where IB9NODE is the name of your integration node: 

      mqsistop IB9NODE
  2. Configure the database for transactionality.

    Follow the instructions relevant to your database manager, see Configuring databases for global coordination of transactions in the IBM Integration Bus documentation.

  3. Configure WebSphere MQ for transactionality.

    Define the STAFFDB database as an XA resource manager to the queue manager for the integration node. The queue manager acts as the transaction manager. The integration node is IB9NODE, the queue manager is IB9QMGR, and the data source name is STAFFDB.

    Follow the instructions relevant to your database manager, see Configuring global coordination of transactions in the IBM Integration Bus documentation.

  4. Restart your integration node.

    1. On Windows: Start the command console in which you can run IBM Integration Bus commands.

      On Linux: Run the mqsiprofile command in a terminal window.

    2. Enter the following command on the command line to start your integration node, where IB9NODE is the name of your integration node:

      mqsistart IB9NODE
  5. Deploy the sample to the integration node.
    1. In the IBM Integration Toolkit, switch to the Integration Development perspective.
    2. Create a new broker archive (BAR) file and add Main_Flow.msgflow to the BAR file:
      1. In the Application Development view, click File > New > BAR File. The New BAR file wizard opens.
      2. In the New BAR file wizard, select the Error Handler Message Flows project and enter a name for the BAR file, click Finish. The new BAR file is created and opens in the Broker Archive editor.
      3. In the Broker Archive editor, select the Message Flows project check box. The Main_Flow.msgflow check box is automatically selected.
      4. Click Build broker archive, click OK. The Main_Flow.msgflow file is added to the BAR file.
    3. Configure the message flow to run as a coordinated transaction:
      1. To switch to the Manage page, click the Manage tab at the bottom of the Broker Archive editor window.
      2. Right-click Main_Flow.cmf.
      3. The configurable properties of Main_Flow.cmf are displayed in the Properties view.
      4. Select the Coordinated Transaction check box.
    4. Press Ctrl+S to save the BAR file.
    5. Ensure that the IBM Integration Toolkit is connected to the integration node IB9NODE.
    6. Create a new integration server called ErrorHandler:
      1. In the Application view, right-click the integration node IB9NODE, click New > Integration Server.
      2. In the New Integration Server window enter ErrorHandler.
      3. Click OK to add the integration server to the integration node.
    7. Deploy the BAR file:
      1. In the Application Development view, right-click the BAR file that you created, click Deploy File.
      2. In the "Deploy a BAR File" window, click the ErrorHandler integration server,
      3. Click OK, the Main_Flow.msgflow file is deployed to the integration node.

You can now run the Error Handler sample. See Running the sample.

Back to sample home