modifySIBJMSQueue コマンド
modifySIBJMSQueue コマンドを使用して、特定の有効範囲内のデフォルト・メッセージング・プロバイダーの JMS キューのプロパティーを変更します。
コマンドを実行するには、wsadmin スクリプト・クライアントの AdminTask オブジェクトを使用します。
wsadmin スクリプト・クライアントは Qshell から実行されます。.
詳しくは、wsadmin スクリプトを使用した WebSphere スクリプトを実行するための Qshell の構成.
- Jython で使用可能なサービス統合バス JMS コマンドのリストと、各コマンドの簡単な説明を見るには、wsadmin プロンプトで以下のコマンドを入力します。
print AdminTask.help('SIBJMSAdminCommands')
- 特定のコマンドの概要ヘルプの場合は、wsadmin プロンプトで以下のコマンドを入力します。
print AdminTask.help('command_name')
AdminConfig.save()
目的
modifySIBJMSQueue コマンドは、特定の有効範囲にあるデフォルト・メッセージング・プロバイダーの JMS キューのプロパティーを変更します。
ターゲット・オブジェクト
JMS キュー。
必須パラメーター
なし。
オプション・パラメーター
- -name
- 管理目的でこの JMS キューを識別するための ID。
- -jndiName
- このキューをアプリケーション・サーバーの名前空間にバインドするために使用する JNDI 名。
- -queueName
- JMS キューがマップする先のサービス統合バス宛先の名前。
- -description
- 管理を目的とした、バスの説明 (オプション)。
- -deliveryMode Application | NonPersistent | Persistent
- このキューに送信されるメッセージのメッセージ・プロデューサーによって使用される送達モード。
- -timeToLive
- このキューに送信されたメッセージをシステムが保持しておく必要のある、ディスパッチ時刻からのデフォルトの時間。0 は、存続時間に期限切れがないことを示します。 このパラメーターが提供されていない場合、プロデューサーからの値が使用されます。
- -priority
- このキューに送信されるメッセージの優先度。指定がない場合は、プロデューサーからの値が使用されます。 0 から 9 の範囲で、0 が最低の優先度、9 が最高の優先度です。
- -readAhead AsConnection | AlwaysOn | AlwaysOff
- これによって、メッセージ配信中の先読みの最適化を制御します。デフォルトは AsConnection です。
- -busName
- queueName によって指定されたバス宛先が構成されているサービス統合バスの名前。 設定しなかった場合は、アプリケーションの接続先のバスが使用されます。
- -scopeToLocalQP TRUE | FALSE
- この JMS キューを使用して宛先指定される際に、基礎を成すサービス統合バスのキュー宛先が、ローカル・キュー・ポイントに対してスコープされるかどうかを示します。
ローカル・キュー・ポイントとは、JMS アプリケーションの接続先であるメッセージング・エンジン上で構成されるキュー・ポイントです。
このオプションは、この JMS キューを使用してメッセージを送受信する際、および要求メッセージに応答キューを設定する際に適用されます。
応答キューが要求メッセージに設定されている場合、ローカル・キュー・ポイントは、応答キューを使用しているアプリケーションが応答メッセージを送信する先のメッセージング・エンジンではなく、
応答キューを設定しているアプリケーションの接続先のメッセージング・エンジン上にあります。
接続されているメッセージング・エンジンに宛先のキュー・ポイントが存在しない場合は、このオプションは無視されます。
デフォルト値は FALSE です。
このオプションのデフォルト設定の変更は、WebSphere® Application Server バージョン 7.0 以降 サーバーまたはクライアントで実行されていて、 WebSphere Application Server バージョン 7.0 以降 サーバーで実行されているメッセージング・エンジンに接続されている JMS アプリケーションが使用する場合にのみサポートされます。 以前のバージョンの WebSphere Application Server で使用すると、アプリケーションの例外が発生します。
- -producerBind TRUE | FALSE
- JMS プロデューサーが、クラスター・キューのキュー・ポイントにどのようにバインドされるかを示します。
デフォルト値は FALSE です。
このオプションのデフォルト設定の変更は、WebSphere Application Server バージョン 7.0 以降 サーバーまたはクライアントで実行されていて、 WebSphere Application Server バージョン 7.0 以降 サーバーで実行されているメッセージング・エンジンに接続されている JMS アプリケーションが使用する場合にのみサポートされます。 以前のバージョンの WebSphere Application Server で使用すると、アプリケーションの例外が発生します。
- TRUE
- メッセージング・システムが、セッションを開く際にキュー・ポイントを選択します。 セッションで作成されたメッセージはすべて、選択されたキュー・ポイントに送信されます。 メッセージング・システムは、キュー・ポイントの選択時に producerPreferLocal 設定を使用します。
- FALSE
- メッセージング・システムは、メッセージの送信ごとにキュー・ポイントを選択します。これによって、すべての選択可能なキュー・ポイントを使用して、 メッセージのワークロード・バランシングが可能になる場合があります。 メッセージング・システムは、キュー・ポイントの選択時に producerPreferLocal 設定を使用します。
- -producerPreferLocal TRUE | FALSE
- メッセージング・システムがメッセージ作成先のキュー・ポイントを選択する際に、プロデューサーに対してローカルのキュー・ポイントを、他の選択可能なキュー・ポイントより優先させるかどうかを指定します。
ローカル・キュー・ポイントとは、JMS アプリケーションの接続先であるメッセージング・エンジン上で構成されるキュー・ポイントです。
デフォルト値は TRUE です。
このオプションのデフォルト設定の変更は、WebSphere Application Server バージョン 7.0 以降 サーバーまたはクライアントで実行されていて、 WebSphere Application Server バージョン 7.0 以降 サーバーで実行されているメッセージング・エンジンに接続されている JMS アプリケーションが使用する場合にのみサポートされます。 以前のバージョンの WebSphere Application Server で使用すると、アプリケーションの例外が発生します。
- -consumerGatherMessages TRUE | FALSE
- JMS コンシューマーまたはブラウザーは、メッセージング・システムによって、サービス統合バス宛先の単一キュー・ポイントに接続されます。
このパラメーターには、JMS コンシューマーまたはブラウザーがサービス統合バス宛先の使用可能な任意のキュー・ポイントからメッセージを受け取るか (TRUE)、
接続された単一キュー・ポイントからメッセージを受け取るか (FALSE) を指定します。
デフォルト値は FALSE です。複数のキュー・ポイントからメッセージを収集すると、パフォーマンスのコストが増加して、メッセージの順序を維持できなくなります。
このオプションのデフォルト設定の変更は、WebSphere Application Server バージョン 7.0 以降 サーバーまたはクライアントで実行されていて、 WebSphere Application Server バージョン 7.0 以降 サーバーで実行されているメッセージング・エンジンに接続されている JMS アプリケーションが使用する場合にのみサポートされます。 以前のバージョンの WebSphere Application Server で使用すると、アプリケーションの例外が発生します。
例
- Jython の使用:
wsadmin>AdminConfig.getid("/Node:9994GKCNode01" ) '9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)' wsadmin>AdminTask.modifySIBJMSQueue("jmsq2(cells/9994GKCNode01Cell/nodes/ 9994GKCNode01|resources.xml#J2CAdminObject_1098737234986)", ["-queueName", "q2forjms"]) 'jmsq2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CAdminObject_1098737234986)'
- Jacl を使用:
wsadmin>$AdminConfig getid /Node:9994GKCNode01 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) wsadmin>$AdminTask modifySIBJMSQueue jmsq2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CAdminObject_1098737234986) {-queueName q2forjms} jmsq2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CAdminObject_1098737234986)