Befehl "modifyWMQTopic"
Verwenden Sie den Befehl modifyWMQTopic, um bestimmte Parameter eines Topics des IBM 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 modifyWMQTopic, um ein Topic des IBM MQ-Messaging-Providers zu ändern, die in dem Geltungsbereich definiert ist, für den der Befehl abgesetzt wird.
Zielobjekt
Ein Topic des IBM MQ-Messaging-Providers in einem bestimmten Geltungsbereich.
Erforderliche Parameter
Die Parameter für diesen Befehl sind identisch mit denen, die zum Erstellen eines Topics für den IBM MQ-Messaging-Provider verwendet werden.
Optionale Parameter
Die Parameter für diesen Befehl sind identisch mit denen, die zum Erstellen eines Topics für den IBM 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 Topicimplementierung des
IBM MQ-Messaging-Providers übergeben werden sollen.
Gewöhnlich werden angepasste Eigenschaften verwendet, um Attribute des Topics zu definieren,
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>AdminTask.modifyWMQTopic("t1(cells/L3A3316Node04Cell/ nodes/L3A3316Node05|resources.xml#MQTopic_1204538835312)", ["-priority 7"]) t1(cells/L3A3316Node04Cell/nodes/L3A3316Node05|resources.xml# MQTopic_1204538835312)
- Mit Jacl:
wsadmin>$AdminTask modifyWMQTopic t1(cells/L3A3316Node04Cell/nodes/L3A3316Node05|resources.xml# MQTopic_1204538835312) {-priority 7} t1(cells/L3A3316Node04Cell/nodes/L3A3316Node05|resources.xml# MQTopic_1204538835312)