IBM MQ メッセージング・プロバイダーの使用のための、Liberty への JMS アプリケーションのデプロイ

Liberty 内の IBM MQ メッセージング・プロバイダーにより、Java Message Service (JMS) メッセージング・アプリケーションは、ご使用の IBM MQ システムを Java™ メッセージング・リソースの外部プロバイダーとして使用することができます。

始める前に

JMS を使用するメッセージング・アプリケーションをデプロイする先の Liberty サーバーを必ず作成しておいてください。詳細については、『手動による Liberty サーバーの作成』を参照してください。

このタスクについて

wmqJmsClient-2.0 フィーチャーにより、JMS 2.0 仕様を使用するアプリケーションがサポートされます。

注: wmqJmsClient-2.0 フィーチャーは、JMS 1.1 仕様と JMS 2.0 仕様の両方のフィーチャーをサポートします。ただし、 JMS 1.1 仕様に準拠したフィーチャーのみを使用する場合は、wmqJmsClient-1.1 フィーチャーを使用することを選択できます。

手順

  1. wmqJmsClient-2.0 フィーチャーを server.xml ファイルに追加します。JNDI 検索を実行する場合は、jndi-1.0 フィーチャーも追加する必要があります。
    <featureManager>
         <feature>wmqJmsClient-2.0</feature>
         <feature>jndi-1.0</feature>
    </featureManager>

    wmqJmsClient-2.0 フィーチャーを追加することで、Liberty サーバーは必要な IBM MQ バンドルをロードできるようになり、 これによって、ユーザーが IBM MQ JMS リソースを定義することが可能になります。例えば、接続ファクトリーとアクティベーション・スペックのプロパティーにより、IBM MQ ネットワークに接続するためのクライアント・ライブラリーが提供されます。

  2. server.xml ファイルに以下の項目を追加することによって、IBM MQ リソース・アダプターのロケーションを指定します。
    <variable name="wmqJmsClient.rar.location" value="/path/to/wmq/rar/wmq.jmsra.rar"/>
    ここで、 value 属性は、IBM MQ リソース・アダプター・ファイル wmq.jmsra.rar への絶対パスを指定します。

    サポートされるバージョンの詳細と wmq.jmsra.rar ファイルの入手については、IBM MQ 技術情報 1633761 を参照してください。wmq.jmsra.rar ファイルを入手し、Fix Central からインストールします。

  3. 接続ファクトリーの定義を server.xml ファイルに追加します。
    <jmsConnectionFactory jndiName="jms/wmqCF" connectionManagerRef="ConMgr6">
         <properties.wmqJms 
            transportType="CLIENT"
            hostName="localhost" 
            port="1414"
            channel="SYSTEM.DEF.SVRCONN"
            queueManager="QM1"/>
    </jmsConnectionFactory>
    <connectionManager id="ConMgr6" maxPoolSize="2"/>
    
    <jmsQueue id="jms/queue1" jndiName="jms/wmqQ1">
         <properties.wmqJms 
            baseQueueName="MDBQ" 
            baseQueueManagerName="QM1"/>
        </jmsQueue>
  4. BINDING モードで接続するように JMS アプリケーションを構成します。
    共有メモリーを使用することによって、または BINDING モードで、JMS アプリケーションが IBM MQ に接続できるようにするには、Liberty と IBM MQ の両方を同じサーバーにデプロイする必要があります。JMS アプリケーションが BINDING モードで接続できるようにするには、server.xml ファイル内の nativeLibraryPath エレメントを使用して、IBM MQ ネイティブ・ライブラリーのロケーションを指定してください。
     <wmqJmsClient nativeLibraryPath="/opt/mqm/java/lib64"/>

トピックのタイプを示すアイコン タスク・トピック



タイム・スタンプ・アイコン 最終更新: Monday, 5 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-libcore-mp&topic=twlp_dep_msg_wmq
ファイル名: twlp_dep_msg_wmq.html