イベント伝送で WebSphere Process Server のデフォルトのメッセージング・フィーチャーを使用しない場合、非同期メッセージ伝送で異なる Java Message Service (JMS) プロバイダーを使用するように構成できます。
始める前に
外部 JMS プロバイダーを使用してイベント・メッセージングを構成する前に、まず使用している JMS プロバイダーに適したインターフェースを使用して JMS キューおよび接続ファクトリーを作成する必要があります。
このタスクを使用する理由とその時期
event-message.jacl スクリプトは、WebSphere MQ のような外部 JMS プロバイダーを使用して、非同期イベント伝送に必要な構成オブジェクトをセットアップします。
- 有効範囲を指定した場合、指定の JMS キューおよび接続ファクトリーを使用して、JMS 送信プロファイルを作成します。
- 非同期イベント送信に、作成された JMS 送信プロファイルを使用して、エミッター・ファクトリー・プロファイルを作成します。
- Common Event Infrastructure が使用するメッセージ駆動型 Bean をデプロイし、リスナー・ポートか JMS 活動化仕様のどちらかを使用して、イベント・サーバーに対して非同期送信されたイベントを受信します。
イベント・サーバーに複数の JMS キューをセットアップする場合、異なるエンタープライズ・アプリケーション名および JMS キュー名を指定して、このスクリプトを複数回実行することができます。スクリプトを実行するたびに、追加のメッセージ駆動型 Bean がデプロイされ、新規リソースで指定された JMS キューを使用するように構成されます。
イベント・メッセージングを構成するには、外部 JMS プロバイダーを使用します。
このタスクのステップ
- デフォルトのメッセージングを構成する WebSphere Process Server ランタイム環境を定義するプロファイルがある profile_path/event/application ディレクトリーに移動します。 (profile_path は WebSphere Process Server プロファイルが含まれるディレクトリーへのパスに置き換えます。)
- wsadmin コマンドを使用して、event-message.jacl スクリプトを実行します。
- Windows システム
profile_path¥bin¥wsadmin -profile event-profile.jacl -f event-message.jacl
-action install -earfile event-message.ear -node node_name
[-server server_name] [cluster cluster_name]
-appname app_name -qjndi queue -qcfjndi connection_factory
[-listenerport listener_port] [-activationspecjndi spec_name]
[-eventprofilescope scope] [-trace]
- Linux および UNIX システム
profile_path/bin/wsadmin -profile event-profile.jacl -f event-message.jacl
-action install -earfile event-message.ear -node node_name
[-server server_name] [cluster cluster_name]
-appname app_name -qjndi queue -qcfjndi connection_factory
[-listenerport listener_port] [-activationspecjndi spec_name]
[-eventprofilescope scope] [-trace]
profile_path/bin/wsadmin -profile event-profile.jacl -f event-message.jacl
-action install -earfile event-message.ear -node node_name
[-server server_name] [cluster cluster_name]
-appname app_name -qjndi queue -qcfjndi connection_factory
[-listenerport listener_port] [-activationspecjndi spec_name]
[-eventprofilescope scope] [-trace]
event-message.jacl スクリプトのパラメーターは、以下のとおりです。
- node_name
- メッセージング・アプリケーションがデプロイされる WebSphere Process Server のノード。ノード名を判別するには、以下の処理を行います。
- profile_path/bin/setupCmdLine スクリプトを実行します。
- echo $WAS_NODE コマンド (Linux/UNIX システム) または echo
%WAS_NODE% コマンド (Windows システム) を実行します。
この値は大文字小文字が区別されます。アプリケーションをクラスターにデプロイしている場合、このパラメーターは省略します。
- server_name
- メッセージング・アプリケーションがデプロイされる WebSphere サーバー。
この値は大文字小文字が区別されます。アプリケーションをクラスターにデプロイしている場合、このパラメーターは省略します。
オプションの -trace パラメーターを使用すると、
標準出力に追加のデバッグ情報が表示されます。
注: - event-message.ear ファイルのロケーションを示す完全修飾パスを指定する場合、Windows システムの場合も、パスにスラッシュ (/) を使用します。
- メッセージング・アプリケーションをスタンドアロン・ノードにデプロイしている場合、オプションの -conntype none パラメーターを指定して、ローカル・モードで wsadmin を実行します。
スクリプトの開始後に、JMS ユーザー ID とパスワードの入力を求めるプロンプトが出されます。