createSIBMediation コマンド
createSIBMediation コマンドを使用して、新規メディエーションを作成します。
コマンドを実行するには、wsadmin スクリプト・クライアントの AdminTask オブジェクトを使用します。
wsadmin スクリプト・クライアントは Qshell から実行されます。.
詳しくは、wsadmin スクリプトを使用した WebSphere スクリプトを実行するための Qshell の構成.
サービス統合バスのコマンドには、コマンド行ヘルプが用意されています。
- Jython で使用可能なサービス統合バス・コマンドのリストと、各コマンドの簡単な説明を見るには、wsadmin プロンプトで以下のコマンドを入力します。
print AdminTask.help('SIBAdminCommands')
- 特定のコマンドの概要ヘルプの場合は、wsadmin プロンプトで以下のコマンドを入力します。
print AdminTask.help('command_name')
コマンドの使用後に、マスター構成に変更を保存します。次のコマンドを使用します。
AdminConfig.save()
目的
このコマンドは、新規メディエーションを作成します。
ターゲット・オブジェクト
なし。
必須パラメーター
- -bus busname
- メディエーションが作成されるサービス統合バスの名前。listSIBuses コマンドを使用して、既存のバスの名前をリストすることができます。
- -mediationName mediation_name
- 管理目的のためにこのメディエーションが認識される名前。
- -handlerListName
条件付きパラメーター
なし。
オプション・パラメーター
- -description text
- 管理を目的とした、メディエーションの説明 (オプション)。
- -globalTransaction TRUE | FALSE
- FALSE
- ローカル・トランザクションが、それぞれの処理されたメッセージごとに開始されます。 このオプションは、データベースなどの他のリソース・マネージャーに アクセスするメディエーションや、グローバル・トランザクションを必要とする エンタープライズ Beans と対話するメディエーションに対してのみ選択する必要があります。
- TRUE
- グローバル・トランザクションが、それぞれの処理されたメッセージごとに開始されます。
- -allowConcurrentMediation TRUE | FALSE
- TRUE
- メディエーションを複数のメッセージに対して並行して適用して、メッセージの配列を保存します。
- FALSE
- メディエーションを一度に 1 つのメッセージに対して適用します。この設定は、メッセージの 配列を保存するようにする場合に必要です。
- -selector text
メッセージがセレクター・テキスト・ストリングによって 定義された規則に一致しない場合、メッセージは仲介されません。メッセージがセレクターと判別プログラムの両方を含む場合、 仲介されるメッセージの両方の規則と一致する必要があります。セレクターまたは判別プログラムの規則のいずれかが一致しない場合、 メッセージは仲介されません。
- -discriminator text
- 判別プログラム
このプロパティーをセレクター・プロパティーと比較します。 セレクターで指定された規則により、メッセージのヘッダーおよびプロパティーが検査されるのに対し、判別プログラムではメッセージのトピックが検査されます。メッセージがセレクターと判別プログラムの両方を含む場合、 仲介されるメッセージの両方の規則と一致する必要があります。 セレクターまたは判別プログラムの規則のいずれかが一致しない場合、 メッセージは仲介されません。
例
- Jython の使用:
wsadmin>AdminTask.createSIBMediation("-bus abus -mediationName switchMed -handlerListName switchHandler") '(cells/9994GKCCell01/buses/abus|sib-mediations.xml#SIBDestinationMediation_1098219493014)'
- Jacl を使用:
wsadmin>$AdminTask createSIBMediation {-bus abus -mediationName switchMed -handlerListName switchHandler} (cells/9994GKCCell01/buses/abus|sib-mediations.xml#SIBDestinationMediation_1098219493014)