Einstellungen für Aktivierungsspezifikationen des IBM MQ-Messaging-Providers
Verwenden Sie diese Anzeige, um die Konfigurationseigenschaften der ausgewählten Aktivierungsspezifikation für den IBM MQ-Messaging-Provider anzuzeigen oder zu ändern. Diese Konfigurationseigenschaften steuern, wie Verbindungen zu den zugeordneten Warteschlangen und Topics erstellt werden.
- Klicken Sie im Navigationsfenster auf , um vorhandene Aktivierungsspezifikationen anzuzeigen.
- Ändern Sie bei Bedarf im Inhaltsteilfenster die Einstellung für den Geltungsbereich in die Ebene, auf der die Aktivierungsspezifikationen definiert sind. Auf diese Weise wird die Gruppe der angezeigten Aktivierungsspezifikationen eingeschränkt.
- Wählen Sie den Namen der Aktivierungsspezifikation aus, mit der Sie arbeiten möchten.
- Erweiterte Eigenschaften: Über diesen Link können Sie die erweiterten Eigenschaften Ihrer IBM MQ-Aktivierungsspezifikation anzeigen oder ändern.
- Brokereigenschaften: Über diesen Link können Sie die Brokereigenschaften Ihrer IBM MQ-Aktivierungsspezifikation anzeigen oder ändern.
- Angepasste Eigenschaften: Über diesen Link können Sie die angepassten Eigenschaften Ihrer IBM MQ-Aktivierungsspezifikation anzeigen oder ändern. Sie können diese Option beispielsweise verwenden, um die angepasste Eigenschaft "WAS_EndpointInitialState" für eine Aktivierungsspezifikation zu definieren. WAS_EndpointInitialState bestimmt, ob der Nachrichtenkonsum am JMS-Ziel beginnt, sobald die Aktivierungsspezifikation verwendet wird, um eine Message-driven Bean mit dem Ziel zu verbinden.
- Eigenschaften des Clienttransports: Über diesen Link können Sie die Clienttransporteigenschaften Ihrer IBM MQ-Aktivierungsspezifikation anzeigen oder ändern. Wenn die ausgewählte Aktivierungsspezifikation nicht über eine Definitionstabelle für Clientkanäle (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 Aktivierungsspezifikation über eine CCDT erstellt wurde, müssen Sie die Clienttransporteigenschaften nicht angeben, und deshalb wird der Link nicht angezeigt.
Klicken Sie unter "Zugehörige Elemente" auf JAAS - J2C-Authentifizierungsdaten, um Authentifizierungsinformationen für die Aktivierungsspezifikation zu konfigurieren.
Sie können die Eigenschaft -localAddress mit dem IBM MQ-Verwaltungsbefehl createWMQActivationSpec angeben.
- 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, die Sie bei der Konfiguration von IBM MQ für JMS-Ressourcen angegeben haben, übereinstimmen. Weitere Informationen finden Sie in den Abschnitten Using Java und System Administration im Information Center von IBM MQ.
Wenn die IBM MQ-Funktionalität auf einer Ebene inaktiviert wurde, die sich auf diese IBM 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 IBM MQ-Funktionalität erneut gestartet wurde. In einer Network-Deployment-Umgebung wird die Informationsnachricht sofort angezeigt.
Eine IBM MQ-Aktivierungsspezifikation 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 (oder andere Ressourcen) in einem anderen Geltungsbereich anzeigen oder ändern möchten, ändern Sie den Geltungsbereich in der Anzeige "IBM MQ-Aktivierungsspezifikationen" und klicken Sie anschließend auf Anwenden, bevor Sie auf den Link für den Ressourcentyp klicken.
Information | Wert |
---|---|
Datentyp | String |
Provider
Der JMS-Provider, der beim Erstellen der Aktivierungsspezifikation zugeordnet wird.
Der Provider für alle Aktivierungsspezifikationen, 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 Aktivierungsspezifikation für Verwaltungszwecke in WebSphere Application Server geführt wird.
Information | Wert |
---|---|
Datentyp | String |
Einstellmöglichkeiten | Der Name muss innerhalb der Gruppe der Aktivierungsspezifikationen, die in der der Zelle definiert sind, eindeutig sein. |
JNDI-Name
Der JNDI-Name, der verwendet wird, um die Aktivierungsspezifikation 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 Aktivierungsspezifikation 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 Aktivierungsspezifikation 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 verwendet 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 IBM MQ Using Java des Information Center von IBM MQ.
- maxConnections
- connectionConcurrency(Wenn diese Eigenschaft gesetzt wird, betrifft das nur die Knoten von WebSphere Application Server 7. Die Eigenschaft hat keine Auswirkungen für Knoten von WebSphere Application Server Version 8 oder höher.)
- reconnectionRetryCount
- reconnectionRetryInterval
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 Aktivierungsspezifikation 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 IBM MQ-Ressource hergestellt, um Nachrichten zu empfangen.
Information | Wert |
---|---|
Datentyp | String |
Einstellmöglichkeiten | Wenn diese Aktivierungsspezifikation nicht auf einer Definitionstabelle für Clientkanäle basiert, muss der Wert der gültige Name eines Warteschlangenmanagers sein.
Wenn diese Aktivierungsspezifikation 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:
|
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 zur Liste der Verbindungsnamen 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 |
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 Aktivierungsspezifikation 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 Version 8.0 oder höher ausgeführt wird.
- Für Knoten, auf denen WebSphere Application Server Version 7.0 Fix Pack 7 oder höher ausgeführt wird, kann die Eigenschaft "Liste der Verbindungsnamen" verwendet werden, um eine Verbindung zu Warteschlangenmanagern für mehrere Instanzen herzustellen.
- Für Knoten, auf denen eine frühere
Fixpackstufe als Version 7.0 ausgeführt wird,
wird die Eigenschaft "Liste der Verbindungsnamen" nicht erkannt, und es wird eine Warnung wie im folgenden Beispiel ausgegeben:
In diesem Fall werden die Informationen in den Eigenschaften für den Hostnamen und den Port verwendet, um die Verbindung zu einem Warteschlangenmanager herzustellen.[29/09/10 12:15:27:468 BST] 00000018 J2CUtilityCla W J2CA0008W: Die Klasse com.ibm.mq.connector.inbound.ActivationSpecImpl, die von Ressource cells/L3A3316Node01Cell/resources.xml#J2CResourceAdapter_1284547647859 verwendet wird, enthält keine Methodengruppe setConnectionNameList. Die Verarbeitung wird fortgesetzt.
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 Aktivierungsspezifikation 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 .
In der SSL-Konfiguration für eine Aktivierungsspezifikation 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 Aktivierungsspezifikation des IBM MQ-Messaging-Providers verwendet, um eine entsprechende SSL-Konfiguration auszuwählen. Wenn der Hostname und der Port über eine Liste der Verbindungsnamen für die Aktivierungsspezifikation bereitgestellt 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 Aktivierungsspezifikation 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 |
Ziel
JNDI-Name des Ziels
Der JNDI-Name des JMS-Ziels, von dem Nachrichten für die Zustellung an eine Message-driven Bean konsumiert werden, die für die Verwendung dieser Aktivierungsspezifikation konfiguriert ist.
Information | Wert |
---|---|
Datentyp | String |
Nachrichtenselektor
Ein Nachrichtenselektorausdruck, der angibt, welche Nachrichten zugestellt werden sollen.
Information | Wert |
---|---|
Datentyp | String |
Zieltyp
Der Typ des Ziels (Warteschlange oder Topic), von dem Nachrichten konsumiert werden.
Information | Wert |
---|---|
Datentyp | Dropdown-Liste |
Einstellmöglichkeiten |
|
Permanente Subskription
Eine Option, mit der angegeben wird, ob eine permanente oder nicht permanente Subskription für die Zustellung von Nachrichten an eine nachrichtengesteuerte Bean (MDB, Message-driven Bean), die das Topic subskribiert, verwendet wird.
Information | Wert |
---|---|
Datentyp | Kontrollkästchen |
Standardeinstellung | Abgewählt (nicht permanent) |
Einstellmöglichkeiten |
|
Subskriptionsname
Der Name einer permanenten Subskription. Diese Option ist nur verfügbar, wenn das Kontrollkästchen Permanente Subskription ausgewählt ist.
Information | Wert |
---|---|
Datentyp | String |
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. |
Sicherheitseinstellungen
Authentifizierungsalias
Die Kombination aus Benutzername und Kennwort, die für die Verbindungsherstellung zu IBM MQ verwendet werden soll.
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. |