Befehl "createWMQQueue"

Verwenden Sie den Befehl createWMQQueue, um ein Ziel vom Typ "Warteschlange" für den WebSphere 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 createWMQQueue, um ein Ziel vom Typ "Warteschlange" für den WebSphere MQ-Messaging-Provider in einem bestimmten Geltungsbereich zu erstellen.

Unter den folgenden Bedingungen kann kein Warteschlangenziel für den WebSphere MQ-Messaging-Provider erstellt werden.
  • Es ist bereits ein Warteschlangenziel für den WebSphere MQ-Messaging-Provider mit demselben Namen in demselben Geltungsbereich vorhanden.
  • Der JNDI-Name steht mit einem anderen Eintrag in JNDI von WebSphere Application Server in Konflikt.

Zielobjekt

Der Geltungsbereich des WebSphere MQ-Messaging-Providers, in dem das Warteschlangenziel für den WebSphere MQ-Messaging-Provider erstellt werden soll.

Erforderliche Parameter

-name
Der Verwaltungsname, der diesem Warteschlangenziel für den WebSphere MQ-Messaging-Provider zugeordnet werden soll.
-jndiName
Der Name, der verwendet werden soll, um dieses Objekt an den JNDI-Namespace von WebSphere Application Server zu binden.
-queueName
Der Name der WebSphere MQ-Warteschlange, in der Nachrichten für die Warteschlangenzieldefinition des WebSphere MQ-Messaging-Providers gespeichert werden sollen.

Optionale Parameter

-description
Eine Verwaltungsbeschreibung für das Warteschlangenziel.
-qmgr
Der Warteschlangenmanager, in dem die WebSphere MQ-Warteschlange ausgeführt wird.
-persistence
Dieser Parameter bestimmt die Persistenzstufe, die zum Speichern von Nachrichten verwendet wird, die an dieses Ziel gesendet werden.
Geben Sie einen der folgenden Werte ein, und beachten Sie dabei die Groß-/Kleinschreibung:
  • APP
  • QDEF
  • PERS
  • NON
  • HIGH

Der Standardwert ist APP.

-priority
Die Prioritätsstufe für Nachrichten, die an dieses Ziel gesendet werden.
Geben Sie einen der folgenden Werte ein:
  • APP
    Anmerkung: (Bei APP muss die Groß-/Kleinschreibung beachtet werden.)
  • QDEF
    Anmerkung: (Bei QDEF muss die Groß-/Kleinschreibung beachtet werden.)
  • <Eine positive ganze Zahl zwischen 0 und 9 (einschließlich)>

Der Standardwert ist APP.

-expiry
Die Zeit, nach der an dieses Ziel gesendete Nachrichten verfallen und den festgelegten Dispositionsoptionen entsprechend behandelt werden.
Geben Sie einen der folgenden Werte ein:
  • APP
    Anmerkung: (Bei APP muss die Groß-/Kleinschreibung beachtet werden.)
  • UNLIM
    Anmerkung: (Bei UNLIM muss die Groß-/Kleinschreibung beachtet werden.)
  • <Alle positiven Integer>

Der Standardwert ist APP.

-ccsid
Die ID des codierten Zeichensatzes (CCSID, Coded Character Set Identifier).

Für diesen Parameter muss eine positive ganze Zahl oder ein Leerzeichen angegeben werden. Weitere Einzelheiten finden Sie im Artikel Einstellungen für die erweiterten Eigenschaften von Warteschlangen und Topics des IBM MQ-Messaging-Providers.

Der Standardwert ist 1208.

Wenn Sie das Feld leer lassen, muss der Standardwert verwendet werden.

-useNativeEncoding
Dieser Parameter gibt an, ob die native Codierung verwendet werden soll oder nicht. Die gültigen Werte sind true und false.

Wenn Sie den Parameter auf true setzen, werden die Werte der Attribute -integerEncoding, -decimalEncoding und -floatingPointEncoding ignoriert.

Wenn Sie diesen Parameter auf false setzen, wird die mit den Attributen -integerEncoding, -decimalEncoding und -floatingPointEncoding angegebene Codierung verwendet.

-integerEncoding
Die Einstellung für die Integercodierung für diese Warteschlange.

Geben Sie einen der folgenden Werte ein, und beachten Sie dabei die Groß-/Kleinschreibung: Normal oder Reversed.

Der Standardwert ist Normal.

-decimalEncoding
Die Einstellung für die Dezimalcodierung für diese Warteschlange.

Geben Sie einen der folgenden Werte ein, und beachten Sie dabei die Groß-/Kleinschreibung: Normal oder Reversed.

Der Standardwert ist Normal.

-floatingPointEncoding
Die Einstellung für die Gleitkommacodierung für diese Warteschlange.

Geben Sie einen der folgenden Werte ein, und beachten Sie dabei die Groß-/Kleinschreibung: IEEENormal, IEEEReversed, z/OS.

Der Standardwert ist IEEENormal.

-useRFH2
Dieser Parameter bestimmt, ob ein RFH-Header der Version 2 an Nachrichten angefügt wird, die an dieses Ziel, auch als targetClient bezeichnet, gesendet werden.

Geben Sie einen der folgenden Werte ein, und beachten Sie dabei die Groß-/Kleinschreibung: true oder false (entspricht JMS bzw. MQ targetClient).

Der Standardwert ist true (JMS targetClient).

-sendAsync
Dieser Parameter bestimmt, ob Nachrichten an dieses Ziel gesendet werden können, ohne dass der Warteschlangenmanager ihren Empfang bestätigt.

Geben Sie einen der folgenden Werte ein, und beachten Sie dabei die Groß-/Kleinschreibung: YES, NO oder QDEF.

Der Standardwert ist QDEF.

-readAhead
Dieser Parameter bestimmt, ob Nachrichten für nicht persistente Konsumenten vorausgelesen oder zwischengespeichert werden können.

Geben Sie einen der folgenden Werte ein, und beachten Sie dabei die Groß-/Kleinschreibung: YES, NO oder QDEF.

Der Standardwert ist QDEF.

-readAheadClose
Dieser Parameter gibt die Methode "Schließen bei Vorauslesen" für den Nachrichtenkonsumenten an.

Geben Sie einen der folgenden Werte ein, und beachten Sie dabei die Groß-/Kleinschreibung: DELIVERALL, oder DELIVERCURRENT.

Der Standardwert ist DELIVERALL.

-customProperties
Dieser Parameter gibt angepasste Eigenschaften an, die an die Implementierung des Warteschlangenziels für den WebSphere MQ-Messaging-Provider übergeben werden sollen. Gewöhnlich werden angepasste Eigenschaften verwendet, um die Attribute des Warteschlangenziels 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}
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 ein Ziel vom Typ "Warteschlange" für den WebSphere MQ-Messaging-Provider erstellt.

  • Mit Jython:
    wsadmin>AdminTask.createWMQQueue("9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml#Node_1)", ["-name queue1 -jndiName jms/queues/Q1
     -queueName APP1.QUEUE1"]) 
    queue1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQQueue_1098737234986) 
  • Mit Jacl:
    wsadmin>$AdminTask createWMQQueue 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
    {-name queue1 -jndiName jms/queues/Q1 -queueName APP1.QUEUE1} 
    queue1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQQueue_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_jmswmqq_create
Dateiname:rmj_wmq_jmswmqq_create.html