Befehl "modifyWMQConnectionFactory"
Verwenden Sie den Befehl modifyWMQConnectionFactory, um bestimmte Parameter einer Verbindungsfactory des WebSphere MQ-Messaging-Providers zu ändern.
Verwenden Sie für die Ausführung des Befehls das Objekt "AdminTask" des wsadmin-Scripting-Clients.
Der wsadmin-Scripting-Client wird über die Qshell ausgeführt.
Weitere Informationen finden Sie im Artikel "Qshell für die Ausführung von WebSphere Application Server-Scripts konfigurieren".
Dieser Befehl ist nur gültig, wenn er mit Anwendungsservern der WebSphere Application Server Version 7 und höher verwendet wird. Verwenden Sie diesen Befehl nicht in früheren Versionen.
print AdminTask.help('WMQAdminCommands')
print AdminTask.help('Befehlsname')
AdminConfig.save()
Zweck
Verwenden Sie den Befehl modifyWMQConnectionFactory, um eine Verbindungsfactory des WebSphere MQ-Messaging-Providers zu ändern, die in dem Geltungsbereich definiert ist, für den der Befehl abgesetzt wird.
Zielobjekt
Eine Verbindungsfactory des WebSphere MQ-Messaging-Providers in einem bestimmten Geltungsbereich.
Erforderliche Parameter
Die Parameter für diesen Befehl sind identisch mit denen, die zum Erstellen einer Verbindungsfactory für den WebSphere MQ-Messaging-Provider verwendet werden.
Optionale Parameter
Die Parameter für diesen Befehl sind identisch mit denen, die zum Erstellen einer Verbindungsfactory für den WebSphere MQ-Messaging-Provider verwendet werden.
Sehen Sie sich das Verhalten dieses Befehls mit dem Parameter -customProperties an.
- -customProperties
- Dieser Parameter gibt angepasste Eigenschaften an, die an die Implementierung der Verbindungsfactory für den
WebSphere MQ-Messaging-Provider übergeben werden sollen.
Gewöhnlich werden angepasste Eigenschaften verwendet, um die Attribute der Verbindungsfactory festzulegen, die über die
WebSphere-Verwaltungsschnittstellen nicht direkt unterstützt werden. Jede angepasste Eigenschaft wird mit den Namens- und Wertparametern für den jeweiligen Tabellenschritt definiert. Da es sich um Tabellenschritte handelt, ist die Reihenfolge der beiden Parameter festgelegt. Sie müssen zuerst den Namen und dann den Wert angeben:
- In Jython: [Name Wert]
- In Jacl: {Name Wert}
Dem vorhandenen Satz angepasster Eigenschaften werden unter Anwendung der folgenden Regeln neue Name/Wert-Paare hinzugefügt:- Wenn der vorhandene Satz von Eigenschaften keine Eigenschaft des mit dem Befehl "modify" angegebenen Namens enthält, wird die angegebene Eigenschaft dem Satz angepasster Eigenschaften hinzugefügt, sofern für die angepasste Eigenschaft ein Wert angegeben ist.
- Wenn der vorhandene Satz von Eigenschaften eine Eigenschaft des mit dem Befehl "modify" angegebenen Namens enthält, wird der vorhandene Wert durch den angegebenen Wert ersetzt.
- Wenn der vorhandene Satz von Eigenschaften eine Eigenschaft des mit dem Befehl "modify" angegebenen Namens enthält, aber im Befehl "modify" kein Wert für die Eigenschaft angegeben ist, wird die Eigenschaft aus dem vorhandenen Satz angepasster Eigenschaften entfernt.
Beispiel
- Mit 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)
- Mit 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)