modifyWMQConnectionFactory コマンド

modifyWMQConnectionFactory コマンドを使用して、WebSphere® MQ メッセージング・プロバイダーの接続ファクトリーの特定パラメーターを変更します。

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

[IBM i]wsadmin スクリプト・クライアントは、Qshell から実行されます。 詳しくは、『WebSphere Application Server スクリプトを実行するための Qshell の構成』のトピックを参照してください。

このコマンドは、WebSphere Application Server バージョン 7 以降のアプリケーション・サーバーで使用した場合にのみ有効です。 これより前のバージョンでは使用しないでください。

使用可能な IBM MQ メッセージング・プロバイダー管理コマンドと、各コマンドの概要については、wsadmin プロンプトで次のコマンドを入力してください。

print AdminTask.help('WMQAdminCommands')

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

print AdminTask.help('command_name')

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

AdminConfig.save()

目的

modifyWMQConnectionFactory コマンドを使用して、コマンドを発行する有効範囲で定義された WebSphere MQ メッセージング・プロバイダーの接続ファクトリーを変更します。

注: WebSphere MQ メッセージング・プロバイダーの接続ファクトリーを変更する際、mappingAlias パラメーターと containerAuthAlias パラメーターの間では対話が行われます。 containerAuthAlias パラメーターが指定されている一方で、mappingAlias が指定されていない場合、この対話が行われます。 この状態では、mappingAlias パラメーターは、自動的に値 DefaultPrincipleMapping に設定されます。

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

特定の有効範囲の WebSphere MQ メッセージング・プロバイダーの接続ファクトリー。

必須パラメーター

このコマンドのパラメーターは、WebSphere MQ メッセージング・プロバイダーの接続ファクトリーの作成に使用するパラメーターと同じです。

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

このコマンドのパラメーターは、WebSphere MQ メッセージング・プロバイダーの接続ファクトリーの作成に使用するパラメーターと同じです。

注: -qmgrHostname パラメーター または -qmgrPortNumber パラメーターのいずれかを 指定し、-connectionNameList パラメーターを指定しない場合は、 今後 WebSphere MQ への接続に 接続名リストを使用せず、代わりに指定のホスト名およびポート番号の情報を 使用すると想定されます。この結果、-connectionNameList パラメーターは ブランクに設定されます。

-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)  

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



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