Befehl "modifyWMQActivationSpec"

Verwenden Sie den Befehl modifyWMQActivationSpec, um bestimmte Parameter einer Aktivierungsspezifikation 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 modifyWMQActivationSpec, um eine Aktivierungsspezifikation des WebSphere-MQ-Messaging-Providers zu ändern, die in dem Geltungsbereich definiert ist, für den der Befehl abgesetzt wird.

Anmerkung: Der Typ einer Aktivierungsspezifikation kann nicht geändert werden. Es ist beispielsweise nicht möglich, keine Aktivierungsspezifikation zu erstellen, in der Sie alle Konfigurationsdaten manuell eingeben, und diese anschließend auf die Verwendung einer CCDT umstellen.
Für eine CCDT-basierte Aktivierungsspezifikation können die folgenden Parameter nicht geändert werden:
  • qmgrName
  • qmgrHostname
  • qmgrPortNumber
  • qmgrSrvconnChannel
  • transportChain
  • wmqTransportType
Für eine generische Aktivierungsspezifikation können die folgenden Parameter nicht geändert werden:
  • ccdtUrl
  • ccdtQmgrName

Zielobjekt

Eine Aktivierungsspezifikation 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 Aktivierungsspezifikation 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 Aktivierungsspezifikation 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 Aktivierungsspezifikation für den WebSphere MQ-Messaging-Provider übergeben werden sollen. Gewöhnlich werden angepasste Eigenschaften verwendet, um die Attribute der Aktivierungsspezifikation 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}

-WAS_EndpointInitialState ist beispielsweise eine angepasste Eigenschaft, die mit dem Parameter -customProperties verwendet werden kann. Der Wert von -WAS_EndpointInitialState muss ACTIVE oder INACTIVE sein. -WAS_EndpointInitialState bestimmt, ob der Endpunkt bei der Registrierung des Endpunkts aktiviert wird. Wenn Sie diesen Parameter auf "active" setzen, beginnt der Nachrichtenkonsum beim JMS-Ziel, sobald die Aktivierungsspezifikation verwendet wird, um eine Message-driven Bean mit dem Ziel zu verbinden.

Dieser Parameter muss bei einer nachfolgenden Aktivierung bzw. Inaktivierung über die MBean "J2CMessageEndpoint" ignoriert werden.

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.listWMQActivationSpecs("9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml#Node_1)")
    spec1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CActivationSpec_1098737234986) 
    
    wsadmin>AdminTask.modifyWMQActivationSpec("spec1(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|resources.xml#J2CActivationSpec_1098737234986)", 
    ["-destinationJndiName jms/topics/t5 -destinationType javax.jms.Topic"]) 
    spec1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CActivationSpec_1098737234986) 
  • Mit Jacl:
    wsadmin>$AdminConfig getid /Node:9994GKCNode01
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
    
    wsadmin>$AdminTask listWMQActivationSpecs
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
    spec1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CActivationSpec_1098737234986) 
    
    wsadmin>$AdminTask modifyWMQActivationSpec
    spec1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CActivationSpec_1098737234986) {-destinationJndiName jms/topics/t5 -destinationType javax.jms.Topic} 
    spec1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CActivationSpec_1098737234986) 
  • Im folgenden Beispiel wird eine Aktivierungsspezifikation durch Aktivierung der angepassten Eigenschaft "WAS_EndpointInitialState" mit Jython geändert:
    wsadmin>AdminConfig.getid("/Node:myNode01")
    'myNode01(cells/myCell01/nodes/myNode01|node.xml#Node_1)'
    wsadmin>wsadmin>AdminTask.listWMQActivationSpecs("myNode01(cells/myCell01/nodes/myNode01|node.xml#Node_1)")
    'newas(cells/myCell01/nodes/myNode01|resources.xml#J2CActivationSpec_1298546034140)'
    wsadmin>AdminTask.modifyWMQActivationSpec("newas(cells/myCell01/nodes/myNode01|resources.xml
    #J2CActivationSpec_1298546034140)", '-customProperties [[WAS_EndpointInitialState ACTIVE]]')

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_jmsas_modify
Dateiname:rmj_wmq_jmsas_modify.html