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

Verwenden Sie diese Anzeige, um die Konfigurationseigenschaften der ausgewählten Topicverbindungsfactory für WebSphere® MQ als JMS-Provider anzuzeigen oder zu ändern. Diese Konfigurationseigenschaften bestimmen, wie Verbindungen zwischen dem JMS-Provider und WebSphere MQ erstellt werden.

Klicken Sie zum Anzeigen dieser ACRCT-Seite (Application Client Resource Configuration Tool) auf Datei > Öffnen. Klicken Sie, nachdem Sie eine EAR-Datei lokalisiert haben, auf Öffnen. Klicken Sie auf die ausgewählte JAR-Datei, und wählen Sie dann Messaging-Provider > WebSphere-MQ-Provider aus. Klicken Sie mit der rechten Maustaste auf Topicverbindungsfactory, und klicken Sie dann auf Neu.

Anmerkung:
MA0C broker: Wenn Sie in WebSphere Application Server Version 6 eine Topicverbindungsfactory für den MA0C-Broker erstellen, müssen Sie die folgenden Attributwerte berücksichtigen:
Steuerwarteschlange des Brokers
Für den MA0C-Broker ist dies der feste Wert SYSTEM.BROKER.CONTROL.QUEUE. Dies ist die Warteschlange, aus der der Broker liest.
Broker-Version
Setzen Sie dieses Attribut rfür den MA0C-Broker auf BASIC.
ClientID
Setzen Sie dieses Attribut auf den gewünschten Wert für den MA0C-Broker (der Wert ist eine Zeichenfolge und lediglich eine Kennung für Ihre Clientanwendung).
XA aktiviert
Setzen Sie dieses Attribut für den MA0C-Broker auf TRUE oder FALSE. (Die verwendete Einstellung ist ein Attribut für die Leistungsverbesserung und wird gewöhnlich auf "true" gesetzt.)
Auswahl der Broker-Nachrichten
Dieses Attribut hat für den MA0C-Broker den festen Wert CLIENT, weil der Broker sich auf die Nachrichtenauswahl auf Clientseite stützt.
Berechtigungstyp für direkte Broker-Verbindung
Dieser Wert ist für den MA0C-Broker nicht erforderlich.

Eine Topicverbindungsfactory für den JMS-Provider von WebSphere MQ hat die folgenden Eigenschaften:

Name

Der Name, unter dem diese Verbindungsfactory für Verwaltungszwecke in WebSphere Application Server geführt wird. Der Name muss innerhalb des JMS-Providers eindeutig sein.

Datentyp Zeichenfolge
Beschreibung

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

Datentyp Zeichenfolge
JNDI-Name

Der JNDI-Name (Java Naming and Directory Interface), der zum Binden der Topicverbindungsfactory im Namespace des Anwendungsservers verwendet wird.

Verwenden Sie als Konvention den vollständig qualifizierten JNDI-Namen, z. B. im Format jms/Name. Dabei bezeichnet Name den logischen Namen der Ressource.

Dieser Name wird verwendet, um eine Verknüpfung zu den plattformspezifischen Bindungsinformationen herzustellen. Die Bindung ordnet die im Implementierungsdeskriptor des Moduls definierten Ressourcen den "echten" (physischen) Ressourcen zu, die über die Plattform an JNDI gebunden sind.

Datentyp Zeichenfolge
Einheiten ASCII-Zeichen (US-Englisch)
Einstellmöglichkeiten 1 bis 45 ASCII-Zeichen
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 createTopicConnection(). Der JMS-Client übergibt die Benutzer-ID und das Kennwort an den JMS-Server.

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

Datentyp Zeichenfolge
Kennwort bestätigen

Bestätigt das Kennwort.

Warteschlangenmanager

Der Name des WebSphere-MQ-Warteschlangenmanagers für diese Verbindungsfactory. Verbindungen, die von dieser Verbindungsfactory 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 nur für Clientverbindungen ausgeführt wird.

Datentyp Zeichenfolge
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
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 für Clientverbindungen zum WebSphere-MQ-Warteschlangenmanager verwendet werden soll (nur für Clientverbindungen).

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

Datentyp Enum
Standardeinstellung BINDUNGEN
Einstellmöglichkeiten
CLIENT
Die WebSphere-MQ-Clientverbindung wird verwendet, um eine Verbindung zum WebSphere-MQ-Warteschlangenmanager herzustellen.
BINDUNGEN
JNDI-Bindungen werden verwendet, um eine Verbindung zum WebSphere-MQ-Warteschlangenmanager herzustellen.
Client-ID

Die ID des JMS-Client, der für Verbindungen zum WebSphere-MQ-Warteschlangenmanager verwendet wird.

Datentyp Zeichenfolge
CCSID

(Coded Character Set Identifier) Die ID des codierten Zeichensatzes für den WebSphere-MQ-Warteschlangenmanager.

Diese CCSID muss von WebSphere MQ unterstützt werden. Weitere Einzelheiten finden Sie im Artikel zu den Eigenschaften der Topicverbindungsfactory.

Datentyp Zeichenfolge
Einheiten Integer
Einstellmöglichkeiten 1 bis 65535
Steuerungswarteschlange für Broker

Der Name der Steuerwarteschlange des Brokers, an die alle Befehlsnachrichten (mit Ausnahme von Veröffentlichungen und Anforderungen zum Löschen von Veröffentlichungen) gesendet werden.

Datentyp Zeichenfolge
Einheiten ASCII-Zeichen (US-Englisch)
Einstellmöglichkeiten 1 bis 48 ASCII-Zeichen
Warteschlangenmanager des Brokers

Der Name des WebSphere-MQ-Warteschlangenmanagers, der den Publish/Subscribe-Nachrichten-Broker bereitstellt.

Datentyp Zeichenfolge
Einheiten ASCII-Zeichen (US-Englisch)
Einstellmöglichkeiten 1 bis 48 ASCII-Zeichen
Veröffentlichungswarteschlange des Brokers

Der Name der Eingabewarteschlange des Brokers, die alle Veröffentlichungsnachrichten für den Standarddatenstrom empfängt.

Der Name der Eingabewarteschlange (Datenstromwarteschlange) des Brokers, die alle Veröffentlichungsnachrichten für den Standarddatenstrom empfängt. Anwendungen senden ebenfalls Anforderungen zum Löschen von Anforderungen im Standarddatenstrom an diese Warteschlange.

Datentyp Zeichenfolge
Einheiten ASCII-Zeichen (US-Englisch)
Einstellmöglichkeiten 1 bis 48 ASCII-Zeichen
Subskriptionswarteschlange des Brokers

Der Name der Warteschlange des Brokers, aus der Nachrichten zu nicht permanenten Subskriptionen abgerufen werden.

Der Name der Warteschlange des Brokers, aus der Nachrichten zu nicht permanenten Subskriptionen abgerufen werden. Der Subskribent gibt den Namen der Warteschlange an, wenn er eine Subskription registriert.

Datentyp Zeichenfolge
Einheiten ASCII-Zeichen (US-Englisch)
Einstellmöglichkeiten 1 bis 48 ASCII-Zeichen
Broker CCSubQ

Der Name der Warteschlange des Brokers, aus der Nachrichten zu nicht permanenten Subskriptionen für eine ConnectionConsumer-Anforderung abgerufen werden. Diese Eigenschaft gilt nur für die Verwendung des Webcontainers.

Datentyp Zeichenfolge
Einheiten ASCII-Zeichen (US-Englisch)
Einstellmöglichkeiten 1 bis 48 ASCII-Zeichen
Broker-Version

Gibt an, ob der Nachrichten-Broker von WebSphere MQ MA0C SupportPac™ oder von neueren Versionen der WebSphere-Nachrichten-Broker-Produkte bereitgestellt wird.

Datentyp Enum
Standardeinstellung Erweitert
Einstellmöglichkeiten
Erweitert
Der Message-Broker wird von neueren Versionen von Nachrichtenbrokerprodukten der WebSphere-Produktfamilie bereitgestellt (MQ Integrator und MQ Publish/Subscribe).
Basis
Der Nachrichtenbroker wird von WebSphere MQ MA0C SupportPac (WebSphere MQ - Publish and Subscribe) bereitgestellt.
Bereinigungsstufe

Die vom Dienstprogramm für die Bereinigung von Veröffentlichungen und Subskriptionen unterstützte Bereinigungsstufe.

Datentyp Enum
Standardeinstellung SAFE
Einstellmöglichkeiten
ASPROP
NONE
STRONG
Bereinigungsintervall

Das Intervall (in Millisekunden), in dem das Dienstprogramm für die Bereinigung von Veröffentlichungen und Subskriptionen im Hintergrund ausgeführt wird.

Datentyp Integer
Einheiten Millisekunden
Standardeinstellung 6000
Nachrichtenauswahl

Gibt an, wo die Auswahl von Broker-Nachrichten durchgeführt wird.

Datentyp Enum
Standardeinstellung BROKER
Einstellmöglichkeiten
BROKER
Die Nachrichtenauswahl wird im Broker durchgeführt.
Message CLIENT
Die Nachrichtenauswahl wird im Client durchgeführt.
Intervall für Bestätigung von Veröffentlichungen

Das Intervall (in Anzahl Nachrichten), in dem Veröffentlichungsanforderungen vom Broker bestätigt werden.

Datentyp Integer
Standardeinstellung 25
Sparse-Subskriptionen

Aktiviert die Unterstützung für Sparse-Subskriptionen.

Datentyp Kontrollkästchen
Standardeinstellung Nicht ausgewählt
Intervall für Statusaktualisierung

Das Intervall (in Millisekunden), in dem Transaktionen zur Aktualisierung des Veröffentlichungs- bzw. Subskriptionsstaus ausgeführt werden.

Datentyp Integer
Standardeinstellung 6000
Subskriptionsspeicher

Gibt an, wo WebSphere MQ die Daten für aktive JMS-Subskriptionen speichert.

Datentyp Enum
Standardeinstellung MIGRATE
Einstellmöglichkeiten
MIGRATE
QUEUE
BROKER
Multicast

Gibt an, ob diese Verbindungsfactory Multicast-Transporte verwendet.

Datentyp Enum
Standardeinstellung NOT USED
Einstellmöglichkeiten
NOT USED
Diese Verbindungsfactory verwendet keine Multicast-Transporte.
ENABLED
Diese Verbindungsfactory verwendet immer Multicast-Transporte.
ENABLED_IF_AVAILABLE
Diese Verbindungsfactory verwendet Multicast-Transporte.
ENABLED_RELIABLE
Diese Verbindungsfactory verwendet zuverlässige Multicast-Transporte.
ENABLED_RELIABLE_IF_AVAILABLE
Diese Verbindungsfactory verwendet zuverlässige Multicast-Transporte.
Direkte Authentifizierung

Gibt an, ob eine direkte Broker-Berechtigung verwendet werden soll.

Datentyp Enum
Standardeinstellung NONE
Einstellmöglichkeiten
NONE
Es wird keine direkte Broker-Berechtigung verwendet.
PASSWORD
Die direkte Broker-Berechtigung wird mit einem Kennwort authentifiziert.
CERTIFICATE
Die direkte Broker-Berechtigung wird mit Zertifikaten authentifiziert.
Name des Proxy-Host

Gibt den Hostnamen eines Proxy-Servers an, der für die Kommunikation mit WebSphere MQ verwendet werden soll.

Datentyp Zeichenfolge
Proxy-Port

Gibt die Portnummer eines Proxy-Servers an, der für die Kommunikation mit WebSphere MQ verwendet werden soll.

Datentyp Integer
Standardeinstellung 0
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

Die Adresse des lokalen Servers.

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 SSL-Verbindungen 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 "Working with Certificate Revocation Lists" des Abschnitts Security 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 Zertifikatsprü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 Abschnitt Security im Information Center von WebSphere MQ.

Verbindungspool

Optionale Einstellungen für den Verbindungspool.

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 Verbindungswiederherstellung zu Client

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




Mit (online) gekennzeichnete Links setzen einen Internet-Zugang voraus.

Check for updates to this topic (online)



Dateiname: ucli_ptcfm.html