modifyWMQActivationSpec コマンド
modifyWMQActivationSpec コマンドを使用して、WebSphere® MQ メッセージング・プロバイダーのアクティベーション・スペックの特定パラメーターを変更します。
コマンドを実行するには、wsadmin スクリプト・クライアントの AdminTask オブジェクトを使用します。
wsadmin スクリプト・クライアントは、Qshell から実行されます。
詳しくは、『WebSphere Application
Server スクリプトを実行するための Qshell の構成』のトピックを参照してください。
このコマンドは、WebSphere Application Server バージョン 7 以降のアプリケーション・サーバーで使用した場合にのみ有効です。 これより前のバージョンでは使用しないでください。
print AdminTask.help('WMQAdminCommands')
print AdminTask.help('command_name')
AdminConfig.save()
目的
modifyWMQActivationSpec コマンドを使用して、コマンドを発行する有効範囲で定義された WebSphere MQ メッセージング・プロバイダーのアクティベーション・スペックを変更します。
- qmgrName
- qmgrHostname
- qmgrPortNumber
- qmgrSrvconnChannel
- transportChain
- wmqTransportType
- ccdtUrl
- ccdtQmgrName
ターゲット・オブジェクト
特定の有効範囲の WebSphere MQ メッセージング・プロバイダーのアクティベーション・スペック。
必須パラメーター
このコマンドのパラメーターは、WebSphere MQ メッセージング・プロバイダーのアクティベーション・スペックの作成に使用するパラメーターと同じです。
オプション・パラメーター
このコマンドのパラメーターは、WebSphere MQ メッセージング・プロバイダーのアクティベーション・スペックの作成に使用するパラメーターと同じです。
-customProperties パラメーターに関するこのコマンドの動作に注意してください。
- -customProperties
- このパラメーターは、WebSphere MQ メッセージング・プロバイダーのアクティベーション・スペック実装に渡されるカスタム・プロパティーを指定します。
通常、カスタム・プロパティーは、WebSphere 管理インターフェースで直接的にはサポートされないアクティベーション・スペックの属性を設定するために使用します。各カスタム・プロパティーは、name および value テーブル・ステップ・パラメーターを使用して指定します。 これらはテーブル・ステップであるため、2 つのパラメーターの順序は固定であり、必ず name を最初に、value を 2 番目に指定する必要があります。
- Jython の場合: [name value]
- Jacl の場合: {name value}
例えば、-WAS_EndpointInitialState は -customProperties パラメーターと一緒に使用できるカスタム・プロパティーです。 -WAS_EndpointInitialState の値は ACTIVE または INACTIVE である必要があります。-WAS_EndpointInitialState は、エンドポイントが登録されるときに、そのエンドポイントをアクティブ化するかどうかを決定します。 アクティブ化するようにこのパラメーターを設定すると、メッセージ駆動型 Bean が宛先と接続するためにこのアクティベーション・スペックが使用されるとすぐに、 その JMS 宛先からメッセージ消費が開始します。
このパラメーターは、J2CMessageEndpoint MBean を介した後続のアクティブ化または非アクティブ化では無視する必要があります。
新しい名前と値のペアが、次のルールを使用してカスタム・プロパティーの既存のセットに追加されます。- 既存のプロパティー・セットに、modify コマンドの一部として指定されているプロパティーと同じ名前のプロパティーが含まれていない場合は、カスタム・プロパティーに値が指定されていないため無視される場合を除き、カスタム・プロパティー・セットに指定のプロパティーが追加されます。
- 既存のプロパティー・セットに、modify コマンドの一部として指定されているプロパティーと同じ名前のプロパティーが含まれていて、modify コマンドにそのプロパティーの値も指定されている場合は、既存の値が指定の値によって置き換えられます。
- プロパティーの既存のセットに、変更コマンドの一部として提供されるものと同じ名前のプロパティーが含まれているものの、変更コマンドがそのプロパティーの値を指定していない場合、同じ名前のプロパティーはカスタム・プロパティーの既存のセットから削除されます。
例
- Jython の使用:
wsadmin>AdminConfig.getid("/Node:9994GKCNode01") 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) wsadmin>AdminTask.listWMQActivationSpecs("9994GKCNode01(cells/9994GKCNode01Cell/ nodes/9994GKCNode01|node.xml#Node_1)") spec1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CActivationSpec_1098737234986) wsadmin>AdminTask.modifyWMQActivationSpec("spec1(cells/9994GKCNode01Cell/ nodes/9994GKCNode01|resources.xml#J2CActivationSpec_1098737234986)", ["-destinationJndiName jms/topics/t5 -destinationType javax.jms.Topic"]) spec1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CActivationSpec_1098737234986)
- Jacl を使用:
wsadmin>$AdminConfig getid /Node:9994GKCNode01 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) wsadmin>$AdminTask listWMQActivationSpecs 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) spec1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CActivationSpec_1098737234986) wsadmin>$AdminTask modifyWMQActivationSpec spec1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CActivationSpec_1098737234986) {-destinationJndiName jms/topics/t5 -destinationType javax.jms.Topic} spec1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CActivationSpec_1098737234986)
- 以下の例では、Jython を使用して WAS_EndpointInitialState カスタム・プロパティーをアクティブにしてアクティベーション・スペック
を変更しています。
wsadmin>AdminConfig.getid("/Node:myNode01") 'myNode01(cells/myCell01/nodes/myNode01|node.xml#Node_1)' wsadmin>wsadmin>AdminTask.listWMQActivationSpecs("myNode01(cells/myCell01/nodes/myNode01|node.xml#Node_1)") 'newas(cells/myCell01/nodes/myNode01|resources.xml#J2CActivationSpec_1298546034140)' wsadmin>AdminTask.modifyWMQActivationSpec("newas(cells/myCell01/nodes/myNode01|resources.xml #J2CActivationSpec_1298546034140)", '-customProperties [[WAS_EndpointInitialState ACTIVE]]')