提供されているサンプルのインプリメント

WebSphere Business Integration Message Broker には、 ユーザー定義ノードとパーサーを作成する方法を理解するのに役立ついくつかのサンプル・コードが備えられています。 サンプルは、サンプル・パーサーと以下のサンプル・ノードからなっています。

Switch C および Java の両方のバージョンでインプリメントされるノードで、 入力メッセージを、そのメッセージ内容に応じて、いくつかの出力ターミナルのうちの 1 つに伝搬します。
Transform C および Java の両方のバージョンでインプリメントされるノードで、 単純なメッセージの変換を実行します。

個々のサンプル・ノードは、ソース・ファイルと、 個々のノードのテストに使用できるファイルで構成されます。 サンプル・パーサーの場合は、ソース・ファイルのみ含まれます。 サンプル・ファイルとそれらの場所について詳しくは、 サンプル・ノード・ファイルと、 サンプル・パーサー・ファイルを参照してください。

提供されているサンプルをインプリメントするには、次のようにします。
  1. サンプルをコンパイルします。 Java ノードのコンパイル方法については、 Java ユーザー定義ノードのコンパイルを参照してください。 C ノードまたはパーサーのコンパイル方法については、 C ユーザー定義拡張機能のコンパイルを参照してください。
  2. 関係するディレクトリーにファイルをコピーします。

    Windows では、Java ノードの場合、.jar ファイルを install_dir/jplugin ディレクトリーにコピーします。C ノードまたはパーサーの場合は、 .lil ファイルを install_dir\bin ディレクトリーにコピーします。

    UNIX では、Java ノードの場合、.jar ファイルを install_dir/jplugin ディレクトリーにコピーします。C ノードまたはパーサーの場合は、 .lil ファイルを install_dir/bin ディレクトリーにコピーします。

    z/OS では、Java ノードの場合、.jar ファイルを install_dir/jplugin ディレクトリーにコピーします。C ノードまたはパーサーの場合は、 .lil ファイルを install_dir/bin ディレクトリーにコピーします。

  3. mqsistop コマンドを使用してブローカーを停止してから、 mqsistart コマンドを使用してブローカーを再始動して新しいファイルを読み取ります。

    ユーザー定義パーサーをインプリメントするために実行すべき事柄は、これですべてです。 以下の追加のステップは、ユーザー定義ノードにのみ該当します。

  4. ワークベンチ をホスティングしている Windows マシン上で SampleNodesProject.zip ファイルを解凍して、結果のディレクトリー構造を install_dir\eclipse\plugins ディレクトリーにコピーします。
  5. ワークベンチを開き、「ブローカー・アプリケーション開発 (Broker Application Development)」パースペクティブ に切り替えます。 パレットで「サンプル・ノード (Sample nodes)」というカテゴリーが見えるようになり、 その下にサンプル・ノードが表示されます。 さらに、サンプル・ノードに関する説明が、 ヘルプ・システムの中の「サンプル (Samples)」の下に表示されます。
  6. メッセージ・フローにサンプル・ノードを組み込みます (ノードの追加を参照)。
  7. メッセージ・フローをデプロイします (メッセージ・フロー・アプリケーションのデプロイを参照)。
  8. Switch ノートと Transform ノードの場合は、 次のようにして、メッセージ・フローの入力キューにメッセージを書き込み、 結果を観察することができます。
    1. サンプル・ノードを含んだメッセージ・フローが正常にデプロイされていることを確認します (デプロイメントの結果の検査を参照)。
    2. メッセージのエンキュー機能を使用して、 サンプル入力メッセージ (先述の .xml ファイル) を、 メッセージ・フローの入力ノードで指定された入力キューに書き込みます (テスト・メッセージの書き込みを参照)。
    Trace ノードや Flow デバッガーを使用して、 メッセージ・フローで起きている事柄を表示することもできます。

関連概念
ユーザー定義拡張機能

関連タスク
ノードの追加
メッセージ・フロー・アプリケーションのテストとデバッグ
ユーザー定義拡張機能の開発
Java ユーザー定義ノードのコンパイル
C ユーザー定義拡張機能のコンパイル
デプロイメントの結果の検査
エラーの診断

関連資料
Trace ノード
ユーザー定義拡張機能