始める前に
ユーザー定義ノードは、WebSphere Message Broker C または Java プラグイン・インターフェースを使用して作成できます。 それらは、サポート・パックとして、または第三者ベンダーにより供給することもできます。
ユーザー定義ノード・ファイルのコピーを、ノードを使用することにしている各ブローカー・システムに置くことが必要です。 ユーザー定義ノードは希望するディレクトリーに保管することができます。 mqsichangebroker または mqsicreatebroker コマンドを使用して、このディレクトリーを指定する必要があります。 ディレクトリーを指定しない場合、次の表に示されているデフォルトの場所が使用されます。
C ユーザー定義ノードの場合、.lil ファイルのコピーを保管するだけでなく、.lil ファイルに対応する .pdb ファイルを次のディレクトリーに保管することもお勧めします。
プラットフォーム | 場所 |
---|---|
Windows |
WBIMB_install_dir¥bin |
Linux |
install_dir/lil |
UNIX |
install_dir/lil |
z/OS |
install_dir/lil |
.pdb ファイルは、アクセス違反や他のソフトウェアの誤動作が起きて、 スタック診断情報が表示されるときに、WebSphere Event Broker が使用するシンボル情報を提供します。 これは、ユーザー定義拡張機能で起きた問題をデバッグするとき、および IBM サービス技術員にとっても便利です。
Java ユーザー定義ノードの場合、.jar ファイルのコピーを次のディレクトリーに保管してください。
プラットフォーム | 場所 |
---|---|
Windows |
WBIMB_install_dir¥jplugin |
Linux |
install_dir/lil |
UNIX |
install_dir/jplugin |
z/OS |
install_dir/lil |
これらのディレクトリーは WebSphere Event Broker のインストール中に作成されます。
各ブローカーを停止および再始動して、新規ファイルの存在を検出できるようにすることが必要です。
さらに z/OS の場合は、mqsicompcif ファイル中の LILPATH 変数を、 新しい .lil ファイルを含むライブラリーの名前で更新してください。 更新しないと、次回の再カスタマイズ時に LILPATH 値がリセットされます。 .lil ファイルには .dll ファイルなどの他の実行可能ファイルが必要になることがあります。 これらのファイルは、LIBPATH 変数中に指定されているディレクトリーからロードされます。 LIBPATH 値を更新する必要がある場合は、 mqsicompcif 中でこの値を変更して再カスタマイズしなければなりません。
ノードをインストールすると、メッセージ・フローと同じように、ノードはスキーマと名前で参照されます。
mqsichangebroker コマンドまたは mqsicreatebroker コマンドのいずれかを使用して、ファイルを書き込むディレクトリーを指定します。.lil または .jar ファイルを WebSphere Event Broker インストール・ディレクトリーに保管しないでください。
C ユーザー定義ノードの場合、.lil ファイルに対応する .pdb ファイルも、選択したディレクトリーに保管することをお勧めします。 .pdb ファイルは、アクセス違反や他のソフトウェアの誤動作が起きてスタック診断情報が表示されるときに、WebSphere Event Broker が使用するシンボル情報を提供します。