Einstellungen der Warteschlangenverbindungsfactory des IBM MQ-Providers für Anwendungsclients
Verwenden Sie diese Anzeige, um die Konfigurationseigenschaften der ausgewählten Warteschlangenverbindungsfactory für den IBM MQ-JMS-Provider (Java™ Message Service) anzuzeigen oder zu ändern. Diese Konfigurationseigenschaften bestimmen, wie Verbindungen zwischen dem JMS-Provider und IBM MQ erstellt werden.
Klicken Sie zum Anzeigen dieser Seite von Application Client Resource Configuration Tool (ACRCT) auf Öffnen. Erweitern Sie die ausgewählte JAR-Datei, und klicken Sie dann auf . Klicken Sie mit der rechten Maustaste auf Warteschlangenverbindungsfactorys, und klicken Sie dann auf Neu. Die folgenden Felder werden auf der Registerkarte Allgemein angezeigt.
. Klicken Sie, nachdem Sie eine EAR-Datei lokalisiert haben, auf- Die Eigenschaftswerte, die Sie angeben, müssen mit den Werten, die Sie bei der Konfiguration von IBM MQ für JMS-Ressourcen angegeben haben, übereinstimmen. Weitere Informationen zum Konfigurieren von IBM MQ für JMS-Ressourcen finden Sie im Abschnitt Using Java des Information Center von IBM MQ.
- In IBM MQ dürfen Namen höchstens 48 Zeichen lang sein, mit Ausnahme von Kanalnamen, die höchstens 20 Zeichen lang sein dürfen.
Die für einen JMS-Provider verwendete Verbindungsfactory für eine Warteschlange hat die folgenden Eigenschaften:
Name
Der Name, unter dem diese Warteschlangenverbindungsfactory zu Verwaltungszwecken in WebSphere Application Server geführt wird. Der Name muss innerhalb der JMS-Verbindungsfactorys der WebSphere-Verwaltungsdomäne eindeutig sein.
Information | Wert |
---|---|
Datentyp | String |
Beschreibung
Eine Beschreibung dieser Verbindungsfactory für Verwaltungszwecke in WebSphere Application Server.
Information | Wert |
---|---|
Datentyp | String |
Standardeinstellung | Null |
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.
Information | Wert |
---|---|
Datentyp | String |
Kennwort
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.
Information | Wert |
---|---|
Datentyp | String |
Standardeinstellung | Null |
Kennwort bestätigen
Bestätigt das Kennwort.
Warteschlangenmanager
Der Name des IBM MQ-Warteschlangenmanagers für diese Verbindungsfactory.
Verbindungen, die von dieser Factory erstellt werden, stellen eine Verbindung zu diesem Warteschlangenmanager her.
Information | Wert |
---|---|
Datentyp | String |
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.
Information | Wert |
---|---|
Datentyp | Optionsfeld |
Standardeinstellung | Ausgewählt |
Host
Der Name des Hosts, auf dem der IBM MQ-Warteschlangenmanager nur für Clientverbindungen ausgeführt wird.
Information | Wert |
---|---|
Datentyp | String |
Standardeinstellung | Null |
Einstellmöglichkeiten | Gültiger TCP/IP-Hostname |
Port
Die Nummer des TCP/IP-Ports, der für den Warteschlangenmanger von IBM MQ verwendet wird (nur für Clientverbindungen).
Dieser Port muss im IBM MQ-Warteschlangenmanager konfiguriert sein.
Information | Wert |
---|---|
Datentyp | Integer |
Standardeinstellung | Null |
Einstellmöglichkeiten | Eine gültige im IBM MQ-Warteschlangenmanager konfigurierte TCP/IP-Portnummer. |
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.
Information | Wert |
---|---|
Datentyp | Optionsfeld |
Standardeinstellung | Nicht ausgewählt |
Liste der Verbindungsnamen
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.
host[(port)],[host[(port)]]
Hierbei bezeichnet "port" einen optionalen Wert. Wird kein Wert gesetzt, wird standardmäßig "1414" verwendet. Beispiele:hostname1,hostname2(1415)
Weitere Informationen zum Warteschlangenmanagern mit mehreren Instanzen finden Sie im Information Center von IBM 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 IBM MQ-Warteschlangenmanager verwendet wird.
Information | Wert |
---|---|
Datentyp | String |
Standardeinstellung | Null |
Einstellmöglichkeiten | 1 bis 20 ASCII-Zeichen |
Transporttyp
Gibt an, ob die IBM MQ-Clientverbindung oder JNDI-Bindungen für Verbindungen zum IBM MQ-Warteschlangenmanager verwendet werden. 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.
Information | Wert |
---|---|
Datentyp | Enum |
Einheiten | Nicht zutreffend |
Standardeinstellung | BINDUNGEN |
Einstellmöglichkeiten |
|
Empfohlene Einstellung |
Anmerkung: JMS der IBM MQ Version 5.3
kann nicht in WebSphere Application Server Version 6.1 verwendet werden, weil WebSphere Application Server Version 6.1
eine Java-5-Laufzeitumgebung hat.
Deshalb können keine speicherübergreifenden Verbindungen mit den Warteschlangenmanagern von
IBM MQ 5.3 eingerichtet werden. Dies
kann zu Leistungseinbußen führen, wenn Sie zuvor
IBM 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.
![]() |
Client-ID
Die JMS-Client-ID, die für Verbindungen zum IBM MQ-Warteschlangenmanager verwendet wird.
Information | Wert |
---|---|
Datentyp | String |
CCSID
Die ID des codierten Zeichensatzes (CCSID, Coded Character Set Identifier), die vom IBM MQ-Warteschlangenmanager verwendet wird.
Die CCSID muss eine der von IBM MQ unterstützten CCSIDs sein.
Information | Wert |
---|---|
Datentyp | String |
Weitere Informationen zu den unterstützten CCSIDs und zum Konvertieren von Nachrichtendaten aus einem codierten Zeichensatz in einen anderen finden Sie in den Abschnitten System Administration und Application Programming Reference des Information Center von IBM 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.
Information | Wert |
---|---|
Datentyp | Enum |
Einheiten | Nicht zutreffend |
Standardeinstellung | Nicht ausgewählt |
Einstellmöglichkeiten |
|
Temporäres Modell
Der Name der Modelldefinition, mit dem temporäre Verbindungsfactorys erstellt werden können, wenn noch keine Verbindungsfactory vorhanden ist.
Information | Wert |
---|---|
Datentyp | String |
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.
Information | Wert |
---|---|
Datentyp | String |
Fehler bei Stilllegung
Gibt an, ob Anwendungen von einem Methodenaufruf zurückkehren, wenn der Queue Manager einen Fehler abgefangen hat.
Information | Wert |
---|---|
Datentyp | Kontrollkästchen |
Standardeinstellung | Ausgewählt |
Adresse des lokalen Servers
Gibt die Adresse des lokalen Servers an.
Information | Wert |
---|---|
Datentyp | String |
Abfrageintervall
Diese Einstellung legt fest, in welchem Intervall (in Millisekunden) die Empfänger während der asynchronen Zustellung von Nachrichten überprüft werden.
Information | Wert |
---|---|
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 hinsichtlich eines IBM MQ-Anzeigecursors hinzugefügt wurden.
Information | Wert |
---|---|
Datentyp | Integer |
Einheiten | Millisekunden |
Standardeinstellung | 5000 |
SSL-Cipher-Suite
Gibt die für SSL-Verbindungen zu IBM MQ zu verwendende Cipher Suite an.
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 IBM MQ JVM mit Java 2 Version 1.4 verwenden.
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 von Zertifikatswiderrufslisten finden Sie im Artikel "Working with Certificat Revocation Lists" im Abschnitt Security^ im Information Center von IBM MQ.
Name des SSL-Peers
Für SSL ein DN-Entwurf, der dem vom IBM 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 Zertifikatsprüfung durchgeführt.
Der SSL-Peer-Name wird ignoriert, wenn die Eigenschaft SSL Cipher Suite nicht definiert ist.
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.
Weitere Einzelheiten zu definierten Namen und deren Verwendung mit IBM MQ finden Sie unter "Distinguished Names" im Information Center von IBM MQ.
Verbindungspool
Gibt optionale Einstellungen für den Verbindungspool an.
Die Eigenschaften des Verbindungspools gelten für alle J2C-Connector.
Der Anwendungsserver stellt Verbindungen und Sitzungen mit dem JMS-Provider in einen Pool, um eine bessere Leistung zu erzielen. Das Verbindungspooling geschieht unabhängig vom Verbindungspooling in IBM MQ. Sie müssen die Eigenschaften der Verbindungs- und Sitzungspools für Ihre Anwendungen richtig konfigurieren, da ansonsten nicht das gewünschte Verbindungs- und Sitzungsverhalten erreicht wird.
Ändern Sie die Größe des Verbindungspools, wenn die Anzahl gleichzeitiger Zugriffe von Seiten des Servers auf die JMS-Ressource den Standardwert überschreitet. Die Größe des Verbindungspools wird pro Warteschlange oder Topic festgelegt.
Information | Wert |
---|---|
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.
Information | Wert |
---|---|
Datentyp | Dropdown-Liste |
Standardeinstellung | DISABLED |
Einstellmöglichkeiten |
|
Weitere Informationen zur automatischen Wiederherstellung von Clientverbindungen finden Sie im Information Center von IBM MQ.
Zeitlimit für Wiederherstellung von Clientverbindungen
Die maximale Zeit in Sekunden, die 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-Client-Umgebung 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.
Information | Wert |
---|---|
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 IBM MQ.