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.

[IBM i]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.

Sie können eine Liste der verfügbaren Verwaltungsbefehle des IBM MQ-Messaging-Providers sowie eine Kurzbeschreibung jedes einzelnen Befehls abrufen, indem Sie an der wsadmin-Eingabeaufforderung den folgenden Befehl eingeben:

print AdminTask.help('WMQAdminCommands')

Zum Anzeigen einer übersichtlichen Hilfe zu einem bestimmten Befehl geben Sie an der wsadmin-Eingabeaufforderung den folgenden Befehl ein:

print AdminTask.help('Befehlsname')

Speichern Sie Ihre Änderungen nach der Verwendung des Befehls in der Masterkonfiguration. Verwenden Sie beispielsweise den folgenden Befehl:

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.

Anmerkung: Wenn Sie eine Verbindungsfactory des WebSphere MQ-Messaging-Providers ändern, findet eine Interaktion zwischen dem Parameter mappingAlias und dem Parameter containerAuthAlias statt. Diese Interaktion findet statt, wenn der Parameter containerAuthAlias angegeben ist, aber der Parameter mappingAlias nicht. In dieser Situation wird der Parameter mappingAlias automatisch auf den Wert "DefaultPrincipleMapping" gesetzt.

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.

Anmerkung: Wenn der Parameter -qmgrHostname oder -qmgrPortNumber ohne den Parameter -connectionNameList angegeben ist, wird davon ausgegangen, dass keine Liste mit Verbindungsnamen mehr verwendet werden soll, um eine Verbindung zu WebSphere MQ herzustellen, und dass stattdessen der angegebene Hostname und die angegebene Portnummer verwendet werden sollen. Der Parameter -connectionNameList wird deshalb auf einen leeren Wert gesetzt.

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)  

Symbol, das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rmj_wmq_jmscf_modify
Dateiname:rmj_wmq_jmscf_modify.html