[AIX Solaris HP-UX Linux Windows][IBM i]

Sharing connections to benefit from one-phase commit optimization

In some circumstances, you can configure your JMS application to share the JDBC connection that a messaging engine uses. Sharing connections enables you to use one-phase commit optimization. This can improve the performance of your application.

About this task

Messaging engines store persistent data in a database, and use a JDBC data source to interact with that database. Some JMS applications also store persistent data in a database, for example if the application uses entity enterprise beans. Typically, such applications use two-phase commit transactions to coordinate updates to the JMS and JDBC resources involved.
You can configure your application to share the JDBC connection used by a messaging engine, which enables you to use one-phase commit transactions and improve the performance of your application. You can benefit from the one-phase commit optimization in the following circumstances:
  • Your application must use the assured persistent reliability attribute for its JMS messages.
  • Your application must use container-managed persistence (CMP) entity beans that are bound to the same JDBC data source that the messaging engine uses for its data store.
Restriction: You cannot benefit from the one-phase commit optimization in the following circumstances:
  • If your application uses a reliability attribute other than assured persistent for its JMS messages.
  • If your application uses BMP entity beans, or JDBC clients.
  • If your application uses DB2® High Availability Disaster Recovery (HADR).

Before you configure your system, ensure that you consider all of the components of your Java EE application that might be affected by one-phase commits.

Procedure

  1. Select the assured persistent reliability attribute for your JMS messages.
  2. Deploy all CMP enterprise beans involved in one-phase commit transactions with res-auth set to Container.
  3. Deploy all CMP enterprise beans involved in one-phase commit transactions where AccessIntent maps to a transaction isolation level of JDBC Read Committed.
    You can choose any of the following values for AccessIntent:
    • WSOptimisticUpdate
    • WSOptimisticRead
    • WSPessimisticUpdate-NoCollisions
    Oracle tip: All values for AccessIntent, except WSPessimisticUpdateExclusive, map to the JDBC Read Committed transaction isolation level.
    DB2 tip: You can use any value for AccessIntent, because WebSphere® Application Server exploits the DB2 dynamic transaction isolation level support.
  4. Ensure that you use the same authentication alias for both your CMP enterprise beans and the messaging engine data store.
  5. When you configure your JDBC data source, ensure that you select the Use data source for CMP beans option.
  6. Set the value of the JDBC data source custom property jmsOnePhaseOptimization to true.
  7. Use the JMS connection factory or activation specification panels to select the Share data source with CMP option.
  8. When you create your JDBC provider and set the Select the implementation type field, ensure that you select Connection pool data source (and not XA data source).