12.16. IBM Websphere MQ が拡張トランザクションクライアントを使用するように設定する

手順12.7 タスク

1. jms-jca-provider 設定の編集

   テキストエディターで jboss-esb.xml ファイルを編集します。jms-jca-provider 設定がどのように拡張トランザクションクライアント設定を検索するかを示します。（この例では、WMQ JNDI 名前空間で設定された XA 接続ファクトリーは WMQXAConnectionFactory と呼ばれます。）
   注記
   インフロー関連の設定（アダプター、<activation-config> など）は、拡張クライアント設定とは関係がないため、意図的に省略されました。

   <jms-jca-provider name="WMQ" connection-factory="WMQXAConnectionFactory"
   	jndi-URL="wmqserver:1414/CHANXA_SEND"
   	jndi-context-factory="com.ibm.mq.jms.context.WMQInitialContextFactory">
   		<property name="max-xa-sessions-per-connection" value="1" />
   			<jms-bus busid="ordersGwChannel">
   			<jms-message-filter dest-type="QUEUE" dest-name="ORDERS" transacted="true"/>
   			</jms-bus>
   				<activation-config>
   					<!--
   					Used by inflow... not relevant to client
   					See section on JMS and JCA.
   					-->
   		</activation-config>
   </jms-jca-provider>
   

2. JMSRouter で使用する設定

   以下の例は、JMSRouter で同じ XA 接続ファクトリーを使用する方法を示しています。

   <action name="routeToORDERSQueue" class="org.jboss.soa.esb.actions.routing.JMSRouter">
   <property name="jndi-context-factory"
   value="com.ibm.mq.jms.context.WMQInitialContextFactory"/>
   <property name="jndi-URL" value="wmqserver:1414/CHANXA_SEND"/>
   <property name="connection-factory" value="WMQXAConnectionFactory"/>
   <property name="jndiName" value="ORDERS"/>
   <property name="max-xa-sessions-per-connection" value="1"/>
   <!-- etc... -->
   </action>
   

   重要
   Websphere MQ と XA に関する重要な点は、同じ Queue Manager Channel でメッセージの取得と配置の両方をサポートしていないことです。このため、XA トランザクションのコンテキストでメッセージを Websphere MQ 宛先に取得または配置するコンポーネントごとに専用チャネルを設定することが推奨されます。
3. jboss-esb.xml の max-xa-sessions-per-connection プロパティーを 1 に設定します。

4. 保存

   ファイルを保存して終了します。
5. Websphere MQ 宛先にメッセージを取得または送信するコンポーネントごとに、専用のキューマネージャーチャネルを設定します。
6. 各 Websphere MQ 宛先の GET および PUT プロパティーが Inhibit に設定されていないことを確認します。（これは、宛先が作成され、MROS がメッセージを取得または送信できない場合に発生します。）