Einstellungen der Warteschlangenverbindungsfactory des WebSphere-MQ-Providers für Anwendungsclients

Name

Der Name, unter dem diese Warteschlangenverbindungsfactory für Verwaltungszwecke in WebSphere Application Server geführt wird. Der Name muss innerhalb der JMS-Verbindungsfactorys der WebSphere-Verwaltungsdomäne eindeutig sein.

Datentyp

Zeichenfolge

Beschreibung

Eine Beschreibung dieser Verbindungsfactory für Verwaltungszwecke in WebSphere Application Server.

Datentyp	Zeichenfolge
Standardeinstellung	Ohne

JNDI-Name

Die Laufzeit des Anwendungsclients verwendet dieses Feld zum Abrufen von Konfigurationsdaten.

Benutzer-ID

Die Benutzer-ID, die in Kombination mit der Eigenschaft "Kennwort" zur Authentifizierung verwendet wird, vorausgesetzt, die aufrufende Anwendung gibt nicht explizit eine Benutzer-ID und ein Kennwort an.

Wenn Sie einen Wert für die Eigenschaft "Benutzer-ID" angeben, müssen Sie auch einen Wert für die Eigenschaft "Kennwort" angeben.

Die Eigenschaften "Benutzer-ID" und "Kennwort" werden verwendet, vorausgesetzt, die aufrufende Anwendung gibt nicht explizit eine Benutzer-ID und ein Kennwort an, z. B. bei Verwendung der Methode "createQueueConnection()". Der JMS-Client übergibt die Benutzer-ID und das Kennwort an den JMS-Server.

Datentyp

Zeichenfolge

Kennwort bestätigen

Das Kennwort, das in Kombination mit der Eigenschaft "Benutzer-ID" zur Authentifizierung verwendet wird, vorausgesetzt, die aufrufende Anwendung gibt nicht explizit eine Benutzer-ID und ein Kennwort an.

Wenn Sie einen Wert für die Eigenschaft "Benutzer-ID" angeben, müssen Sie auch einen Wert für die Eigenschaft "Kennwort" angeben.

Datentyp	Zeichenfolge
Standardeinstellung	Ohne

Kennwort bestätigen

Bestätigt das Kennwort.

Warteschlangenmanager

Der Name des WebSphere-MQ-Warteschlangenmanagers für diese Verbindungsfactory.

Verbindungen, die von dieser Factory erstellt werden, stellen eine Verbindung zu diesem Warteschlangenmanager her.

Datentyp

Zeichenfolge

Hostnamen und Portinformationen eingeben

Dieses Optionsfeld ist standardmäßig ausgewählt. Die Eigenschaften "Hostname" und "Port" werden aktiviert, und die Eigenschaft "Liste der Verbindungsnamen" wird inaktiviert.

Datentyp	Optionsfeld
Standardeinstellung	Ausgewählt

Host

Der Name des Host, auf dem der WebSphere-MQ-Warteschlangenmanager ausgeführt wird (nur für Clientverbindungen).

Datentyp	Zeichenfolge
Standardeinstellung	Ohne
Einstellmöglichkeiten	Gültiger TCP/IP-Hostname

Port

Die Nummer des TCP/IP-Ports, der für den WebSphere-MQ-Warteschlangenmanager verwendet wird (nur für Clientverbindungen).

Dieser Port muss im WebSphere-MQ-Warteschlangenmanager konfiguriert sein.

Datentyp	Integer
Standardeinstellung	Ohne
Einstellmöglichkeiten	Gültige TCP/IP-Portnummer, die im WebSphere-MQ-Warteschlangenmanager konfiguriert ist.

Informationen zur Verbindungsnamensliste eingeben

Bei Auswahl dieser Option wird die Eigenschaft "Liste der Verbindungsnamen" aktiviert, und die Eigenschaften "Hostname" und "Port" werden inaktiviert. Wählen Sie dieses Optionsfeld aus, wenn Sie eine Verbindung zu einem Warteschlangenmanager für mehrere Instanzen herstellen möchten.

Datentyp	Optionsfeld
Standardeinstellung	Nicht ausgewählt

Verbindungsnamensliste

Eine Liste mit durch Kommas getrennten Host- und Portinformationen, die verwendet werden können, um eine Verbindung zu einem Warteschlangenmanager für mehrere Instanzen herzustellen.

Die Syntax des Befehls ist wie folgt:

host[(port)],[host[(port)]]

"port" bezeichnet hier einen optionalen Wert. Wird kein Wert gesetzt, wird standardmäßig "1414" verwendet. Beispiel:

hostname1,hostname2(1415)

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

Diese Eigenschaft darf nur verwendet werden, wenn eine Verbindung zu einem Warteschlangenmanager für mehrere Instanzen hergestellt werden soll. Sie darf nicht verwendet werden, wenn Verbindungen zu Warteschlangenmanagern hergestellt werden sollen, die nicht für mehrere Instanzen vorgesehen sind, weil dann das Risiko besteht, dass Probleme hinsichtlich der Transaktionsintegrität auftreten.

Kanal

Der Name des Kanals, der ausschließlich für Clientverbindungen zum WebSphere-MQ-Warteschlangenmanager verwendet wird.

Datentyp	Zeichenfolge
Standardeinstellung	Ohne
Einstellmöglichkeiten	1 bis 20 ASCII-Zeichen

Transporttyp

Gibt an, ob die WebSphere-MQ-Clientverbindung oder die JNDI-Bindungen verwendet werden, um die Verbindung zum WebSphere-MQ-Warteschlangenmanager herzustellen. Der externe JMS-Provider steuert die Kommunikationsprotokolle zwischen JMS-Clients und JMS-Servern. Optimieren Sie den Transporttyp, wenn Sie nicht permanentes, nicht transaktionsorientiertes Messaging ohne ASF-Unterstützung verwenden oder Sicherheitsaspekte abdecken möchten und der Client ein lokaler Client des Warteschlangenmanagerknotens ist.

Datentyp	Enum
Einheiten	Nicht zutreffend
Standardeinstellung	BINDUNGEN
Einstellmöglichkeiten	BINDUNGEN JNDI-Bindungen werden verwendet, um eine Verbindung zum Warteschlangenmanager herzustellen. BINDUNGEN steht für ein Shared-Memory-Protokoll und kann nur verwendet werden, wenn sich der Warteschlangenmanager auf demselben Knoten wie der JMS-Client befindet und Sicherheitsprobleme auftreten, die durch die Verwendung von EJB-Rollen gelöst werden müssen. CLIENT Es wird eine WebSphere-MQ-Clientverbindung verwendet, um die Verbindung zum Warteschlangenmanager herzustellen. CLIENT ist ein typisches TCP-basiertes Protokoll. DIREKT Verwenden Sie für WebSphere MQ Event Broker den Modus "DIREKT". "DIREKT" ist ein Lightweight-Socket-Protokoll, das für nicht transaktionsorientiertes, nicht permanentes und nicht persistentes Publish/Subscribe-Messaging verwendet wird. "DIREKT" funktioniert nur für Clients und MDBs, die das Protokoll ohne ASF verwenden. WARTESCHLANGE "WARTESCHLANGE" ist ein TCP-Standardprotokoll.
Empfohlene Einstellung	Transporttyp der Warteschlangenverbindungsfactory Der Transporttyp "BINDUNGEN" ist um mindestens 30 % schneller, bietet aber wenig Sicherheit. Wenn Sie Sicherheitsbedenken haben, ist der Transporttyp "BINDUNGEN" dem Transporttyp "CLIENT" vorzuziehen. Transporttyp der Topicverbindungsfactory DIREKT ist der schnellste Transporttyp und sollte, sofern möglich, immer verwendet werden. Verwenden Sie den Transporttyp "BINDUNGEN", wenn Sie zusätzliche Sicherheit benötigen und der Warteschlangenmanager für den JMS-Client lokal ist. Auf WARTESCHLANGE kann in allen anderen Fällen zurückgegriffen werden. WebSphere MQ 5.3 vor CSD2 mit der Einstellung DIREKT kann Nachrichten verlieren, wenn MDBs verwendet werden und die Arbeitslast hoch ist. Der Nachrichtenverlust tritt auch in Clientanwendungen auf, sofern die Eigenschaft "maxClientQueueSize" des Brokers nicht auf "0" gesetzt ist. Sie können die Eigenschaft mit dem folgenden Befehl auf "0" setzen: #wempschangeproperties WAS-Knotenname_server1 -e default -o Steuerkomponente_für_dynamische_Subskriptionen -n Maximalgröße_der_Clientwarteschlange -v 0 -x UUID_der_Ausführungsgruppe Die UUID_der_Ausführungsgruppe ermitteln Sie, indem Sie den Broker starten und im Ereignisprotokoll der Anwendungen nach dem Ereignis 2201 suchen. Dieser Wert lautet gewöhnlich "ffffffff-0000-0000-000000000000". Anmerkung: Der JMS von WebSphere MQ 5.3 kann nicht in WAS 6.1 verwendet werden, weil WAS 6.1 eine Java-Laufzeitumgebung der Version 5 hat. Deshalb können keine speicherübergreifenden Verbindungen mit den Warteschlangenmanagern von WebSphere MQ 5.3 eingerichtet werden. Dies kann zu Leistungseinbußen führen, wenn Sie zuvor WebSphere MQ 5.3 und "BINDUNGEN" für Ihre Verbindungen verwendet und bei der Migration auf WebSphere Application Server 6.1 die Umstellung auf CLIENT-Netzverbindungen vorgenommen haben. Wenn Sie WebSphere MQ 5.3 for z/OS® verwenden, müssen Sie unter Umständen ein weiteres Feature-Paket erwerben. Wenn Sie mit einer 64-Bit-z/OS-Plattform arbeiten, muss der Transporttyp auf CLIENT eingestellt sein, weil die 64-Bit-Version der WebSphere-MQ-Umgebung unter z/OS derzeit nicht verfügbar ist und der Modus "BINDUNGEN" nicht verwendet werden kann, um eine Verbindung zur 31-Bit-Version von WebSphere MQ z/OS herzustellen. Möglicherweise müssen Sie für diese Unterstützung ein zusätzliches Feature-Paket für WebSphere MQ erwerben.

Client-ID

Die JMS-Client-ID, die für Verbindungen zum MQSeries-Warteschlangenmanager verwendet wird.

Datentyp

Zeichenfolge

CCSID

Die ID des codierten Zeichensatzes (CCSID, Coded Character Set Identifier), die vom WebSphere-MQ-Warteschlangenmanager verwendet wird.

Diese CCSID muss von WebSphere MQ unterstützt werden.

Datentyp

Zeichenfolge

Weitere Informationen zu den unterstützten CCSIDs und zum Konvertieren von Nachrichtendaten aus einem codierten Zeichensatz in einen anderen finden Sie in den Veröffentlichungen System Administration und Application Programming Reference des Information Centers von WebSphere MQ.

Aufbewahrung von Nachrichten

Wählen Sie dieses Kontrollkästchen aus, wenn unerwünschte Nachrichten in der Warteschlange verbleiben sollen. Andernfalls werden diese Nachrichten entsprechend den für sie festgelegten Optionen behandelt.

Datentyp	Enum
Einheiten	Nicht zutreffend
Standardeinstellung	Nicht ausgewählt
Einstellmöglichkeiten	Ausgewählt Unerwünschte Nachrichten verbleiben in der Warteschlange. Nicht ausgewählt Unerwünschte Nachrichten werden entsprechend den für sie festgelegten Optionen behandelt.

Temporäres Modell

Der Name der Modelldefinition, mit dem temporäre Verbindungsfactorys erstellt werden können, wenn noch keine Verbindungsfactory vorhanden ist.

Datentyp	Zeichenfolge
Einstellmöglichkeiten	1 bis 48 ASCII-Zeichen

Präfix für temporäre Warteschlangen

Das für die Benennung von dynamischen Warteschlangen zu verwendende Präfix.

Datentyp

Zeichenfolge

Fehler bei Stilllegung

Gibt an, ob Anwendungen von einem Methodenaufruf zurückkehren, wenn der Warteschlangenmanager einen Fehler abgefangen hat.

Datentyp	Kontrollkästchen
Standardeinstellung	Ausgewählt

Adresse des lokalen Servers

Gibt die Adresse des lokalen Servers an.

Datentyp

Zeichenfolge

Abfrageintervall

Diese Einstellung legt fest, in welchem Intervall (in Millisekunden) die Empfänger während der asynchronen Zustellung von Nachrichten überprüft werden.

Datentyp	Integer
Einheiten	Millisekunden
Standardeinstellung	5000

Intervall für erneute Suche

Gibt an, in welchem Intervall (in Millisekunden) geprüft wird, ob einem Topic außerhalb der normalen Reihenfolge Nachrichten hinzugefügt wurden.

Dieses Intervall steuert die Suche von Nachrichten, die einem Topic außerhalb der Reihenfolge hinzugefügt wurden.

Datentyp	Integer
Einheiten	Millisekunden
Standardeinstellung	5000

SSL-Cipher-Suite

Die für die SSL-Verbindung zu WebSphere MQ zu verwendende Cipher Suite.

Geben Sie mit dieser Eigenschaft eine gültige, von Ihrem JSSE-Provider bereitgestellte Cipher Suite an. Der Wert muss mit dem CipherSpec-Wert übereinstimmen, der im SVRCONN-Kanal als Kanaleigenschaft angegeben ist.

Sie müssen diese Eigenschaft setzen, wenn Sie die Eigenschaft SSL-Peer-Name definieren.

SSL-Zertifikatsspeicher

Eine Liste mit null oder mehr CRL-Servern (Certificate Revocation List, Zertifikatswiderruflisten), mit denen SSL-Zertifikate auf Widerruf geprüft werden. Wenn Sie einen Wert für diese Eigenschaft angeben, müssen Sie WebSphere MQ JVM mit Java 2 Version 1.4 verwenden.

Der Wert ist eine durch Leerzeichen getrennte Liste von Einträgen im Format:

ldap://Hostname:[Port]

Diesem Wert folgt ein Schrägstrich (/). Wenn Sie keinen Port angeben, wird der LDAP-Standardport 389 angenommen. Beim Verbindungsaufbau wird das vom Server übergebene SSL-Zertifikat mit den angegebenen CRL-Servern auf Gültigkeit geprüft. Weitere Informationen zur Sicherheit für Zertifikatswiderrufslisten finden Sie im Artikel zum Arbeiten mit Zertifikatswiderrufslisten im Abschnitt Sicherheit im Information Center von WebSphere MQ.

Name des SSL-Peers

Für SSL ein DN-Entwurf, der dem vom WebSphere-MQ-Warteschlangenmanager bereitgestellten Namen entsprechen muss. Der definierte Name (DN) wird verwendet, um das Zertifikat, das der Server beim Verbindungsaufbau übergibt, zu identifizieren.

Wenn diese Eigenschaft nicht gesetzt ist, wird eine solche Zertifikatprüfung durchgeführt.

Der SSL-Peer-Name wird ignoriert, wenn die Eigenschaft SSL-Cipher-Suite nicht definiert ist.

Die Eigenschaft ist eine Liste mit Attributname/Attributwert-Paaren, die durch Kommas oder Semikolons getrennt werden. Beispiel:

CN=QMGR.*, OU=IBM, OU=WEBSPHERE

Im angegebenen Beispiel wird das vom Server bei der Verbindungsherstellung vorgelegte Identifikationszertifikat geprüft. Damit der Verbindungsaufbau erfolgreich verläuft, muss das Zertifikat einen allgemeinen Namen haben, der mit "QMGR." beginnt, und mindestens zwei Namen für Organisationseinheiten enthalten: 1. IBM und 2. WEBSPHERE. Bei der Überprüfung wird die Groß-/Kleinschreibung nicht beachtet.

Nähere Einzelheiten zu definierten Namen und ihrer Verwendung in WebSphere MQ finden Sie im Abschnitt "Distinguished Names" im Information Center von WebSphere MQ.

Verbindungspool

Gibt einen optionalen Satz mit Einstellungen für Verbindungspools an.

Die Eigenschaften des Verbindungspools gelten für alle J2C-Connector.

Der Anwendungsserver fasst Verbindungen und Sitzungen mit dem JMS-Provider zu Pools zusammen, um die Leistung zu verbessern. Dies geschieht unabhängig von der Verwendung von WebSphere-MQ-Linkpools. Sie müssen die für Ihre Anwendungen erforderlichen Eigenschaften der Verbindungs- und Sitzungspools konfigurieren, damit das Verbindungs- und Sitzungsverhalten Ihren Vorstellungen entspricht.

Ändern Sie die Größe des Verbindungspools, wenn die gleichzeitigen serverseitigen Zugriffe auf die JMS-Ressource den Standardwert überschreiten. Die Größe des Verbindungspools wird auf Warteschlangen- bzw. Topicbasis definiert.

Datentyp	Kontrollkästchen
Standardeinstellung	Ausgewählt

Optionen für Wiederherstellung von Clientverbindungen

Gibt an, ob eine Verbindung im Clientmodus im Falle eines Übertragungsfehlers oder eines Fehlers beim Warteschlangenmanager automatisch wiederhergestellt wird. Diese Eigenschaft wird ignoriert, es sei denn, die Verbindungsfactory wird in einer Thin-Clientumgebung oder in der Umgebung eines verwalteten Clients verwendet.

Datentyp	Dropdown-Liste
Standardeinstellung	DISABLED
Einstellmöglichkeiten	DISABLED Die Wiederherstellung der Clientverbindung wird nicht automatisch durchgeführt. ASDEF Der Wert des Attributs DefRecon aus der Kanalzeilengruppe der Clientkonfigurationsdatei wird verwendet. Ist kein DefRecon-Wert angegeben, hat diese Einstellung denselben Effekt wie der Wert DISABLED. RECONNECT Die Verbindungswiederherstellung wird für jeden Warteschlangenmanager durchgeführt, der mit dem Wert des WS-Manager-Attributs konsistent ist. Dieser Wert gibt möglicherweise einen anderen Warteschlangenmanager an als den, zu dem die Verbindung ursprünglich hergestellt wurde. QMGR Die Verbindungswiederherstellung wird nur für den Warteschlangenmanager durchgeführt, zu dem die Verbindung ursprünglich hergestellt wurde.

Weitere Informationen zur automatischen Wiederherstellung der Clientverbindung finden Sie im Information Center von WebSphere MQ.

Zeitlimit für Wiederherstellung von Clientverbindungen

Der maximale Zeitraum in Sekunden, den eine Verbindung im Clientmodus nach einem Übertragungsfehler oder einem Fehler bei einem Warteschlangenmanager automatisch versucht, eine Verbindung zu einem Warteschlangenmanager wiederherzustellen. Dieser Parameter wird ignoriert, es sei denn, die Verbindungsfactory wird in einer Thin-Clientumgebung oder in der Umgebung eines verwalteten Clients verwendet. Ob dieser Parameter verwendet wird, ist davon abhängig, welchen Wert der Optionsparameter für die Wiederherstellung von Clientverbindungen hat.

Datentyp	Integer
Einheiten	Sekunden
Standardeinstellung	1800
Einstellmöglichkeiten	Ein Wert von 1 bis 2147483647.

Weitere Informationen zur automatischen Wiederherstellung von Clientverbindungen finden Sie im Information Center von WebSphere MQ.