Start of change

Configuring databases for coordinated message flows

If your message flow interacts with a database, and you want to coordinate the updates made to the database with other actions within the message flow, configure your broker to manage these updates.

Before you start:

To complete this task, you must have completed the following task:

To configure databases for coordinated message flows:

  1. Update the broker queue manager information by defining an XAResourceManager stanza for each of the databases that will participate in globally coordinated transactions when updated by message flows on that broker.
    • On Linux (x86 platform) and UNIX, add an XAResourceManager: stanza to the broker queue manager's initialization file qm.ini. The content of this stanza is database specific; see the instructions in the sections that follow.
    • On Windows, define the XAResourceManager using either the WebSphere MQ Explorer or WebSphere MQ Services depending on which version of WebSphere MQ you are using.
      WebSphere MQ Version 6 or later
      1. Open the WebSphere MQ Explorer.
      2. In the Navigator view, right-click the queue manager, then click Properties.... The Properties dialog opens.
      3. On the XA resource managers page, click Add....
      4. Enter the values indicated in the following topics.
      5. Click OK.
      6. Click OK to close the dialog.
      WebSphere MQ Version 5.3.1 or earlier
      1. Open WebSphere MQ Services.
      2. In the left pane, right-click the queue manager, then click Properties from the menu.
      3. In the Resources tab of the Properties dialog, enter the values indicated in the following topics.
    • On z/OS, you do not have to take any specific action, but RRS must be available.
  2. If your message flows reference message dictionaries, or contain Publication nodes, you must also define an XAResourceManager stanza for the broker internal database using the same method.

64-bit or 32-bit coordination

The database drivers that are needed for XA coordination depend on the version of WebSphere MQ that you are using to perform transaction management. If you are using WebSphere MQ V5.3, you can perform XA coordination only in 32-bit mode so you must choose and configure the 32-bit drivers in both your qm.ini and ODBCINI files.

If you are using WebSphere MQ V6, the XA coordination is in 64-bit mode and you must choose and configure the 64-bit drivers in your qm.ini and ODBCINI64 files. If you are using any 32-bit execution groups, you must configure both 64-bit and 32-bit drivers.

Related concepts
Message flows overview
End of change