modifySIBLink コマンド

modifySIBLink コマンドを使用して、サービス統合バス・リンクのプロパティーを変更します。

コマンドを実行するには、wsadmin スクリプト・クライアントAdminTask オブジェクトを使用します。

[IBM i][IBM i]wsadmin スクリプト・クライアントは Qshell から実行されます。. [IBM i]詳しくは、wsadmin スクリプトを使用した WebSphere スクリプトを実行するための Qshell の構成.

サービス統合バスのコマンドには、コマンド行ヘルプが用意されています。
  • Jython で使用可能なサービス統合バス・コマンドのリストと、各コマンドの簡単な説明を見るには、wsadmin プロンプトで以下のコマンドを入力します。

    print AdminTask.help('SIBAdminCommands')

  • 特定のコマンドの概要ヘルプの場合は、wsadmin プロンプトで以下のコマンドを入力します。

    print AdminTask.help('command_name')

コマンドの使用後に、マスター構成に変更を保存します。次のコマンドを使用します。

AdminConfig.save()

目的

modifySIBLink コマンドは、サービス統合バス・リンクのプロパティーを変更します。

ターゲット・オブジェクト

なし。

必須パラメーター

-bus
サービス統合バス・リンクの変更対象となるサービス統合バスの名前。 listSIBuses コマンドを使用して、既存のバスの名前をリストすることができます。
-messagingEngine
サービス統合バス・リンクの変更対象となるメッセージング・エンジンの名前。 サービス統合バス・リンクは、メッセージング・エンジンを異なるサービス統合バスにある別のメッセージング・エンジンに接続し、それによって 2 つのサービス統合バスの間にブリッジを提供します。
-name
サービス統合バス・リンクを識別するための名前。
-foreignBusName
サービス統合バス・リンクに対してリモートのサービス統合バスを定義する外部バスの名前。 listSIBForeignBuses コマンドを使用して、既存の外部バスの名前をリストできます。

条件付きパラメーター

なし。

オプション・パラメーター

-bootstrapEndpoints
このプロパティーは、JMS 接続ファクトリー設定の「Provider endpoint」プロパティーと同じ方法で設定されます。 詳しくは、デフォルト以外のブートストラップ・サーバーへの接続の構成に記載さている、ブートストラップ・エンドポイントの設定に関するステップを参照してください。

ブートストラップ・エンドポイントのポートは、外部バスのターゲット・アプリケーション・サーバーで構成された SIB エンドポイント・アドレスに定義されたポートです。

-remoteMessagingEngineName
-description
管理を目的とした、バスの説明 (オプション)。
-protocolName

トランスポート・チェーン名は、 ターゲット・メッセージング・エンジンがホストされているサーバーで定義されている トランスポート・チェーンの名前でなければなりません。

-authAlias

J2C 認証別名を事前定義しておく必要があります。

-exceptionDestination
サービス統合バス・リンク がメッセージをターゲット宛先に、または、ターゲット宛先用に構成されている例外宛先に配信できない場合、 あるいは、ターゲット宛先が存在しない場合の、インバウンド・メッセージの宛先。
System
サービス統合バス・リンクは、デフォルトの例外宛先を使用します。 バス宛先に配信できないすべてのメッセージは、このリンクが割り当てられている メッセージング・エンジンのシステム・デフォルトの例外宛先 messaging_engine_name に自動的に転送されます。
なし
サービス統合バス・リンクに例外宛先がありません。配信不能メッセージは例外宛先に転送されず、 同じ宛先への配信を待っている他のメッセージの処理を ブロックします。このオプションを使用して、メッセージの順序を保持することができます。
指定
サービス 統合バス・リンクは、ここで指定される例外宛先を 使用します。これが可能でない場合、システム例外宛先 が使用されます。
-initialState Started | Stopped
メッセージング・エンジンの開始時に、リンクを自動的に開始するかどうかを示す、ゲートウェイ・リンクの状態。
通知
デフォルト 始動済み
範囲
停止済み
関連付けられているメッセージング・エンジンの開始時に、ゲートウェイ・リンクは停止状態にあり、新規の接続要求を処理できません。
始動済み
関連付けられているメッセージング・エンジンの開始時に、ゲートウェイ・リンクは始動済み状態にあり、新規の接続要求を処理できます。
-preferLocal TRUE | FALSE
同じメッセージング・エンジン上にあるターゲット宛先のキュー・ポイントへ、リンクが着信メッセージを優先的に送信するかどうか (可能な場合) を示します。 WebSphere® Application Server バージョン 7.0 以降で稼働しているメッセージング・エンジンが、リンクを所有する必要があります。

このオプションは、WebSphere Application Serverバージョン 7.0 以降 サーバーまたはクライアントで実行されていて、WebSphere Application Serverバージョン 7.0 以降 サーバー上で実行中のメッセージング・エンジンに接続されている JMS アプリケーションで使用する場合にのみサポートされます。以前のバージョンの WebSphere Application Server で使用すると、アプリケーションの例外が発生します。

通知
デフォルト TRUE
範囲
TRUE
可能な場合は、それぞれの着信メッセージを、リンクと同じメッセージング・エンジン上にあるターゲット宛先のキュー・ポイントに送信します。
FALSE
着信メッセージを、ターゲット宛先の任意のキュー・ポイントに送信します。

wsadmin>AdminTask.showSIBLink('[-bus bus1 -messagingEngine node01.server1-bus1  -sibLink
mySIBLink]')
'{bootstrapEndpoints=host1:1111:chain1, protocolName=null, authAlias=null,
preferLocalQueuePoints=true, name=mySIBLink, uuid=34647E59163B253D,
remoteMessagingEngineName=node02.server2-bus2, description=null,
targetUuid=BAD49BA75CD36D740E366978, initialState=STARTED,
exceptionDestination=$DEFAULT_EXCEPTION_DESTINATION}'

wsadmin>AdminTask.modifySIBLink('[-bus bus1 -messagingEngine node01.server1-bus1 
-name MySIBLink -foreignBusName -bus2 
-bootstrapEndpoints anotherhost:2222:BootstrapBasicMessaging]')

wsadmin>AdminTask.showSIBLink('[-bus bus1 -messagingEngine node01.server1-bus1  -sibLink
mySIBLink]')
'{bootstrapEndpoints=anotherhost:2222:BootstrapBasicMessaging, protocolName=null,
authAlias=null, preferLocalQueuePoints=true, name=mySIBLink, uuid=34647E59163B253D,
remoteMessagingEngineName=node02.server2-bus2, description=null,
targetUuid=BAD49BA75CD36D740E366978, initialState=STARTED,
exceptionDestination=$DEFAULT_EXCEPTION_DESTINATION}'

キュー・ポイントを使用する際に優先順位を付けないように、サービス統合バス・リンクを変更します。

AdminTask.modifySIBLink('[-bus bus1 -messagingEngine cluster1.000-bus1 -name MyLink 
-foreignBusName -FB1 bootstrapEndpoints host1:1111:chain1 -remoteMessagingEngineName 
-cluster2.000-FB1 -preferLocal FALSE]')

トピックのタイプを示すアイコン 参照トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjj_siblink_modify
ファイル名:rjj_siblink_modify.html