JMS トランスポート・プロトコル用のハブの構成

WebSphere MQ は、WebSphere Business Integration Connect のインストールの一部としてインストールされています。WebSphere MQ には、JMS 通信を設定できるように JMS インプリメンテーションが組み込まれています。

ただしデフォルトでは、WebSphere MQ は JMS 用に構成されていません。ここでは、JMS を構成するステップについて説明します。

JMS 用のディレクトリーの作成

まず JMS 用のディレクトリーを作成します。例えば、Windows のインストール環境で、c:¥temp ディレクトリー内に JMS という名前のディレクトリーを作成したいとします。これを行うには、以下のステップを実行します。

  1. Windows のエクスプローラーを開きます。
  2. C:¥temp ディレクトリーを開きます。
  3. JMS という名前のフォルダーを新規作成します。

デフォルトの JMS 構成の変更

ここでは、WebSphere MQ のインストールに含まれる JMSAdmin.config ファイルを更新して、コンテキスト・ファクトリーおよびプロバイダー URL を変更します。

  1. WebSphere MQ の Java¥bin ディレクトリーに移動します。例えば、Windows のインストール環境では C:¥IBM¥MQ¥Java¥bin に移動します。
  2. メモ帳や vi などのプレーン・テキスト・エディターを使用して、JMSAdmin.config ファイルを開きます。
  3. 以下の行の前に「#」文字を追加します。
    INITIAL_CONTEXT_FACTORY=com.sun.jndi.ldap.LdapCtxFactory
     PROVIDER_URL=ldap://polaris/o=ibm,c=us
     
  4. 以下の行の前にある「#」文字を削除します。
    #INITIAL_CONTEXT_FACTORY=com.sun.jndi.fscontext.RefFSContextFactory 
     #PROVIDER_URL=file:/C:/JNDI-Directory
     
  5. PROVIDER_URL=file:/C:/JNDI-Directory という行を、JMS 用のディレクトリーの作成で設定した JMS ディレクトリーの名前に変更します。例えば、c:/temp/JMS ディレクトリーを設定する場合は、この行が以下のようになります。
    PROVIDER_URL=file:/c:/temp/JMS
     
  6. ファイルを保存します。

キューおよびチャネルの作成

ここでは、WebSphere MQ を使用して、文書の送受信に使われるキューおよびこの通信のチャネルを作成します。キュー・マネージャーが作成されていることが前提となっています。キュー・マネージャーの名前は、以下のステップの <queue manager name> に入ります。また、このキュー・マネージャーのリスナーが TCP ポート 1414 で開始されていることも前提となっています。

  1. コマンド・プロンプトを開きます。
  2. 以下のコマンドを入力して、WebSphere MQ コマンド・サーバーを開始します。
    strmqcsv <queue manager name> 
     
  3. 以下のコマンドを入力して、WebSphere MQ コマンド環境を開始します。
    runmqsc <queue manager name>
     
  4. 以下のコマンドを入力して、ハブに送信される着信文書を保持するための WebSphere MQ キューを作成します。
    def ql(<queue_name>)
     

    例えば、JMSIN という名前のキューを作成するには、以下のように入力します。

    def ql(JMSIN)
     
  5. 以下のコマンドを入力して、ハブから送信される文書を保持するための WebSphere MQ キューを作成します。
    def ql(<queue_name>)
     

    例えば、JMSOUT という名前のキューを作成するには、以下のように入力します。

    def ql(JMSOUT)
     
  6. 以下のコマンドを入力して、ハブから送受信される文書が使用する WebSphere MQ チャネルを作成します。
    def channel(<channel_name>) CHLTYPE(SVRCONN)
     

    例えば、java.channel という名前のチャネルを作成するには、以下のように入力します。

    def channel(java.channel) CHLTYPE(SVRCONN)
     
  7. 以下のコマンドを入力して、WebSphere MQ コマンド環境を終了します。
    end 
     

現行環境への Java ランタイムの追加

現行のシステム・パスに Java ランタイムを追加するには、以下のコマンドを入力します。

set PATH=%PATH%;<path to installation directory>¥_jvm¥jre¥bin 
 

ここで、installation directory は、WebSphere Business Integration Connect がインストールされているディレクトリーを表します。

JMS 構成の定義

JMS 構成を定義するには、以下のステップを実行します。

  1. WebSphere MQ Java ディレクトリー (<path to Websphere MQ installation directory>¥java¥bin) に移動します。
  2. 以下のコマンドを入力して、JMSAdmin アプリケーションを始動します。
    JMSAdmin
     
  3. InitCtx> プロンプトから以下のコマンドを入力して、新規 JMS コンテキストを定義します。
    define ctx(jms) 
     

    change ctx(jms) 
     
  4. InitCtx/jms> プロンプトから以下の JMS 構成を入力します。
    define qcf(WBICHub) 
         tran(CLIENT) 
         host(<your_IP_address>) 
         port(1414) 
         chan(java.channel) 
         qmgr(<queue manager name>)
     

    define q(<name>) queue(<queue name>) qmgr(<queue manager name>)
     

    define q(<name>) queue(<queue name>) qmgr(<queue manager name>)
     

    end 
     

以下の例は、MQ キュー・マネージャーがある sample.ibm.com の IP アドレスを指定して、WBICHub としてキュー接続ファクトリーを定義するために使用する JMSAdmin セッションです (<queue manager name> は sample.queue.manager)。この例では、キューおよびチャネルの作成で作成した JMS キュー名およびチャネル名が使用されています。ユーザー入力は、> プロンプトの後に行います。

InitCtx> define ctx(jms)
 InitCtx> change ctx(jms) 
 InitCtx/jms> define qcf(WBICHub) 
     tran(CLIENT) 
     host(sample.ibm.com) 
     port(1414) 
     chan(java.channel) 
     qmgr(sample.queue.manager) 
 InitCtx/jms> define q(inQ) queue(JMSIN) qmgr(sample.queue.manager) 
 InitCtx/jms> define q(outQ) queue(JMSOUT) qmgr(sample.queue.manager) 
 InitCtx/jms>end 
 

Copyright IBM Corp. 1997, 2004