modifyWMQConnectionFactory コマンド
modifyWMQConnectionFactory コマンドを使用して、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()
目的
modifyWMQConnectionFactory コマンドを使用して、コマンドを発行する有効範囲で定義された WebSphere MQ メッセージング・プロバイダーの接続ファクトリーを変更します。
ターゲット・オブジェクト
特定の有効範囲の WebSphere MQ メッセージング・プロバイダーの接続ファクトリー。
必須パラメーター
このコマンドのパラメーターは、WebSphere MQ メッセージング・プロバイダーの接続ファクトリーの作成に使用するパラメーターと同じです。
オプション・パラメーター
このコマンドのパラメーターは、WebSphere MQ メッセージング・プロバイダーの接続ファクトリーの作成に使用するパラメーターと同じです。
-customProperties パラメーターに関するこのコマンドの動作に注意してください。
- -customProperties
- このパラメーターは、WebSphere MQ メッセージング・プロバイダーの接続ファクトリーの実装に渡されるカスタム・プロパティーを指定します。
通常、カスタム・プロパティーは、WebSphere 管理インターフェースで直接的にはサポートされない接続ファクトリーの属性を設定するために使用されます。
各カスタム・プロパティーは、name および value テーブル・ステップ・パラメーターを使用して指定します。 これらはテーブル・ステップであるため、2 つのパラメーターの順序は固定であり、必ず name を最初に、value を 2 番目に指定する必要があります。
- Jython の場合: [name value]
- Jacl の場合: {name value}
新しい名前と値のペアが、次のルールを使用してカスタム・プロパティーの既存のセットに追加されます。- 既存のプロパティー・セットに、modify コマンドの一部として指定されているプロパティーと同じ名前のプロパティーが含まれていない場合は、カスタム・プロパティーに値が指定されていないため無視される場合を除き、カスタム・プロパティー・セットに指定のプロパティーが追加されます。
- 既存のプロパティー・セットに、modify コマンドの一部として指定されているプロパティーと同じ名前のプロパティーが含まれていて、modify コマンドにそのプロパティーの値も指定されている場合は、既存の値が指定の値によって置き換えられます。
- 既存のプロパティー・セットに、modify コマンドの一部として指定されているプロパティーと同じ名前のプロパティーが含まれているが、modify コマンドにそのプロパティーの値が指定されていない場合は、既存のカスタム・プロパティー・セットからその同じ名前のプロパティーが削除されます。
例
- Jython の使用:
wsadmin>AdminConfig.getid("/Node:9994GKCNode01") 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) wsadmin>AdminTask.listWMQConnectionFactories("9994GKCNode01(cells/ 9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)") cf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# MQConnectionFactory_1098737234986) wsadmin>AdminTask.modifyWMQConnectionFactory("cf1(cells/9994GKCNode01Cell/ nodes/9994GKCNode01|resources.xml#MQConnectionFactory_1098737234986)", ["-description 'My new description'"]) cf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# MQConnectionFactory_1098737234986)
- Jacl を使用:
wsadmin>$AdminConfig getid /Node:9994GKCNode01 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) wsadmin>$AdminTask listWMQConnectionFactories 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) cf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# MQConnectionFactory_1098737234986) wsadmin>$AdminTask modifyWMQConnectionFactory cf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# MQConnectionFactory_1098737234986) {-description "My new description"} cf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# MQConnectionFactory_1098737234986)