Einstellungen für die Topicverbindungsfactory des IBM MQ-Messaging-Providers
Verwenden Sie diese Anzeige, um die Konfigurationseigenschaften der ausgewählten Topicverbindungsfactory für den IBM MQ-Messaging-Provider anzuzeigen oder zu ändern. Mit diesen Konfigurationseigenschaften wird festgelegt, wie Verbindungen zum zugeordneten JMS-Topicziel erstellt werden.
Eine IBM MQ-Topicverbindungsfactory wird verwendet, um JMS-Verbindungen zu Topiczielen herzustellen, die IBM MQ für Publish/Subscribe-Messaging bereitstellt.
- Klicken Sie im Navigationsfenster auf , um vorhandene Topicverbindungsfactorys anzuzeigen.
- Ändern Sie bei Bedarf im Inhaltsteilfenster die Einstellung für den Geltungsbereich in die Ebene, auf der die Topicverbindungsfactorys definiert sind. Auf diese Weise wird die Gruppe der angezeigten Topicverbindungsfactorys eingeschränkt.
- Wählen Sie den Namen der Topicverbindungsfactory aus, mit der Sie arbeiten möchten.
- Erweiterte Eigenschaften: Über diesen Link können Sie die erweiterten Eigenschaften Ihrer IBM MQ-Topicverbindungsfactory anzeigen.
- Brokereigenschaften: Über diesen Link können Sie die Brokereigenschaften Ihrer IBM MQ-Topicverbindungsfactory anzeigen.
- Angepasste Eigenschaften: Über diesen Link können Sie die angepassten Eigenschaften Ihrer IBM MQ-Topicverbindungsfactory anzeigen.
- Eigenschaften des Clienttransports: Über diesen Link können Sie die Clienttransporteigenschaften Ihrer IBM MQ-Topicverbindungsfactory anzeigen oder ändern. Wenn die ausgewählte Topicverbindungsfactory nicht über eine Definitionstabelle für den Clientkanal (CCDT, Client Channel Definition Table) erstellt wurde, folgen Sie diesem Link, um alle erforderlichen Informationen für die Verbindungsherstellung zu IBM MQ einzugeben. Wenn die ausgewählte Topicverbindungsfactory über eine CCDT erstellt wurde, müssen Sie die Clienttransporteigenschaften nicht angeben und deshalb wird der Link nicht angezeigt.
- Verbindungspools: Über diesen Link können Sie die Verbindungspooldetails Ihrer IBM MQ-Topicverbindungsfactory anzeigen.
- Sitzungspools: Über diesen Link können Sie die Sitzungspooldetails Ihrer IBM MQ-Topicverbindungsfactory anzeigen.
Sie können unter "Zugehörige Elemente" auf JAAS - J2C-Authentifizierungsdaten klicken, um Authentifizierungsinformationen für die Topicverbindungsfactory zu konfigurieren.
- -localAddress
- -clonedSubs
- -componentAuthAlias
Weitere Informationen zu diesen Eigenschaften finden Sie im Artikel Befehl "createWMQConnectionFactory".
- Namen dürfen maximal 48 Zeichen lang sein, mit Ausnahme von Kanalnamen, die höchstens 20 Zeichen lang sein dürfen.
- Die Eigenschaftswerte, die Sie angeben, müssen mit den Werten übereinstimmen, die Sie bei der Konfiguration der JMS-Ressourcen in IBM MQ angegeben haben. Weitere Informationen zum Konfigurieren von JMS-Ressourcen in IBM MQ finden Sie im Abschnitt Using Java des Information Center von IBM MQ.
Eine IBM MQ-Topicverbindungsfactory hat die folgenden Eigenschaften:
Verwaltung
Geltungsbereich
Die Stufe, auf der diese Ressourcendefinition für Anwendungen sichtbar ist.
Ressourcen, wie z. B. Messaging-Provider, Namespacebindungen oder gemeinsam genutzte Bibliotheken können in mehreren Bereichen definiert werden. Dabei überschreiben Ressourcen, die in spezifischeren Bereichen definiert wurden, Ressourcen, die in allgemeineren Bereichen definiert wurden.
Der angezeigte Bereich dient nur zur Information und kann in dieser Anzeige nicht geändert werden. Wenn Sie diese Ressource in einem anderen Geltungsbereich anzeigen oder ändern möchten, müssen Sie in der Anzeige mit der Sammlung der IBM MQ-Topicverbindungsfactory den Geltungsbereich ändern und anschließend auf Anwenden klicken, bevor Sie auf den Link für den Ressourcentyp klicken.
Information | Wert |
---|---|
Datentyp | String |
Provider
Der JMS-Provider, der beim Erstellen der Topicverbindungsfactory zugeordnet wird.
Der Provider für alle Topicverbindungsfactorys, die über diese Anzeige erstellt werden, ist der IBM MQ-Messaging-Provider.
Der Provider wird nur zu Informationszwecken angezeigt.
Information | Wert |
---|---|
Datentyp | String |
Name
Der Name, unter dem diese Topicverbindungsfactory für Verwaltungszwecke in WebSphere Application Server geführt ist.
Information | Wert |
---|---|
Datentyp | String |
Einstellmöglichkeiten | Der Name muss innerhalb der Gruppe der JMS-Topicverbindungsfactorys, die in der der Zelle definiert sind, eindeutig sein. |
JNDI-Name
Der JNDI-Name, der verwendet wird, um die Topicverbindungsfactory an den JNDI-Namespace zu binden.
Verwenden Sie als Konvention den vollständig qualifizierten JNDI-Namen, z. B. im Format jms/Name. Dabei bezeichnet Name den logischen Namen der Ressource.
Information | Wert |
---|---|
Datentyp | String |
Beschreibung
Eine Beschreibung dieser Topicverbindungsfactory für Verwaltungszwecke in WebSphere Application Server.
Information | Wert |
---|---|
Datentyp | String |
Standardeinstellung | Null |
Verbindung
Die zum Konfigurieren einer Verbindung erforderlichen Informationen richten sich danach, ob die ausgewählte Topicverbindungsfactory mit einer CCDT erstellt wurde.
- URL der Definitionstabelle für den Clientkanal
- Warteschlangenmanager
- SSL-Konfiguration
- Warteschlangenmanager
- Transport
- Wenn die Option Host- und Portinformationen als gesonderte Host- und Portwerte eingeben
ausgewählt ist, kann die Eigenschaft "Verbindungsnamensliste" nicht verwendet werden und die
folgenden Eigenschaften können verwendet werden:
- Hostname
- Port
- Wenn die Option Host- und Portinformationen als Liste der Verbindungsnamen eingeben
ausgewählt ist, kann die Eigenschaft "Liste der Verbindungsnamen" verwendet werden und die folgenden Eigenschaften können nicht verwendet werden:
- Hostname
- Port
- Serververbindungskanal
- Wenn Sie das Kontrollkästchen für die Eigenschaft SSL für die sichere Kommunikation mit
IBM MQ verwenden abwählen, können die folgenden Eigenschaften nicht angezeigt werden:
- Zentral verwaltet
- Spezielle Konfiguration
- SSL-Konfiguration
Weitere Informationen zum Definieren der SSL-Eigenschaften für IBM MQ finden Sie unter SSL properties im Abschnitt Using Java des Knowledge Center von IBM MQ.
URL der Definitionstabelle für den Clientkanal
Ein URL, der die Position einer IBM MQ-Definitionstabelle für Clientkanäle (CCDT, Client Channel Definition Table) angibt.
Information | Wert |
---|---|
Datentyp | String |
Warteschlangenmanager
Wenn die angegebene Topicverbindungsfactory auf einer Definitionstabelle für den Clientkanal basiert, wird diese Eigenschaft verwendet, um einen Eintrag in dieser Tabelle auszuwählen. Andernfalls ist dies der Name des Warteschlangenmanagers bzw. der Gruppe mit gemeinsamer Warteschlange, zu dem bzw. der eine Verbindung hergestellt werden soll. Es wird eine Verbindung zu dieser IBM MQ-Ressource hergestellt, um Nachrichten zu senden oder zu empfangen.
Information | Wert |
---|---|
Datentyp | String |
Einstellmöglichkeiten | Wenn diese Topicverbindungsfactory nicht auf einer Definitionstabelle für den Clientkanal basiert, muss der Wert der gültige Name eines Warteschlangenmanagers sein.
Wenn
diese Topicverbindungsfactory auf einer Definitionstabelle für den Clientkanal
basiert, müssen Sie einen der folgenden Werte angeben:
Wenn
die angegebene Verbindungsfactory auf einer Definitionstabelle für Clientkanäle basiert und diese Tabelle
eine Auswahl aus mehreren Warteschlangenmanagern vornehmen kann, können Sie möglicherweise keine globalen Transaktionen wiederherstellen.
Daher haben Sie für Verbindungsfactorys, die eine Definitionstabelle für Clientkanäle angeben, zwei Alternativen:
|
Transport
Der IBM MQ-Transporttyp für die Verbindung. Der Transporttyp wird verwendet, um die genauen Mechanismen zu bestimmen, die für die Verbindungsherstellung zu IBM MQ verwendet werden.
Information | Wert |
---|---|
Datentyp | Dropdown-Liste |
Standardeinstellung | Bindungen, dann Client |
Einstellmöglichkeiten |
|
Host- und Portinformationen als gesonderte Host- und Portwerte eingeben
Wenn dieses Optionsfeld ausgewählt ist, wird die Verbindung zum IBM MQ-Warteschlangenmanager unter Verwendung der Informationen hergestellt, die in den Hostnamens- und Porteigenschaften angegeben sind.
Bei Auswahl dieser Option werden die Eigenschaften "Hostname" und "Port" aktiviert und die Eigenschaft "Liste der Verbindungsnamen" wird inaktiviert. Wenn Sie Informationen in eine Liste mit Verbindungsnamen eingeben möchten, klicken Sie auf das Optionsfeld für die Eingabe der Host- und Portinformationen in einer Liste mit Verbindungsnamen.
Dieses Optionsfeld ist nur verfügbar, wenn die Eigenschaft "Geltungsbereich" eine Zelle oder einen Cluster angibt oder wenn die Eigenschaft "Geltungsbereich" einen Knoten oder Server angibt und auf diesem Knoten bzw. Server WebSphere Application Server Version 8.0 oder höher ausgeführt wird.
Information | Wert |
---|---|
Datentyp | Optionsfeld |
Hostname
Der Hostname, die IPv4-Adresse oder die IPv6-Adresse des IBM MQ-Warteschlangenmanagers, zu dem eine Verbindung hergestellt werden soll.
Information | Wert |
---|---|
Datentyp | String |
Port
Die Nummer des Ports, an dem IBM MQ empfangsbereit ist.
Information | Wert |
---|---|
Datentyp | Integer |
Standardeinstellung | 1414 |
Einstellmöglichkeiten | 1 bis 65536 (einschließlich) |
Host- und Portinformationen als Verbindungsnamensliste eingeben
Wenn dieses Optionsfeld ausgewählt ist, wird die Verbindung zum IBM MQ-Warteschlangenmanager unter Verwendung der Informationen hergestellt, die in der Eigenschaft "Verbindungsnamensliste" angegeben sind.
Verbindungsnamenslisten können verwendet werden, um eine Verbindung zu einem einzigen Warteschlangenmanager oder zu einem Warteschlangenmanager mit mehreren Instanzen herzustellen. Weitere Informationen zur Verwendung des Warteschlangenmanagers für mehrere Instanzen finden Sie im Information Center von IBM MQ. Bei Auswahl dieser Option wird die Eigenschaft "Liste der Verbindungsnamen" aktiviert und die Eigenschaften "Hostname" und "Port" werden inaktiviert. Wenn Sie gesonderte Host- und Portinformationen eingeben möchten, klicken Sie auf Host- und Portinformationen als gesonderte Host- und Portwerte eingeben.
Dieses Optionsfeld ist nur verfügbar, wenn die Eigenschaft "Geltungsbereich" eine Zelle oder einen Cluster angibt oder wenn die Eigenschaft "Geltungsbereich" einen Knoten oder Server angibt und auf diesem Knoten bzw. Server WebSphere Application Server Version 8.0 oder höher ausgeführt wird.
Information | Wert |
---|---|
Datentyp | Optionsfeld |
Liste der Verbindungsnamen
Die Liste der Verbindungsnamen mit den Detailangaben zu Hostname und Port, die verwendet werden müssen, wenn die Verbindungsfactory eine Verbindung zu einem Warteschlangenmanager für mehrere Instanzen herstellen soll.
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.
Information | Wert |
---|---|
Datentyp | String |
Standardeinstellung | Nicht zugewiesen |
Einstellmöglichkeiten | Der Wert für dieses Feld muss als Zeichenfolge in folgendem Format eingegeben werden: Host[(Port)][,Host(Port)] Die Portinformationen sind optional. Wenn keine Portinformationen angegeben werden, wird standardmäßig Port 1414 verwendet. Host muss ein gültiger TCP/IP-Hostname bzw. eine gültige IPv4- oder IPv6-Adresse sein. Port muss ein ganzzahliger Wert im Bereich von 1 bis einschließlich 65536 sein. Beispiel: localhost(1234),remotehost1(1234),remotehost2 |
Wenn die Eigenschaft "Liste der Verbindungsnamen" angegeben ist, werden für die Eigenschaften "Hostname" oder "Port" automatisch der Hostname und die Portnummer des ersten Eintrags in der Liste der Verbindungsnamen verwendet. Wenn Sie also localhost(1234),remotehost1(1234),remotehost2 angeben, wird der Hostname auf "localhost" und der Port auf "1234" gesetzt.
Diese Eigenschaft ist nur verfügbar, wenn die Eigenschaft "Geltungsbereich" eine Zelle oder einen Cluster angibt oder wenn die Eigenschaft "Geltungsbereich" einen Knoten oder Server angibt und auf diesem Knoten bzw. Server WebSphere Application Server oder höher ausgeführt wird.
Bei Verwendung in einer heterogenen Zellenumgebung sind die Informationen in der Verbindungsnamensliste für frühere Versionen von WebSphere Application Server als Version 8.0 nicht verfügbar. In diesem Fall werden die Werte aus den Feldern "Hostname" und "Port" des ersten Eintrags in der Liste der Verbindungsnamen verwendet.
Serververbindungskanal
Der Name des Serververbindungskanals des IBM MQ-Servers, der verwendet wird, wenn eine Verbindung zu IBM MQ hergestellt wird.
Information | Wert |
---|---|
Datentyp | String |
Standardeinstellung | SYSTEM.DEF.SVRCONN |
Einstellmöglichkeiten | Der Wert muss ein Serververbindungskanal sein, der für den IBM MQ-Warteschlangenmanager definiert ist, zu dem eine Verbindung hergestellt wird. |
SSL für die Sicherung der Kommunikation mit IBM MQ verwenden
Diese Option bestimmt, ob das Protokoll SSL (Secure Sockets Layer) verwendet wird, um die Kommunikation mit dem IBM MQ-Warteschlangenmanager bzw. mit der Gruppe mit gemeinsamer Warteschlange über das Netz zu sichern.
Wenn Sie die Topicverbindungsfactory eines IBM MQ-Messaging-Providers in einer Anwendungsserverumgebung verwenden, verwaltet der Anwendungsserver die SSL-Konfiguration. Zum Ändern der SSL-Konfigurationsparameter navigieren Sie in der Administrationskonsole zur Anzeige .
Wenn Sie eine Topicverbindungsfactory eines IBM MQ-Messaging-Providers in der Clientumgebung verwenden, entnimmt der Client die SSL-Konfigurationsdaten der Datei "ssl.client.props". Die Verwendung dieser Datei ist in den Referenzinformationen zu diesem Thema ausführlich beschrieben.
In der SSL-Konfiguration für eine Topicverbindungsfactory des IBM MQ-Messaging-Providers kann nur eine einzige Cipher Suite verwendet werden. Wenn Sie mehrere Cipher Suites angeben, wird nur die erste verwendet.
Information | Wert |
---|---|
Datentyp | Kontrollkästchen. Wenn dieses Kontrollkästchen abgewählt ist, sind die folgenden SSL-Eigenschaften inaktiviert:
|
Zentral verwaltet
Wenn das Protokoll SSL für die Kommunikation mit IBM MQ verwendet wird, wählen Sie dieses Optionsfeld aus, um anzugeben, dass die SSL-Konfiguration der zentral verwalteten SSL-Konfiguration von WebSphere Application Server entnommen werden soll.
Wenn Sie dieses Optionsfeld auswählen, werden die Attribute "Hostname" und "Port" aus der Verbindungsfactory des IBM MQ-Messaging-Providers verwendet, um eine entsprechende SSL-Konfiguration auszuwählen. Wenn der Hostname und der Port einer Liste mit Verbindungsnamen entnommen werden, bedeutet das, dass die entsprechenden Angaben des ersten Eintrags in der Liste verwendet werden, um eine entsprechende SSL-Konfiguration auszuwählen. Informationen zum Festlegen der SSL-Konfiguration, die der Verbindungsfactory zugeordnet wird, finden Sie im Artikel "Einstellungen der SSL-Konfiguration für dynamische abgehende Endpunkte" unter "Zugehörige Referenzen".
Information | Wert |
---|---|
Datentyp | Optionsfeld |
Spezielle Konfiguration
Wählen Sie dieses Optionsfeld aus, um eine bestimmte SSL-Konfiguration anzugeben, die verwendet werden soll, wenn SSL für die Sicherung der Netzkommunikation mit dem IBM MQ-Warteschlangenmanager bzw. mit der Gruppe mit gemeinsamer Warteschlange verwendet wird.
Information | Wert |
---|---|
Datentyp | Optionsfeld |
SSL-Konfiguration
Die zu verwendende SSL-Konfiguration, wenn SSL für die Sicherung der Netzkommunikation mit dem IBM MQ-Warteschlangenmanager bzw. der Gruppe mit gemeinsamer Warteschlange verwendet werden soll.
Diese Eigenschaft ist inaktiviert, wenn das Optionsfeld Zentral verwaltet ausgewählt ist und die Ressource für den IBM MQ-Messaging-Provider explizit definiert wurde.
Diese Eigenschaft ist immer aktiviert, wenn die Ressource für den IBM MQ-Messaging-Provider auf einer Definitionstabelle für Clientkanäle basiert.
Wenn diese Ressource für den IBM MQ-Messaging-Provider auf einer Definitionstabelle für Clientkanäle basiert, wird dieser Parameter nur verwendet, wenn die relevanten Einträge in der Definitionstabelle für Clientkanäle für die Verwendung von SSL konfiguriert wurden.
Wenn Sie Ohne für "SSL-Konfiguration" auswählen, wird die zentral verwaltete SSL-Standardkonfiguration von WebSphere Application Server für den IBM MQ-Messaging-Provider verwendet.
Information | Wert |
---|---|
Datentyp | Dropdown-Liste |
Erweitert
Client-ID
Die Clientkennung, die angegeben werden muss, wenn eine Verbindung zum IBM MQ-Messaging-Provider hergestellt wird.
Information | Wert |
---|---|
Datentyp | String |
Geklonte permanente Subskriptionen zulassen
Eine Option, die bestimmt, ob mehrere Instanzen einer permanenten Subskription gleichzeitig von unterschiedlichen Servern aufgerufen werden können.
Information | Wert |
---|---|
Datentyp | Kontrollkästchen |
Standardeinstellung | Nicht ausgewählt |
Einstellmöglichkeiten |
|
Providerversion
Die Version des IBM MQ-Messaging-Providers. Diese Einstellung wird verwendet, um zu bestimmen, ob eine Verbindung zu einer bestimmten Version eines Warteschlangenmanagers hergestellt werden soll. Sie wird auch verwendet, um den Typ der vom Client benötigten Funktionalität zu bestimmen.
Information | Wert |
---|---|
Datentyp | String |
Einstellmöglichkeiten | Der eingegebene Wert muss eine leere Zeichenfolge sein oder eines der folgenden Formate haben:
Beispiel: 6.0.0.0. |
Protokoll für verteilte zweiphasige Festschreibung unterstützen
Eine Option, die angibt, ob die Topicverbindungsfactory die XA-Koordination von Messaging-Transaktionen unterstützt. Aktivieren Sie diese Option, wenn mehrere Ressourcen, einschließlich dieser Topicverbindungsfactory, in derselben Transaktion verwendet werden sollen.
Wenn Sie diese Eigenschaft abwählen, inaktivieren Sie damit die Unterstützung für das verteilte Protokoll für zweiphasige Festschreibung. Die JMS-Sitzung kann zwar weiterhin in einer Transaktion registriert werden, aber sie verwendet die lokalen Transaktionsaufrufe des Ressourcenmanagers session.commit und session.rollback, anstelle der XA-Aufrufe. Dies kann zu einer Leistungsverbesserung führen. Es bedeutet jedoch auch, dass nur eine einzige Ressource bei einer Transaktion in WebSphere Application Server registriert werden kann.
Mit der Unterstützung für den letzten Teilnehmer können Sie eine Nicht-XA-Ressource zusammen mit anderen XA-Ressourcen registrieren.
Information | Wert |
---|---|
Datentyp | Kontrollkästchen |
Standardeinstellung | Ausgewählt |
Einstellmöglichkeiten |
|
Aktivieren Sie XA nicht, wenn der in der Topicverbindungsfactory angegebene Warteschlangenmanager die einzige Ressource in der Transaktion ist. Aktivieren Sie XA, wenn andere Ressourcen, einschließlich anderer Warteschlangen und Topics, an der Transaktion beteiligt sind.
Sicherheitseinstellungen
Authentifizierungsalias für XA-Wiederherstellung
Die Benutzername/Kennwort-Kombination, die während der XA-Wiederherstellung für die Verbindungsherstellung zu IBM MQ verwendet werden soll.
Information | Wert |
---|---|
Datentyp | Dropdown-Liste |
Standardeinstellung | (ohne) |
Einstellmöglichkeiten | Alle Authentifizierungsalias, die in der Zelle definiert sind, und der Wert "(leer)", der angibt, dass während der XA-Wiederherstellung keine Berechtigungsnachweise an IBM MQ übergeben werden. |
Alias für Konfigurationszuordnung
Dieses Feld wird nur verwendet, wenn keine Anmeldekonfiguration in der Komponentenressourcenreferenz enthalten ist.
Wenn "Container" als Wert für die Ressourcenberechtigung festgelegt ist, ist die bevorzugte Methode für die Definition der Authentifizierungsstrategie die Angabe einer Anmeldekonfiguration und zugeordneter Eigenschaften in der Komponentenressourcenreferenz.
Wenn die Anmeldekonfiguration DefaultPrincipalMapping angegeben wird, ist die zugeordnete Eigenschaft ein JAAS/J2C-Authentifizierungsdateneintrag. Zum Konfigurieren der Authentifizierungsdaten für die Topicverbindungsfactory klicken Sie unter "Zugehörige Elemente" auf JAAS/J2C-Authentifizierungsdaten.
Information | Wert |
---|---|
Datentyp | Dropdown-Liste |
Standardeinstellung | (ohne) |
Einstellmöglichkeiten | Die folgenden Optionen sind verfügbar:
|
Containergesteuerter Authentifizierungsalias
Der Authentifizierungsalias, der den Benutzernamen und das Kennwort angibt, die verwendet werden sollen, wenn eine Verbindung zum IBM MQ-Messaging-Provider hergestellt wird.
Information | Wert |
---|---|
Datentyp | Dropdown-Liste |
Standardeinstellung | (ohne) |
Einstellmöglichkeiten | Alle Authentifizierungsaliasnamen, die in der Zelle definiert sind, und der Wert "(leer)", der angibt, dass keine Berechtigungsnachweise an IBM MQ übergeben werden. |