Verwenden Sie diese Anzeige, um die Konfigurationseigenschaften der ausgewählten Verbindungsfactory für den WebSphere-MQ-Messaging-Provider anzuzeigen oder zu ändern. Diese Konfigurationseigenschaften steuern, wie Verbindungen zu den zugeordneten JMS-Warteschlangen und -Topics erstellt werden.
Der WebSphere-MQ-Messaging-Provider unterstützt domänenunabhängige Schnittstellen der JMS Version 1.1, wie z. B. die einheitliche JMS-Verbindungsfactory. Eine domänenunabhängige Anwendung kann dieselbe Schnittstelle für Punkt-zu-Punkt- und Publish/Subscribe-Messaging verwenden und Punkt-zu-Punkt- und Publish/Subscribe-Messging in derselben Transaktion unterstützen. Bei JMS 1.1 wird empfohlen, domänenunabhängige einheitliche JMS-Verbindungsfactorys für neue Anwendungen zu verwenden. Eine domänenspezifische Schnittstelle erweitert die entsprechende domänenunabhängige Schnittstelle so, dass eine Anwendung, die domänenspezifische Warteschlangen- und Topicverbindungsfactorys verwendet, zwischen den beiden Schnittstellen wählen kann.
Sie können unter "Zugehörige Elemente" auf JAAS - J2C-Authentifizierungsdaten klicken, um Authentifizierungsinformationen für die Verbindungsfactory zu konfigurieren.
Wenn die WebSphere-MQ-Funktionalität auf einer Ebene inaktiviert wurde, die sich auf diese WebSphere-MQ-Messaging-Providerressource auswirkt, wird eine Informationsnachricht angezeigt, die darauf hinweist, dass IBM MQ inaktiviert wurde. In einer Einzelserverumgebung wird diese Informationsnachricht nur angezeigt, wenn der Server nach der Inaktivierung der WebSphere-MQ-Funktionalität erneut gestartet wurde. In einer Network-Deployment-Umgebung wird die Informationsnachricht sofort angezeigt. Nähere Informationen finden Sie im Artikel WebSphere-MQ-Funktionalität in WebSphere Application Server inaktivieren.
Eine einheitliche WebSphere-MQ-Verbindungsfactory hat die folgenden Eigenschaften.
Gibt die Stufe an, bis zu der diese Verbindungsfactorydefinition 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 andere Ressourcen in einem anderen Geltungsbereich anzeigen oder ändern möchten, müssen Sie in der Anzeige mit der Sammlung der Verbindungsfactorys den Geltungsbereich ändern und anschließend auf Anwenden klicken, bevor Sie auf den Link für den Ressourcentyp klicken.
| Information | Wert |
|---|---|
| Datentyp | String |
Der JMS-Provider, der beim Erstellen der Warteschlangenverbindungsfactory zugeordnet wird.
Der Provider für alle Verbindungsfactorys, die über diese Anzeige erstellt werden, ist der WebSphere-MQ-Messaging-Provider.
Der Provider wird nur zu Informationszwecken angezeigt.
| Information | Wert |
|---|---|
| Datentyp | String |
Der Name, unter dem diese Verbindungsfactory für Verwaltungszwecke in WebSphere Application Server geführt wird.
| Information | Wert |
|---|---|
| Datentyp | String |
| Einstellmöglichkeiten | Der Name muss innerhalb der Gruppe der Verbindungsfactorys, die in der der Zelle definiert sind, eindeutig sein. |
Der JNDI-Name, der verwendet wird, um die Verbindungsfactory 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 |
Eine Beschreibung dieser Verbindungsfactory für Verwaltungszwecke in WebSphere Application Server.
| Information | Wert |
|---|---|
| Datentyp | String |
| Standardeinstellung | Null |
Die zum Konfigurieren einer Verbindung erforderlichen Informationen richten sich danach, ob die ausgewählte Warteschlangenverbindungsfactory mit einer CCDT erstellt wurde.
Weitere Informationen zum Festlegen der SSL-Eigenschaften für IBM MQ finden Sie im Abschnitt SSL properties der Veröffentlichung Using Java im Information Center von IBM MQ.
Ein URL, der die Position einer WebSphereMQ-Definitionstabelle für den Clientkanal (CCDT, Client Channel Definition Table) angibt.
| Information | Wert |
|---|---|
| Datentyp | String |
Wenn die angegebene Verbindungsfactory auf einer Definitionstabelle für Clientkanäle 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 WebSphere-MQ-Ressource hergestellt, um Nachrichten zu senden und zu empfangen.
| Information | Wert |
|---|---|
| Datentyp | String |
| Einstellmöglichkeiten | Wenn diese Verbindungsfactory nicht auf einer Definitionstabelle für Clientkanäle basiert, muss der Wert der gültige Name eines Warteschlangenmanagers sein.
Wenn diese Verbindungsfactory auf einer Definitionstabelle für Clientkanäle
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:
|
Der WebSphere-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 |
|
Wenn dieses Optionsfeld ausgewählt ist, wird die Verbindung zum WebSphere-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 |
Der Hostname, die IPv4-Adresse oder die IPv6-Adresse des WebSphere-MQ-Warteschlangenmanagers, zu dem eine Verbindung hergestellt werden soll.
| Information | Wert |
|---|---|
| Datentyp | String |
Die Nummer des Ports, an dem IBM MQ empfangsbereit ist.
| Information | Wert |
|---|---|
| Datentyp | Integer |
| Standardeinstellung | 1414 |
| Einstellmöglichkeiten | 1 bis 65536 (einschließlich) |
Wenn dieses Optionsfeld ausgewählt ist, wird die Verbindung zum WebSphere-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 |
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 | Dieses Feld muss auf eine Zeichenfolge mit dem folgenden Format gesetzt 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 Version 8.0 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.
Der Name des Verbindungskanals des WebSphere-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 WebSphere-MQ-Warteschlangenmanager definiert ist, zu dem eine Verbindung hergestellt wird. |
Diese Option bestimmt, ob das Protokoll SSL (Secure Sockets Layer) verwendet wird, um die Netzkommunikation mit dem WebSphere-MQ-Warteschlangenmanager bzw. mit der Gruppe mit gemeinsamer Warteschlange zu sichern.
Wenn Sie die Verbindungsfactory eines WebSphere-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 Verbindungsfactory des WebSphere-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 Verbindungsfactory des WebSphere-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:
|
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 WebSphere-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 |
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 WebSphere-MQ-Warteschlangenmanager bzw. mit der Gruppe mit gemeinsamer Warteschlange verwendet wird.
| Information | Wert |
|---|---|
| Datentyp | Optionsfeld |
Die zu verwendende SSL-Konfiguration, wenn SSL für die Sicherung der Netzkommunikation mit dem WebSphere-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 WebSphere-MQ-Messaging-Provider explizit definiert wurde.
Diese Eigenschaft ist immer aktiviert, wenn die Ressource für den WebSphere-MQ-Messaging-Provider auf einer Definitionstabelle für Clientkanäle basiert.
Wenn diese Ressource für den WebSphere-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 WebSphere-MQ-Messaging-Provider verwendet.
| Information | Wert |
|---|---|
| Datentyp | Dropdown-Liste |
Die Clientkennung, die angegeben werden muss, wenn eine Verbindung zum WebSphere-MQ-Messaging-Provider hergestellt wird.
Die Clientidentität ist keine Benutzer-ID im üblichen Sinne und ist nicht sicherheitsrelevant. Sie wird von permanenten Subskriptionen im Publish/Subscribe-Messaging verwendet. Eine permanente Subskription erfasst Nachrichten, wenn der Subskribent "abwesend" ist (z. B. inaktiv oder fehlerhaft) und stellt diese Nachrichten bereit, wenn der Subskribent die Verbindung wiederherstellt. Die Clientidentität ist das Token, das angibt, welcher Subskribent Sie sind, wenn Sie eine Verbindung wiederherstellen, damit Sie die Nachrichten, die in Ihrer Abwesenheit erfasst wurden, abrufen können.
| Information | Wert |
|---|---|
| Datentyp | String |
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 |
|
Die Version des WebSphere-MQ-Messaging-Providers. Dieser Wert 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. |
Eine Option, die angibt, ob die Verbindungsfactory die XA-Koordination von Messaging-Transaktionen unterstützt. Aktivieren Sie diese Option, wenn mehrere Ressourcen, einschließlich dieser Verbindungsfactory, 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 |
|
Lassen Sie diese Option ausgewählt, wenn andere Ressourcen, einschließlich anderer Warteschlangen und Topics, an der Transaktion beteiligt sind. Wählen Sie diese Option nur ab, wenn Sie sicher sind, dass der verbundene Warteschlangenmanager, der diese Warteschlangenverbindung verwendet, die einzige Ressource in der Transaktion ist.
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 | (keine) |
| 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. |
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 Verbindungsfactory klicken Sie unter "Zugehörige Elemente" auf JAAS/J2C-Authentifizierungsdaten.
| Information | Wert |
|---|---|
| Datentyp | Dropdown-Liste |
| Standardeinstellung | (keine) |
| Einstellmöglichkeiten | Die folgenden Optionen sind verfügbar:
|
Der Authentifizierungsalias, der den Benutzernamen und das Kennwort angibt, die verwendet werden sollen, wenn eine Verbindung zum WebSphere-MQ-Messaging-Provider hergestellt wird.
| Information | Wert |
|---|---|
| Datentyp | Dropdown-Liste |
| Standardeinstellung | (keine) |
| Einstellmöglichkeiten | Alle Authentifizierungsalias, die in der Zelle definiert sind, und der Wert "(leer)", der angibt, dass keine Berechtigungsnachweise an IBM MQ übergeben werden. |