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