Befehl "createWMQActivationSpec"

Verwenden Sie den Befehl createWMQActivationSpec, um eine Aktivierungsspezifikation für den IBM MQ-Messaging-Provider in einem bestimmten Geltungsbereich zu erstellen.

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 createWMQActivationSpec, um eine Aktivierungsspezifikation für den IBM MQ-Messaging-Provider in einem bestimmten Geltungsbereich zu erstellen.

Sie können keine Aktivierungsspezifikation für den IBM MQ-Messaging-Provider erstellen, wenn die folgenden Bedingungen vorliegen:
  • Es ist bereits eine Aktivierungsspezifikation für den IBM MQ-Messaging-Provider mit demselben Namen und für denselben Geltungsbereich vorhanden.
  • Der JNDI-Name steht mit einem anderen Eintrag in JNDI von WebSphere Application Server in Konflikt.
Sie erstellen eine CCDT-basierte Aktivierungsspezifikation, indem Sie einen der folgenden Parameter angeben:
  • -ccdtUrl
  • -ccdtQmgrName
Wenn Sie keinen der folgenden Parameter angeben, erstellen Sie eine generische Aktivierungsspezifikation:
  • -ccdtUrl
  • -ccdtQmgrName

Zielobjekt

Der Geltungsbereich des IBM MQ-Messaging-Providers, in dem die Aktivierungsspezifikation für den IBM MQ-Messaging-Provider erstellt werden soll.

Erforderliche Parameter

-name
Der Verwaltungsname, der dieser Aktivierungsspezifikation für den IBM MQ-Messaging-Provider zugeordnet werden soll.
-jndiName
Der Name und die Position, die verwendet werden sollen, um dieses Objekt an den JNDI-Namespace von WebSphere Application Server zu binden.
-destinationJndiName
Der JNDI-Name eines Warteschlangen- oder Topicziels des IBM MQ-Messaging-Providers. Wenn mit dieser Aktivierungsspezifikation eine nachrichtengesteuerte Bean (MDB, Message-driven Bean) implementiert wird, werden Nachrichten für diese MDB von diesem Ziel konsumiert.
-destinationType
Der Typ des mit dem Parameter -destinationJndiName angegebenen Ziels.
Geben Sie einen der folgenden Werte ein:
  • javax.jms.Queue
  • javax.jms.Topic

Es gibt keinen Standardwert.

Optionale Parameter

-description
Eine Verwaltungsbeschreibung, die der Aktivierungsspezifikation zugeordnet wird.
-ccdtUrl
Der URL einer Definitionstabelle für Clientkanal, die für diese Aktivierungsspezifikation verwendet werden soll, wenn eine Verbindung zu IBM MQ hergestellt wird.

Verwenden Sie diesen Parameter, um ccdtURL-Aktivierungsspezifikationen zu erstellen.

Geben Sie diesen Parameter nicht zusammen mit den folgenden Parametern an: -qmgrName, -qmgrType, -qmgrHostname, -qmgrPortNumber, -qmgrSvrconnChannel oder -localAddress.

-ccdtQmgrName
Der Name eines Warteschlangenmanagers, der verwendet werden soll, um Einträge aus einer Definitionstabelle für Clientkanal auszuwählen.

Sie müssen diesen Parameter angeben, wenn mit dem Parameter -transportType der Wert client oder bindingsThenClient angegeben wird.

Geben Sie diesen Parameter nicht zusammen mit den folgenden Parametern an: -qmgrName, -qmgrType, -qmgrHostname, -qmgrPortNumber, -qmgrSvrconnChannel oder -localAddress.

-qmgrName
Der Name des Warteschlangenmanagers, der für diese Aktivierungsspezifikation verwendet werden soll, wenn eine Verbindung zu IBM MQ hergestellt wird.

Verwenden Sie diesen Parameter, um eine generische Aktivierungsspezifikation zu erstellen.

Geben Sie diesen Parameter nicht zusammen mit den folgenden Parametern an: -ccdtUrl oder -ccdtQmgrName.

-wmqTransportType
Dieser Parameter bestimmt, in welcher Weise für diese Aktivierungsspezifikation eine Verbindung zu IBM MQ hergestellt wird.

Verwenden Sie diesen Parameter, um eine generische Aktivierungsspezifikation zu erstellen.

Geben Sie einen der folgenden Werte ein, und beachten Sie dabei die Groß-/Kleinschreibung:
  • BINDINGS
  • BINDINGS_THEN_CLIENT
  • CLIENT

BINDINGS_THEN_CLIENT ist der Standardwert.

Geben Sie diesen Parameter nicht zusammen mit den folgenden Parametern an: -ccdtUrl oder -ccdtQmgrName.

Weitere Informationen zum Konfigurieren des Transporttyps Bindungen, dann Client oder Bindungen finden Sie im Artikel IBM MQ-Messaging-Provider mit Informationen zu nativen Bibliotheken konfigurieren.

-qmgrHostname
Der Hostname, der für diese Aktivierungsspezifikation verwendet werden soll, wenn eine Verbindung zu IBM MQ im Clientmodus hergestellt wird. Es muss sich um einen gültigen TCP/IP-Hostnamen oder eine gültige IPv4- oder IPv6-Adresse handeln.

Der Standardwert ist der lokale Host.

Geben Sie diesen Parameter nicht zusammen mit den folgenden Parametern an: -ccdtUrl oder -ccdtQmgrName.

Informationen dazu, wie der Parameter -qmgrHostname zusammen mit dem Parameter -connectionNameList festgelegt wird, finden Sie in der Beschreibung für den Parameter -connectionNameList.

-qmgrPortNumber
Die Portnummer, die für diese Aktivierungsspezifikation verwendet werden soll, wenn eine Verbindung zu IBM MQ im Clientmodus hergestellt wird.

Geben Sie einen ganzzahligen Wert zwischen 1 und 65536 (einschließlich) ein.

Der Standardwert ist 1414.

Geben Sie diesen Parameter nicht zusammen mit den folgenden Parametern an: -ccdtUrl oder -ccdtQmgrName.

Informationen dazu, wie der Parameter -qmgrPortNumber zusammen mit dem Parameter -connectionNameList festgelegt wird, finden Sie in der Beschreibung für den Parameter -connectionNameList.

-connectionNameList
Die Liste der Verbindungsnamen mit dem Hostnamen und den Portdetails, die verwendet werden müssen, wenn die Aktivierungsspezifikation eine Verbindung zu einem Warteschlangenmanager für mehrere Instanzen herstellen soll.
Anmerkung: Der Parameter -connectionNameList darf nur verwendet werden, wenn eine Verbindung zu einem Warteschlangenmanager für mehrere Instanzen hergestellt werden soll. Wird der Parameter -connectionNameList verwendet, um eine Verbindung zu einem anderen als dem Warteschlangenmanager für mehrere Instanzen herzustellen, kann dies die Transaktionsintegrität gefährden.

Der Parameter -connectionNameList muss als eine durch Kommas getrennte Liste von Hostnamen und Ports im folgenden Format eingegeben werden:

Host(Port),Host(Port)

Geben Sie für Host einen gültigen TCP/IP-Hostnamen oder eine gültige IPv4- oder IPv6-Adresse ein.

Geben Sie als Port einen ganzzahligen Wert zwischen 1 und 65536 (einschließlich dieser beiden Werte) ein. Die Angabe eines Werts für Port ist optional. Wenn Sie keinen Wert angeben, wird für Port standardmäßig der Wert 1414 verwendet.

Beispiel: localhost(1234),remotehost(1234),remotehost2

Wenn Sie den Parameter -connectionNameList angeben, werden für die Parameter -qmgrHostname und -qmgrPortNumber automatisch der Hostname und die Portnummer des ersten Eintrags in der Liste der Verbindungsname festgelegt. Dadurch werden Werte, die möglicherweise vorher in den Parametern -qmgrHostname und -qmgrPortNumber angegeben wurden, außer Kraft gesetzt.

Im vorangegangenen Beispiel würde dies bedeuten, dass -qmgrHostname auf den Wert localhost und -qmgrPortNumber auf den Wert 1234 gesetzt wird.

Der Parameter -connectionNameList ist nur gültig für die Verwendung in WebSphere Application Server Version 8.0 oder höher.

Wenn Sie versuchen, den Parameter -connectionNameList in einer Aktivierungsspezifikation des IBM MQ-Messaging-Providers anzugeben, die im Geltungsbereich eines Servers oder eines Knotens definiert ist, auf dem eine frühere Version von WebSphere Application Server als Version 8.0 ausgeführt wird, wird bei Ausführung der folgenden Befehle eine Fehlernachricht ausgelöst:
  • createWMQActivationSpec
  • modifyWMQActivationSpec
Wenn Sie den Parameter -connectionNameList in einer IBM MQ-Aktivierungsspezifikation angeben, die im Geltungsbereich einer Zelle oder eines Clusters definiert ist, können Sie sie für Knoten verwenden, auf denen WebSphere Application Server Version 7.0 ausgeführt wird. Das genaue Verhalten ist abhängig von der Fixpackstufe des Knotens:
  • Für Knoten, auf denen WebSphere Application Server Version 7.0 Fix Pack 7 oder höher ausgeführt wird, verwendet die Aktivierungsspezifikation den Parameter -connectionNameList, um eine Verbindung zum Warteschlangenmanager für mehrere Instanzen herzustellen.
  • Für Knoten, auf denen eine frühere Fixpackstufe als WebSphere Application Server Version 7.0 Fix Pack 7 ausgeführt wird, wird eine Warnung wie im folgenden Beispiel ausgegeben:
    [29/09/10 12:15:27:468 BST] 00000018 J2CUtilityCla W   J2CA0008W: Die Klasse com.ibm.mq.connector.inbound.ActivationSpecImpl, die von Ressource
    cells/L3A3316Node01Cell/resources.xml#J2CResourceAdapter_1284547647859 verwendet wird, enthält keine Methodengruppe setConnectionNameList. Die Verarbeitung wird fortgesetzt. 
    Sie können diese Nachricht ignorieren.

Der Parameter -connectionNameList darf nicht zusammen mit dem Parameter -ccdtUrl oder -ccdtQmgrName angegeben werden.

Anmerkung: Wenn Sie den Parameter -connectionNameList mit einer zentral verwalteten SSL-Konfiguration verwenden, basieren der Hostname und die Portnummer für die Auswahl der geeigneten SSL-Konfiguration auf dem ersten Eintrag in der Liste der Verbindungsnamen (-connectionNameList), unabhängig davon, welcher Eintrag in der Liste tatsächlich für eine Verbindung mit dem Warteschlangenmanager verwendet wird. Dies liegt daran, dass jede Instanz eines Warteschlangenmanagers für mehrere Instanzen dieselbe SSL-Konfiguration für einen bestimmten Serververbindungskanal verwenden sollte, unabhängig davon, welche Instanz gerade ausgeführt wird.

Weitere Informationen zur Verwendung des Warteschlangenmanagers für mehrere Instanzen finden Sie im Information Center von IBM MQ.

-authAlias
Der Authentifizierungsalias, der verwendet werden soll, um die angegebenen Berechtigungsnachweise abzurufen, wenn diese Aktivierungsspezifikation eine Verbindung zu IBM MQ herstellen muss.
-clientId
Die Clientkennung, die für Verbindungen verwendet werden soll, die über diese Aktivierungsspezifikation gestartet werden.
-providerVersion
Dieser Parameter bestimmt die minimale Versionsnummer und die Funktionalität des Warteschlangenmanagers.
Geben Sie Werte in einem der folgenden Formate ein:
  • n
  • n.n
  • n.n.n
  • n.n.n.n

n steht für eine ganze Zahl größer-gleich null.

Beispiel: 6.0.0.0

-sslCrl
Dieser Parameter gibt eine Liste mit LDAP-Servern an, die für die Bereitstellung von Zertifikatswiderrufsinformationen verwendet werden, wenn diese Aktivierungsspezifikation eine SSL-basierte Verbindung zu IBM MQ herstellt.
-sslResetCount
Dieser Parameter wird verwendet, wenn die Aktivierungsspezifikation eine SSL-Verbindung mit dem Warteschlangenmanager herstellt. Er bestimmt, wie viele Bytes übertragen werden, bevor der für die SSL-Sitzung verwendete symmetrische Chiffrierschlüssel zurückgesetzt wird.

Geben Sie einen Wert zwischen 0 und 999.999.999 ein.

Der Standardwert ist 0.

-sslPeerName
Dieser Parameter wird verwendet, wenn die Aktivierungsspezifikation eine SSL-Verbindung mit dem Warteschlangenmanager herstellt. Der Wert wird mit dem im Peerzertifikat enthaltenen definierten Namen verglichen.
-rcvExit
Eine durch Kommas getrennte Liste mit Klassennamen für Empfangsexits.
-rcvExitInitData
Die an den Empfangsexit zu übergebenden Initialisierungsdaten.

Geben Sie diesen Parameter nur an, wenn Sie auch auch den Parameter -rcvExit angeben.

-sendExit
Eine durch Kommas getrennte Liste mit Klassennamen für Sendeexits.
-sendExitInitData
Die an den Sendeexit zu übergebenden Initialisierungsdaten.

Geben Sie diesen Parameter nur an, wenn Sie auch auch den Parameter -sendExit angeben.

-secExit
Der Klassenname für Sicherheitsexits.
-secExitInitData
Die an den Sicherheitsexit zu übergebenden Initialisierungsdaten.

Geben Sie diesen Parameter nur an, wenn Sie auch auch den Parameter -secExit angeben.

-compressHeaders
Dieser Parameter bestimmt, ob Nachrichtenheader komprimiert werden.
Geben Sie einen der folgenden Werte ein:
  • NONE
  • SYSTEM

Der Standardwert ist NONE.

-compressPayload
Dieser Parameter bestimmt, ob Nachrichtennutzdaten komprimiert werden.
Geben Sie einen der folgenden Werte ein:
  • NONE
  • RLE
  • ZLIBFAST
  • ZLIBHIGH

Der Standardwert ist NONE.

-msgRetention
Dieser Parameter bestimmt, ob der Verbindungskonsument nicht erwünschte Nachrichten in der Eingabewarteschlange aufbewahrt.
Geben Sie einen der folgenden Werte ein:
  • YES
  • NO

Der Wert YES gibt an, dass der Verbindungskonsument nicht erwünschte Nachrichten in der Eingabewarteschlange aufbewahren soll. Der Wert NO gibt an, dass die Nachrichten den festgelegten Dispositionsoptionen entsprechend verworfen werden sollen.

Der Standardwert ist YES.

-rescanInterval
Wenn ein Nachrichtenkonsument in der Punkt-zu-Punkt-Domäne einen Nachrichtenselektor für die Auswahl der zu empfangenden Nachrichten verwendet, sucht der JMS-Client in der mit dem Attribut "MsgDeliverySequence" der Warteschlange festgelegten Reihenfolge in der IBM MQ-Warteschlange nach geeigneten Nachrichten. Wenn der Client eine geeignete Nachricht findet und diese dem Konsumenten zustellt, setzt der Client die Suche fort und sucht, ausgehend von seiner aktuellen Position in der Warteschlange nach der nächsten geeigneten Nachricht. Der Client setzt die Suche in der Warteschlange auf diese Weise fort, bis er das Ende der Warteschlange erreicht oder bis das mit dem Parameter -rescanInterval definiert Zeitintervall (in Millisekunden) abgelaufen ist. In jedem Fall kehrt der Client an den Anfang der Warteschlange zurück, um seine Suche fortzusetzen, und es beginnt ein neues Intervall.

Für diesen Parameter muss eine positive ganze Zahl angegeben werden.

Der Standardwert ist 5000.

-ccsid
Die ID des codierten Zeichensatzes, die in Verbindungen verwendet werden soll.

Der Wert dieses Parameters muss eine positive ganze Zahl sein und einer der von IBM MQ unterstützten codierten Zeichensätze sein. Weitere Einzelheiten finden Sie im Artikel Erweiterte Eigenschaften einer Aktivierungsspezifikation des IBM MQ-Messaging-Providers.

Der Standardwert ist 819.

-failIfQuiescing
Dieser Parameter bestimmt das Verhalten bestimmter Aufrufe an den Warteschlangenmanager, wenn der Warteschlangenmanager in einen internen Wartestatus versetzt wird.

Die gültigen Werte für diesen Parameter sind true und false.

Der Wert true gibt an, dass Aufrufe an bestimmte Methoden fehlschlagen, wenn sich der Warteschlange in einem internen Wartestatus befindet. Wenn eine Anwendung feststellt, dass der Warteschlangenmanager in den Wartestatus versetzt wird, kann die Anwendung ihre unmittelbare Task abschließen und die Verbindung schließen, woraufhin der Warteschlangenmanager gestoppt werden kann.

Der Wert false gibt an, dass Methoden nicht fehlschlagen, wenn sich der Warteschlange in einem internen Wartestatus befindet. Wenn Sie diesen Wert angeben, kann eine Anwendung nicht erkennen, dass der Warteschlangenmanager in den Wartestatus versetzt wird. Die Anwendung kann weiterhin Operationen mit dem Warteschlangenmanager ausführen und verhindert damit, dass der Warteschlangenmanager gestoppt wird.

Der Standardwert ist true.

-brokerCtrlQueue
Der Name der Steuerwarteschlange des Brokers, die verwendet werden soll, wenn diese Aktivierungsspezifikation ein Topic subskribieren soll.

Der Standardwert ist SYSTEM.BROKER.CONTROL.QUEUE.

-brokerSubQueue
Der Name der für den Abruf von Subskriptionsnachrichten zu verwendenden Warteschlange, wenn diese Aktivierungsspezifikation ein Topic subskribieren soll.

Der Standardwert ist SYSTEM.JMS.ND.SUBSCRIBER.QUEUE.

-brokerCCSubQueue
Der Name der Warteschlange, aus der nicht permanente Subskriptionsnachrichten für einen Verbindungskonsumenten abgerufen werden.

Der Standardwert ist SYSTEM.JMS.ND.CC.SUBSCRIBER.QUEUE.

-brokerVersion
Der Wert dieses Parameters bestimmt die erforderliche Funktionalitätsstufe für Publish/Subscribe-Operationen.

Die gültigen Werte sind 1 und 2.

Der Standardwert ist 1.

-msgSelection
Dieser Parameter bestimmt, wo die Nachrichtenauswahl stattfindet.

Die gültigen Werte sind CLIENT und BROKER.

Der Standardwert ist CLIENT.

-subStore
Dieser Parameter bestimmt, wo der IBM MQ-Messaging-Provider persistente Daten speichert, die sich auf aktive Subskriptionen beziehen.

Die gültigen Werte sind MIGRATE, QUEUE und BROKER.

Der Standardwert ist MIGRATE.

-stateRefreshInt
Das Intervall (in Millisekunden) für die Aktualisierung einer Transaktion mit langer Laufzeit, bei dem festgestellt wird, ob die Verbindung des Subskribenten zum Warteschlangenmanager unterbrochen ist. Dieser Parameter ist nur relevant, wenn der Parameter -subStore den Wert QUEUE hat.

Für diesen Parameter muss eine positive ganze Zahl angegeben werden.

Der Standardwert ist 60.000.

-cleanupLevel
Die Bereinigungsstufe für Subskriptionsspeicher des Typs BROKER oder MIGRATE.

Die gültigen Werte sind SAFE, NONE, ASPROP und STRONG.

Der Standardwert ist SAFE.

-cleanupInterval
Das Intervall für die Ausführung des Dienstprogramms für Publish/Subscribe-Bereinigung im Hintergrund.

Für diesen Parameter muss eine positive ganze Zahl angegeben werden.

Der Standardwert ist 3.600.000.

-wildcardFormat
Dieser Parameter bestimmt, welche Gruppe von Zeichen als Platzhalter für Topics interpretiert werden.

Die gültigen Werte sind Topic und Char.

Der Standardwert ist Char.

-sparseSubs
Dieser Parameter steuert die Nachrichtenabrufrichtlinie für ein TopicSubscriber-Objekt.

Die gültigen Werte für diesen Parameter sind true und false.

Der Standardwert ist false.

-brokerQmgr
Der Name des Warteschlangenmanagers, in dem der Broker ausgeführt wird.
-clonedSubs
Dieser Parameter bestimmt, ob zwei oder mehr Instanzen desselben Subskribenten für ein permanentes Topic gleichzeitig ausgeführt werden können.

Die gültigen Werte für diesen Parameter sind ENABLED und DISABLED.

Der Standardwert ist DISABLED.

-qmgrSvrconnChannel
Der SVRCONN-Kanal, der verwendet werden soll, wenn eine Verbindung zu IBM MQ hergestellt wird.

Verwenden Sie diesen Parameter, um explizit definierte Aktivierungsspezifikationen zu erstellen.

Der Standardwert ist SYSTEM.DEF.SVRCONN.

Geben Sie diesen Parameter nicht zusammen mit den folgenden Parametern an: -ccdtUrl oder -ccdtQmgrName.

-brokerCCDurSubQueue
Der Name der Warteschlange, aus der ein Verbindungskonsument permanente Subskriptionsnachrichten empfängt.

Der Standardwert ist SYSTEM.JMS.D.CC.SUBSCRIBER.QUEUE.

-maxPoolSize
Die maximale Anzahl an Serversitzungen im Sitzungspool des Servers, die vom Verbindungskonsumenten genutzt werden.

Für diesen Parameter muss eine positive ganze Zahl angegeben werden.

Der Standardwert ist 10.

-messageSelector
Ein Nachrichtenselektorausdruck, der angibt, welche Nachrichten zugestellt werden sollen.

Für diesen Parameter muss entweder eine leere Zeichenfolge oder eine gültige SQL-92-Anweisung angegeben werden.

-poolTimeout
Die Zeit (in Millisekunden), während der eine nicht verwendete Serversitzung im Sitzungspool des Servers geöffnet bleibt, bevor sie wegen Inaktivität geschlossen wird.

Für diesen Parameter muss eine positive ganze Zahl angegeben werden.

Der Standardwert ist 300.000.

-startTimeout
Der Zeitraum (in Millisekunden), in dem mit der Zustellung einer Nachricht an eine nachrichtengesteuerte Bean (MDB, Message-driven Bean) begonnen werden muss, nachdem die Zustellung der Nachricht geplant wurde. Nach Ablauf dieser Zeitraums, wird die Nachricht in die Warteschlange zurückgestellt.

Für diesen Parameter muss eine positive ganze Zahl angegeben werden.

Der Standardwert ist 10.000.

-subscriptionDurability
Dieser Parameter bestimmt, ob eine permanente oder nicht permanente Subskription für die Zustellung von Nachrichten an eine MDB verwendet wird, die das Topic subskribiert.

Die gültigen Werte für diesen Parameter sind Durable und Nondurable.

Der Standardwert ist Nondurable.

-subscriptionName
Der Name der permanenten Subskription.
-customProperties
Dieser Parameter gibt angepasste Eigenschaften an, die an die Implementierung der Aktivierungsspezifikation für den IBM 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.

-localAddress
Dieser Parameter gibt Folgendes an:
  • die lokale Netzschnittstelle und/oder
  • den lokalen Port bzw. einen Bereich lokaler Ports.

Geben Sie diesen Parameter nicht zusammen mit den folgenden Parametern an: -ccdtUrl oder -ccdtQmgrName.

-sslType
Dieser Parameter bestimmt die Konfiguration, sofern vorhanden, die verwendet werden soll, wenn SSL-Verschlüsselung auf die Netzverbindung zum Warteschlangenmanager angewendet wird.

Die gültigen Werte für diesen Parameter sind CENTRAL, SPECIFIC und NONE.

Der Parameter -sslConfiguration ist nur gültig, wenn der dieser Parameter den Wert SPECIFIC hat.

Der Standardwert ist NONE.

-sslConfiguration
Der Name der SSL-Konfiguration, die verwendet werden soll, wenn SSL für die Sicherung von Netzverbindungen zum Warteschlangenmanager verwendet wird.

Geben Sie diesen Parameter nur an, wenn der Parameter -sslType den Wert SPECIFIC hat.

Der Wert dieses Parameters muss einer SSL-Konfiguration entsprechen.

Es ist kein Standardwert verfügbar.

-stopEndpointIfDeliveryFails
Dieser Parameter gibt an, ob der Endpunkt gestoppt werden soll, wenn die Nachrichtenzustellung so oft scheitert, wie mit der Eigenschaft failureDeliveryCount angegeben wurde.

Die gültigen Werte für diesen Parameter sind true und false.

Der Standardwert ist true.

-failureDeliveryCount
Dieser Parameter gibt die zulässige Anzahl sequenzieller Zustellungsfehler an, bevor der Endpunkt ausgesetzt wird. Dieser Wert wird nur verwendet, wenn der Parameter stopEndpointIfDeliveryFails den Wert true hat.

Für diesen Parameter muss eine nicht negative ganze Zahl angegeben werden.

Der Standardwert ist 0, d. h., der Endpunkt wird beim ersten Zustellungsfehler gestoppt.

Minimale Definition einer Aktivierungsspezifikation

Anmerkung: In den folgenden Beispielen zeigen die mit wsadmin beginnenden Codeblöcke Code, der vom Benutzer eingegeben wurde. Zeilen, die nicht mit wsadmin beginnen, zeigen Code, der von der Konsole zurückgegeben wurde.

Im folgenden Beispiel wird eine Aktivierungsspezifikation mit der Mindestanzahl an Parametern erstellt. Da für die nicht angegebenen Parameter die Standardwerte angenommen werden, können MDBs, die über diese Aktivierungsspezifikation implementiert werden, gemeinsam mit einem generischen Warteschlangenmanager ausgeführt werden, der auf demselben Knoten installiert ist.

  • Mit Jython:
    wsadmin>AdminConfig.getid("/Node:9994GKCNode01")  
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
     
    wsadmin>AdminTask.createWMQActivationSpec("9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml#Node_1)", ["-name spec1 -jndiName jms/as/spec1
     -destinationJndiName jms/queues/q1 -destinationType javax.jms.Queue"]) 
    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 createWMQActivationSpec 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)  
    {-name spec1 -jndiName jms/as/spec1 -destinationJndiName jms/queues/q1
    -destinationType javax.jms.Queue} 
    spec1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CActivationSpec_1098737234986) 
  • Im folgenden Beispiel wird eine Aktivierungsspezifikation, in der der optionale Parameter "WAS_EndpointInitialState" aktiviert ist, mit Jython erstellt:
    wsadmin>attrs = '[[name "WAS_EndpointInitialState"] [required "false"] [type "java.lang.String"] [value "ACTIVE"]]'
    wsadmin>AdminConfig.getid("/Node:myNode01")
    myNode01(cells/myCell01/nodes/myNode01|node.xml#Node_1)'
    wsadmin>theActSpec = AdminTask.createWMQActivationSpec("myNode01(cells/myCell01/nodes/myNode01|node.xml#Node_1)", 
    '-name testas -jndiName testas -destinationJndiName testq -destinationType javax.jms.Queue 
    -customProperties [[WAS_EndpointInitialState Active]]')

Explizite Definition einer Aktivierungsspezifikation

Im folgenden Beispiel wird eine Aktivierungsspezifikation erstellt, für die der Benutzer alle Parameter angeben und verwalten muss, die für das Herstellen einer Verbindung zu IBM MQ verwendet werden.

  • Mit Jython:
    wsadmin>AdminConfig.getid("/Node:9994GKCNode01")
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
    wsadmin>AdminTask.createWMQActivationSpec("9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml#Node_1)", ["-name spec2 -jndiName 'jms/as/spec2'
     -destinationJndiName 'jms/topics/t2' -destinationType javax.jms.Topic
     -description 'Must remember to keep each of these activation specifications in
     sync with the IBM MQ queue manager to which they refer' -qmgrName QM1
     -qmgrHostname 192.168.0.22 -qmgrPort 1415 -qmgrSvrconnChannel QM1.SVRCONN"])
    spec2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CActivationSpec_1098737234987)
  • Mit Jacl:
    wsadmin>$AdminConfig getid /Node:9994GKCNode01
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
    wsadmin>$AdminTask createWMQActivationSpec 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)  
    {-name spec2 -jndiName "jms/as/spec2" -destinationJndiName "jms/topics/t2" 
    -destinationType javax.jms.Topic -description "Must remember to keep each 
    of these activation specifications in sync with the IBM MQ queue manager
    to which they refer" -qmgrName QM1 -qmgrHostname 192.168.0.22 -qmgrPort 1415 
    -qmgrSvrconnChannel QM1.SVRCONN}
    spec2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CActivationSpec_1098737234987)

Definition einer Aktivierungsspezifikation unter Angabe einer CCDT

Im folgenden Beispiel wird eine Aktivierungsspezifikation erstellt, die eine CCDT verwendet, um den Warteschlangenmanager zu ermitteln, zu dem eine Verbindung hergestellt wird.

  • Mit Jython:
    wsadmin>AdminConfig.getid("/Node:9994GKCNode01/")
    Node01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)")
    wsadmin>AdminTask.createWMQActivationSpec("9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml#Node_1)", ["-name spec3 -jndiName 'jms/as/spec3'
     -destinationJndiName 'jms/queue/q3' -destinationType javax.jms.Queue
     -ccdtUrl 'http://myccdt:9080/ccdt/amqclchl.tab' -ccdtQmgrName QM3"])
    spec3(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CActivationSpec_1098737234988)
  • Mit Jacl:
    wsadmin>$AdminConfig getid /Node:9994GKCNode01
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
    wsadmin>$AdminTask createWMQActivationSpec 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
    {-name spec3 -jndiName "jms/as/spec3" -destinationJndiName "jms/queue/q3" 
    -destinationType javax.jms.Queue -ccdtUrl "http://myccdt:9080/ccdt/
    amqclchl.tab" -ccdtQmgrName QM3}
    spec3(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CActivationSpec_1098737234988)

Aktivierungsspezifikation mit der Einstellung ACTIVE für die angepasste Eigenschaft "-WAS_EndpointInitialState" erstellen

  • Im folgenden Beispiel wird eine Aktivierungsspezifikation, in der die angepasste Eigenschaft "WAS_EndpointInitialState" aktiviert ist, mit Jython erstellt:
    wsadmin>attrs = '[[name "WAS_EndpointInitialState"] [required "false"] [type "java.lang.String"] [value "Active"]]'
    wsadmin>AdminConfig.getid("/Node:myNode01")
    myNode01(cells/myCell01/nodes/myNode01|node.xml#Node_1)'
    wsadmin>theActSpec = AdminTask.createWMQActivationSpec("myNode01(cells/myCell01/nodes/myNode01|node.xml#Node_1)", 
    '-name testas -jndiName testas -destinationJndiName testq -destinationType javax.jms.Queue 
    -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_create
Dateiname:rmj_wmq_jmsas_create.html