JMS ノードのサンプルのセットアップ

このサンプルでは、WebSphere MQ を JMS プロバイダーとして使用するので、JMSAdmin ツールを使用して管理対象オブジェクトを作成する必要があります。

始める前に:

サンプルを Linux 上で実行する場合、以下の手順を実行する必要があります。

  1. 以下のファイルをクラスパスに追加することにより、クラスパスに JMSAdmin クラスを追加します。
    >mq_install_directory</java/lib/com.ibm.mqjms.jar
  2. 以下のコードをクラスパスに含めることにより、PATH 変数に Java の場所を追加します。
    >JAVA_HOME</bin

JMSAdmin の使用による管理対象オブジェクトの作成

以下の手順では、WebSphere MQ が mq_install_dir のディレクトリーにインストールされていることを想定しています。 JMSAdmin ツールと JMSAdmin 構成ファイルは、以下の場所にあります。

JMSAdmin ツールを使用するには、その前に JMSAdmin.config ファイルに変更を加えることが必要な場合があります。

JMSAdmin.config ファイルの妥当性検査と変更

  1. テキスト・エディターで JMSAdmin.config ファイルを開きます。
  2. 必要ではないオプションをコメント化するには、番号記号 (#) を追加します。 オプションのコメントを外す場合は、番号記号 (#) を削除してください。
    #  The following line specifies which JNDI service provider is in use.
    #  It currently indicates a File System Context. If a different
    #  service provider is used, this line must be commented out, and the
    #  appropriate one must be uncommented.
    #
    #  com.sun.jndi.fscontext.RefFSContextFactory is the FileSystem JNDI Context
    #
    #INITIAL_CONTEXT_FACTORY=com.sun.jndi.ldap.LdapCtxFactory
    INITIAL_CONTEXT_FACTORY=com.sun.jndi.fscontext.RefFSContextFactory
    #INITIAL_CONTEXT_FACTORY=com.ibm.ejs.ns.jndi.CNInitialContextFactory
    #INITIAL_CONTEXT_FACTORY=com.ibm.websphere.naming.WsnInitialContextFactory
    #
    #  The following line specifies the URL of the service provider's initial
    #  context. It currently refers to an File System Context. Examples of a
    #  LDAP root context URL and WebSphere's JNDI namespace are also shown, commented
    #  out.
    #
    #  PROVIDER_URL needs changing to, e.g. file:///home/user/JNDI-Directory
    #  on Unix platforms. The 'JNDI-Directory' folder needs to be created in the
    #  location specified.
    #
    #PROVIDER_URL=ldap://localhost/o=ibm,c=us
    PROVIDER_URL=file:/C:/JNDI-Directory
    #PROVIDER_URL=iiop://localhost/	
    
  3. PROVIDER_URL が /C:/JNDI-Directory (Linux の場合はこれに相当する場所) に設定されていること、また INITIAL_CONTEXT_FACTORY が com.sun.jndi.fscontext.RefFSContextFactory に設定されていることを確認します。
  4. 何らかの変更を加えた場合は、ファイルを保存します。
  5. PROVIDER_URL ディレクトリーがまだ存在しない場合、それを作成します。

これで、オブジェクトを作成できます。

オブジェクトの作成

サンプルで使用する JMS 接続ファクトリーと宛先を構成するには、WebSphere MQ JMSAdmin ツールを実行して JNDI 管理対象オブジェクトを作成します。

JMSSampleObjects.defs ファイルを入力として使用して JMSAdmin ツールを実行することにより、オブジェクトを作成します。

ブローカーで使用するポートが 2414 でない場合は、JMSSampleObjects.defs の中でポートの設定値を編集します。

コマンド行に、以下のコマンドを入力します。

mq_install_dir は、WebSphere MQ がインストールされている場所であり、workspace_path は、WebSphere Message Broker Toolkit ワークスペース・ディレクトリーの絶対パスです。

それらのオブジェクトと .bindings ファイルが作成されます。

次に、JNDI オブジェクトおよび MQInput ノード属性を以下のようにして変更します。

  1. JMSAdmin ツールを開始するには、次のコマンドを入力します。

    WebSphere MQ がインストールされる場所は mq_install_dir になります。

  2. コマンド行で以下のコマンドを入力し、この JNDI オブジェクトを変更します。
    alter q(publishqueue) queue(PUBLISHQUEUE)
  3. JMSAdmin セッションを終了するには、次のコマンドを入力します。
    end

メッセージ・フロー内の JNDI パスの構成

作成したばかりの .bindings ファイルの場所を、メッセージ・フロー内の JMS ノードに通知する必要があります。

JMS ノードで .bindings ファイルの位置を構成するには、次のようにします。

  1. 「ブローカー開発」ビューで、JMS ノードのサンプル・フロー・プロジェクトの中のファイル JMSGateway.msgflow をダブルクリックします。 このアクションにより、メッセージ・フロー・エディターが表示されます。 そこで、JMSGateway メッセージ・フローを編集することができます。
  2. メッセージ・フロー内の JMSOutput ノードを右クリックし、「プロパティー」をクリックして「プロパティー」ビューを表示します。
  3. 「プロパティー」 ペインで、「JMS 接続」 タブを選択します。
  4. 「ロケーション JNDI バインディング」フィールドに表示されている値が、JMSAdmin.config ファイルの中の PROVIDER_URL の行で指定されているパスと一致していることを確認してください。 これらの 2 つの値が同じでない場合、メッセージ・フローは動作しません。
  5. メッセージ・フローを保存します。
  6. メッセージ・フロー・エディターで JMSInput_Publication メッセージ・フローを開き、上記の手順に従って JMSInput ノードで .bindings ファイルの位置を構成します。

これでメッセージ・フローが構成され、ブローカーにデプロイする準備ができました。

BAR ファイルの作成およびメッセージ・フローのデプロイ

JMSGateway および JMSInput_Publication フローをデプロイするために、両方のメッセージ・フローが入ったブローカー・アーカイブ (BAR) ファイルを作成します。

BAR ファイルを作成するには、次のようにします。

  1. 「ブローカー開発」ビューの中を右クリックして、「新規」>「BAR ファイル」をクリックします。
  2. 「JMSNodesSampleFlow プロジェクト」を選択し、BAR ファイルの名前を入力します。
  3. 「終了」をクリックします。「準備」という見出しのペインが表示されます。 このペインには、ブローカー・アーカイブ・ファイルの新規作成用のさまざまなオプションが表示されます。
  4. 両方のフローを BAR ファイルに追加してから、オプションを保存します (Ctrl+S)。
  5. ここで、「ブローカー・アーカイブのビルド」ボタンをクリックすることにより、BAR ファイルをビルドします。 作成した BAR ファイルが、「ブローカー開発」ビューの中で JMSNodesSampleFlowProject の BAR フォルダーの中に表示されます。
  6. BAR ファイルをクリックし、それを「ブローカー」ビュー内のデフォルト実行グループまでドラッグします。 この操作により、フローがブローカーにデプロイされます。

これで、サンプルを実行する準備ができたことになります。

サンプルのホームに戻る