Befehl "createWMQConnectionFactory"

Verwenden Sie den Befehl createWMQConnectionFactory, um eine Verbindungsfactory 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 createWMQConnectionFactory, um eine Verbindungsfactory für den IBM MQ-Messaging-Provider in einem bestimmten Geltungsbereich zu erstellen.

Sie können keine Verbindungsfactory für den IBM MQ-Messaging-Provider erstellen, wenn die folgenden Bedingungen vorliegen:
  • Es ist bereits eine Verbindungsfactory 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.

Zielobjekt

Der Geltungsbereich des IBM MQ-Messaging-Providers, für den die IBM MQ-Messaging-Provider-Verbindungsfactory erstellt wird.

Erforderliche Parameter

-name
Der Verwaltungsname, der dieser IBM MQ-Messaging-Provider-Verbindungsfactory zugeordnet wird.
-jndiName
Der Name und die Position, die verwendet werden sollen, um dieses Objekt an den JNDI-Namespace von WebSphere Application Server Server zu binden.
-type
Verwenden Sie diesen Parameter, um festzulegen, ob eine einheitliche Verbindungsfactory, eine Warteschlangen-Verbindungsfactory oder eine Topicverbindungsfactory erstellt werden soll.
Geben Sie einen der folgenden Werte ein:
  • CF
  • QCF
  • TCF

CF ist der Standardwert.

Wenn Sie QCF angeben, können die folgenden Parameter nicht angegeben werden:
  • -brokerCtrlQueue
  • -brokerSubQueue
  • -brokerCCSubQueue
  • -brokerVersion
  • -brokerPubQueue
  • -tempTopicPrefix
  • -pubAckWindow
  • -subStore
  • -stateRefreshInt
  • -cleanupLevel
  • -sparesSubs
  • -wildcardFormat
  • -brokerQmgr
  • -clonedSubs
  • -msgSelection
Wenn Sie TCF angeben, können die folgenden Parameter nicht angegeben werden:
  • -msgRetention
  • -rescanInterval
  • -tempQueuePrefix
  • -modelQueue
  • -replyWithRFH2

Optionale Parameter

-description
Eine Verwaltungsbeschreibung, die der Verbindungsfactory zugeordnet wird.
-ccdtUrl
Die 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 eine ccdtURL-Verbindungsfactory zu erstellen.

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

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

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

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

Verwenden Sie diesen Parameter, um eine generische Verbindungsfactory 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 Verbindungsfactory eine Verbindung zu IBM MQ hergestellt wird.

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

Geben Sie einen der folgenden Werte ein:
  • BINDINGS
  • BINDINGS_THEN_CLIENT
  • CLIENT

Der Standardwert ist BINDINGS_THEN_CLIENT.

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

Weitere Informationen zum Konfigurieren des Transporttyps BINDINGS_THEN_CLIENT oder BINDINGS finden Sie im Artikel IBM MQ-Messaging-Provider mit Informationen zu nativen Bibliotheken konfigurieren.

-qmgrHostname
Der Hostname, der für diese Verbindungsfactory 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 Verbindungsfactory 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 Verbindungsfactory 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),remotehost1(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 Verbindungsfactory 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:
  • createWMQConnectionFactory
  • modifyWMQConnectionFactory

Wenn eine Verbindungsfactory des IBM MQ-Messaging-Providers, die auf einer Liste von Verbindungsnamen basiert, von einem Anwendungsclient oder -server verwendet wird, auf dem eine frühere Version von WebSphere Application Server als Version 8.0 ausgeführt wird, dann werden die mit dem Parameter -connectionNameList angegebenen Informationen nicht verwendet. Stattdessen werden die mit den Parametern -qmgrHostname und –qmgrPortNumber angegebenen Werte verwendet und auf die entsprechenden Werte gesetzt, die vom ersten Eintrag des Parameters connectionNameList vorgegeben werden.

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, 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.

-containerAuthAlias
Der für die Zelle definierte containergesteuerte Authentifizierungsalias, dessen Sicherheitsberechtigungsnachweise verwendet werden, um eine Verbindung zu IBM MQ herzustellen.
-componentAuthAlias
Der für die Zelle definierte komponentengesteuerte Authentifizierungsalias, dessen Sicherheitsberechtigungsnachweise verwendet werden, um eine Verbindung zu IBM MQ herzustellen.
-clientId
Die Clientkennung, die für Verbindungen verwendet werden soll, die über diese Verbindungsfactory 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 Verbindungsfactory eine SSL-basierte Verbindung zu IBM MQ herstellt.
-sslResetCount
Dieser Parameter wird verwendet, wenn die Verbindungsfactory 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 Verbindungsfactory 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.

-pollingInterval
Diese Eigenschaft ist nur im Client-Container gültig.
Wenn die Nachrichtenlistener in einer Sitzung keine geeignete Nachricht in ihren Warteschlangen haben, gibt dieser Parameter an, nach welcher Zeit (in Millisekunden) die Nachrichtenlistener erneut versuchen, eine Nachricht aus ihren Warteschlangen abzurufen. Sollte es häufig passieren, dass keine geeignete Nachricht für die Nachrichtenlistener in einer Sitzung verfügbar ist, sollten Sie den Wert dieses Parameters erhöhen.

Der Standardwert ist 5000.

-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.

Für diesen Parameter muss eine positive ganze Zahl angegeben werden. Weitere Einzelheiten finden Sie im Artikel Erweiterte Eigenschaften einer Verbindungsfactory 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 Verbindungsfactory 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 Verbindungsfactory 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 Topic.

-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, falls dieser von dem Warteschlangenmanager abweicht, zu dem die Verbindungsfactory eine Verbindung herstellt.

Es gibt keinen Standardwert.

-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.

-customProperties
Dieser Parameter gibt angepasste Eigenschaften an, die an die Implementierung der Verbindungsfactory für den IBM 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}
-qmgrSvrconnChannel
Der SVRCONN-Kanal, der verwendet werden soll, wenn eine Verbindung zu IBM MQ hergestellt wird.

Verwenden Sie diesen Parameter, um eine explizit definierte Verbindungsfactory zu erstellen.

Der Standardwert ist SYSTEM.DEF.SVRCONN.

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

-support2PCProtocol
Dieser Parameter bestimmt, ob die Verbindungsfactory als Ressource dient, die an einer verteilten zweiphasigen COMMIT-Verarbeitung teilnehmen kann.

Die gültigen Werte für diesen Parameter sind True und False.

Der Standardwert True gibt an, dass die Verbindungsfactory als Ressource dient, die an einer verteilten zweiphasigen COMMIT-Verarbeitung teilnehmen kann.

-modelQueue
Der Name der IBM MQ-Modellwarteschlange, deren Definition als Basis für die Erstellung temporärer JMS-Ziele verwendet wird.

Der Standardwert ist SYSTEM.DEFAULT.MODEL.QUEUE.

-tempQueuePrefix
Das Präfix, das auf temporäre IBM MQ-Warteschlangen angewendet werden soll, die für die Darstellung von Zielen des Typs "Temporäre JMS-Warteschlange" verwendet werden.

Es gibt keinen Standardwert.

-tempTopicPrefix
Das Präfix, das für die Namen verwendet werden soll, die für temporäre Topics generiert werden. Dieser Parameter ist nur für Verbindungsfactorys oder Topicverbindungsfactorys gültig.

Es gibt keinen Standardwert.

-replyWithRFH2
Dieser Parameter bestimmt, ob beim Senden einer Antwortnachricht an die Empfangswarteschlange für Antworten ein Header der RFH-Version 2 in die Antwortnachricht eingefügt werden soll, wenn die zu beantwortende Nachricht keinen Header der RFH-Version 2 enthält.

Die gültigen Werte für diesen Parameter sind ALWAYS und AS.

Der Standardwert ist AS_REPLY_DEST.

-brokerPubQueue
Der Name der Warteschlange, an die Veröffentlichungsnachrichten gesendet werden sollen, wenn mit warteschlangenbasierten Brokern gearbeitet wird.

Der Standardwert ist SYSTEM.BROKER.DEFAULT.STREAM.

-pubAckInterval
Die Anzahl der Veröffentlichungen, die an einen warteschlangenbasierten Broker gesendet werden, bevor eine Veröffentlichung gesendet wird, die eine Bestätigung erfordert.

Für diesen Parameter muss eine positive ganze Zahl größer als null angegeben werden.

Der Standardwert ist 25.

-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 Standardwert ist NONE.

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

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

Der Wert dieses Parameters muss einer SSL-Konfiguration entsprechen.

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

-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.

-mappingAlias
Der JAAS-Zuordnungsalias, der verwendet wird, um die beim Herstellen einer Verbindung zu IBM MQ zu verwendenden Sicherheitsberechtigungsnachweise zu bestimmen.

Der Standardwert ist DefaultPrincipleMapping.

-xaRecoveryAuthAlias
Der Authentifizierungsalias, dessen Berechtigungsnachweise verwendet werden sollen, um für die XA-Wiederherstellung eine Verbindung zu IBM MQ herzustellen.

Es gibt keinen Standardwert.

Minimale Definition einer Verbindungsfactory

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 Verbindungsfactory mit der Mindestanzahl an Parametern erstellt. Da für die nicht angegebenen Parameter die Standardwerte angenommen werden, können Anwendungen, die diese Verbindungsfactory verwenden, 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.createWMQConnectionFactory("9994GKCNode01(cells/
    9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)", ["-name cf1
     -jndiName 'jms/cf/cf2' -type CF"])  
    cf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQConnectionFactory_1205322636000)
  • Mit Jacl:
    wsadmin>$AdminConfig getid /Node:9994GKCNode01 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)  
    wsadmin>$AdminTask createWMQConnectionFactory 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)  
    {-name cf1 -jndiName "jms/cf/cf1" -type CF}  
    cf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQConnectionFactory_1205322636000)

Explizit definierte Verbindungsfactory

Im folgenden Beispiel wird eine Verbindungsfactory 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.createWMQConnectionFactory("9994GKCNode01(cells/
    9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)", ["-name cf2
     -jndiName 'jms/cf/cf2' -type CF -description 'Must remember to keep each 
    of these connection factories in sync with the IBM MQ queue manager 
    to which they refer' -qmgrName QM1 -qmgrHostname 192.168.0.22 -qmgrPortNumber 1415
     -qmgrSvrconnChannel QM1.SVRCONN"])  
    cf2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQConnectionFactory_120532263601)
  • Mit Jacl:
    wsadmin>$AdminConfig getid /Node:9994GKCNode01 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)  
    wsadmin>$AdminTask createWMQConnectionFactory 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)  
    {-name cf2 -jndiName "jms/cf/cf2" -type CF -description "Must remember to 
    keep each of these connection factories in sync with the IBM MQ queue 
    manager to which they refer" -qmgrName QM1 -qmgrHostname 192.168.0.22 
    -qmgrPortNumber 1415 -qmgrSvrconnChannel QM1.SVRCONN}  
    cf2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQConnectionFactory_120532263601)

Definition einer Verbindungsfactory unter Angabe einer CCDT

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

  • Mit Jython:
    wsadmin>AdminConfig.getid("/Node:9994GKCNode01") 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)  
    wsadmin>AdminTask.createWMQConnectionFactory("9994GKCNode01(cells/
    9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)", ["-name cf3 -jndiName
     'jms/cf/cf3' -type CF -ccdtUrl 'http://myccdt:9080/ccdt/amqclchl.tab'
     -ccdtQmgrName QM3"])  
    cf3(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQConnectionFactory_120532263606)
  • Mit Jacl:
    wsadmin>$AdminConfig getid /Node:9994GKCNode01 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)  
    wsadmin>$AdminTask createWMQConnectionFactory 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)  
    {-name cf3 -jndiName "jms/cf/cf3" -type CF -ccdtUrl 
    "http://myccdt:9080/ccdt/amqclchl.tab" -ccdtQmgrName QM3}  
    cf3(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQConnectionFactory_120532263606)

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_create
Dateiname:rmj_wmq_jmscf_create.html