createWSNAdministeredSubscriber コマンド
createWSNAdministeredSubscriber コマンドを使用して、管理サブスクライバーを新規作成します。
このトピックで説明されているように wsadmin ツールを使用するか、新規の WS-Notification 管理サブスクライバーの作成で説明されているように管理コンソールを使用して、 新規 WS-Notification 管理サブスクライバーを作成することができます。
WS-Notification サービスによって公開されたエンドポイントについて、 管理サブスクライバーを定義しないでください。定義した場合、通知ブローカーを通じてメッセージが無限ループに入る可能性があるためです。
コマンドを実行するには、wsadmin スクリプト・クライアントの AdminTask オブジェクトを使用します。
wsadmin スクリプト・クライアントは Qshell から実行されます。.
詳しくは、wsadmin スクリプトを使用した WebSphere スクリプトを実行するための Qshell の構成.
サービス統合バスのコマンドには、コマンド行ヘルプが用意されています。
- 使用可能な WS-Notification コマンドのリストと、各コマンドの簡単な説明を見るには、wsadmin プロンプトで以下のコマンドを入力します。
print AdminTask.help('WSNotificationCommands')
- 特定のコマンドの概要ヘルプの場合は、wsadmin プロンプトで以下のコマンドを入力します。
print AdminTask.help('command_name')
コマンドの使用後に、マスター構成に変更を保存します。次のコマンドを使用します。
AdminConfig.save()
目的
このコマンドは、新規 WS-Notification 管理サブスクライバーをターゲットの WS-Notification サービス・ポイントに追加します。
ターゲット・オブジェクト
WSNServicePoint
必須パラメーター
- -endpoint
- つまり、通知プロデューサーまたは通知ブローカー・アプリケーションのエンドポイント参照 (Web アドレス) です。例えば、http://remoteproducer.com です。
- -topic
- これは、WS-Notification サービス・ポイントに送信される通知メッセージのクラスを記述したものです。 例えば、stock/IBM です。このプロパティーには、 ユーザーが選択するトピック・ダイアレクトでサポートされる場合に、ワイルドカードを含めることができます。
- -dialect
- すなわち、WS-Topics 規格で定義されている、選択したトピック・ダイアレクト名です。. このパラメーターの値は、SIMPLE、CONCRETE、FULL です。詳しくは、WS-Topicsを参照してください。
条件付きパラメーター
なし。
オプション・パラメーター
- -topicNamespace
- このフィールドを省略すると、特別なトピックの名前空間にトピックが含まれていることが示されます。
- -remoteSubscriptionTimeout
- このタイムアウトにより、ローカル・サーバーがアンインストールされた場合にリモート Web サービスにおいてサブスクリプションが孤立化する可能性を最小限に抑えることができます。このフィールドは、リモート・サブスクリプションの有効期限が切れる予定時間を示していないことに注意してください。サーバーがオフラインになっていると思われる最長時間より長く、タイムアウトを設定します。設定がそれより短い場合、リモート Web サービスからのメッセージのストリームが中断される恐れがあります。通常操作中に期限切れにならないよう、 サーバーは実行中に、必要に応じて、リモート・サブスクリプション終了時間を更新します (指定したタイムアウトで)。指定されない場合、 このタイムアウトはデフォルトで 24 (時間) に設定されます。
例
トピック「wsadmin ツールを使用した新規 WS-Notification サービス・ポイントの作成」の例で作成された WS-Notification サービス・ポイント newServicePoint 上の管理サブスクライバーを作成します。
- Jython の使用:
newAdminSub = AdminTask.createWSNAdministeredSubscriber(newServicePoint, ["-endpoint", "http://myremotehost:9080/producerEP", "-dialect", "SIMPLE", "-topic", "stock", "-topicNamespace", "http://example.org/mynamespace", "-remoteSubscriptionTimeout", 48] )
- Jacl を使用:
set newAdminSub [ $AdminTask createWSNAdministeredSubscriber $newServicePoint { -endpoint http://myremotehost:9080/producerEP -dialect SIMPLE -topic stock -topicNamespace http://example.org/mynamespace -remoteSubscriptionTimeout 48 } ]