Einstellungen für Aktivierungsspezifikationen des WebSphere-MQ-Messaging-Providers

Verwenden Sie diese Anzeige, um die Konfigurationseigenschaften der ausgewählten Aktivierungsspezifikation für den WebSphere-MQ-Messaging-Provider anzuzeigen oder zu ändern. Diese Konfigurationseigenschaften steuern, wie Verbindungen zu den zugeordneten Warteschlangen und Topics erstellt werden.

Führen Sie zum Anzeigen der Einstellungen einer WebSphere-MQ-Aktivierungsspezifikation in der Administrationskonsole die folgenden Schritte aus:
  1. Klicken Sie im Navigationsfenster auf Ressourcen > JMS > Aktivierungsspezifikationen, um vorhandene Aktivierungsspezifikationen anzuzeigen.
  2. Ä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.
  3. Wählen Sie den Namen der Aktivierungsspezifikation aus, mit der Sie arbeiten möchten.
Unter "Allgemeine Eigenschaften" werden fünf Gruppen von Eigenschaften angezeigt:
Nehmen Sie alle erforderlichen Änderungen an den Eigenschaftengruppen für die Verwaltungs-, Destination-, Verbindungs-, Sicherheits- und erweiterten Einstellungen vor, und klicken Sie anschließend auf Anwenden, um die Konfiguration zu speichern, bevor Sie im Inhaltsteilfenster unter "Weitere Eigenschaften" auf einen der folgenden Links klicken:

Klicken Sie unter "Zugehörige Elemente" auf JAAS - J2C-Authentifizierungsdaten, um Authentifizierungsinformationen für die Aktivierungsspezifikation zu konfigurieren.

Sie können die Eigenschaft -localAddress auch mit Hilfe von WebSphere-MQ-Verwaltungsbefehlen angeben. Weitere Informationen zu dieser Eigenschaft finden Sie im Artikel Befehl "createWMQActivationSpec".

Anmerkung: Wenn Sie WebSphere-MQ-Eigenschaften angeben, müssen die folgenden Einschränkungen berücksichtigt werden:

Eine WebSphere-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, Namespace-Bindungen 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 "WebSphere-MQ-Aktivierungsspezifikationen", und klicken Sie anschließend auf Anwenden, bevor Sie auf den Link für den Ressourcentyp klicken.

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 WebSphere-MQ-Messaging-Provider.

Der Provider wird nur zu Informationszwecken angezeigt.

Datentyp String
Name

Der Name, unter dem diese Aktivierungsspezifikation für Verwaltungszwecke in WebSphere Application Server geführt wird.

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.

Datentyp String
Beschreibung

Eine Beschreibung dieser Aktivierungsspezifikation für Verwaltungszwecke in WebSphere Application Server.

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.

Wenn die ausgewählte Aktivierungsspezifikation mit einer CCDT erstellt wurde, werden nur die folgenden Eigenschaften angezeigt:
  • URL der Definitionstabelle für Client-Channel
  • Warteschlangenmanager
  • SSL-Konfiguration
Wenn die ausgewählte Aktivierungsspezifikation nicht über eine CCDT erstellt wurde, werden die folgenden Eigenschaften angezeigt:
  • Warteschlangenmanager
  • Transport
  • Hostname
  • Port
  • Channel der Serververbindung
  • Wenn Sie das Kontrollkästchen für die Eigenschaft SSL für die sichere Kommunikation mit WebSphere MQ verwenden abwählen, können die folgenden Eigenschaften nicht angezeigt werden:
    • Zentral verwaltet
    • Spezielle Konfiguration
    • SSL-Konfiguration

Weitere Informationen zum Festlegen der SSL-Eigenschaften für WebSphere MQ finden Sie im Abschnitt SSL properties in der WebSphere-MQ-Veröffentlichung "Using Java".

Anmerkung: Die folgenden vier Verbindungseigenschaften von WebSphere MQ beeinträchtigen die Aktivierungsspezifikation:
  • maxConnections
  • connectionConcurrency
  • reconnectionRetryCount
  • reconnectionRetryInterval
Obwohl diese Eigenschaften das Verhalten der Aktivierungsspezifikation von WebSphere MQ steuern, werden sie als angepasste Eigenschaften des WebSphere-MQ-Messaging-Providers konfiguriert. Weitere Informationen zu diesen vier Verbindungseigenschaften und zu ihrer Konfiguration finden Sie im Artikel Angepasste Eigenschaften für den WebSphere-MQ-Messaging-Provider konfigurieren.
URL der Definitionstabelle für Client-Channel

Ein URL, der die Position einer WebSphereMQ-Definitionstabelle für Client-Channel (CCDT, Client Channel Definition Table) angibt.

Datentyp String
Warteschlangenmanager

Wenn die angegebene Aktivierungsspezifikation auf einer Definitionstabelle für Client-Channel 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 empfangen.

Datentyp String
Einstellmöglichkeiten Wenn diese Aktivierungsspezifikation nicht auf einer Definitionstabelle für Client-Channel basiert, muss der Wert der gültige Name eines Warteschlangenmanagers sein.
Wenn diese Aktivierungsspezifikation auf einer Definitionstabelle für Client-Channel basiert, müssen Sie einen der folgenden Werte angeben:
  • gültiger Name eines Warteschlangenmanagers,
  • Leer1
1Wenn Sie den Wert der Eigenschaft des Warteschlangenmanagers in diesem Format in Kombination mit einer Definitionstabelle für Client-Channel angeben, können Sie einzelne Verbindungen, die Sie gemäß Aktivierungsspezifikation eingerichtet haben, zu verschiedenen Warteschlangenmanagern herstellen. Die Auswahl aus mehreren Warteschlangenmanagern kommt zum Tragen, wenn die Definitionstabelle für Client-Channel mehrere Channel-Definitionen für Clientverbindungen mit übereinstimmendem Namen des Warteschlangenmanagers (Parameter QMNAME) enthält, und diese Channel-Definitionen die Netzverbindungsdetails verschiedener Warteschlangenmanager definieren.

Globale Transaktionen dürfen nicht mit einer Aktivierungsspezifikation verwendet werden, die so konfiguriert ist, dass über eine Definitionstabelle für Client-Channel eine Auswahl aus mehreren Warteschlangenmanagern stattfindet, da der Transaktionsmanager möglicherweise nicht in der Lage ist, globale Transaktionen nach einem Fehler wiederherzustellen.

Transport

Der WebSphere-MQ-Transporttyp für die Verbindung. Der Transporttyp wird verwendet, um die genauen Mechanismen zu bestimmen, die für die Verbindungsherstellung zu WebSphere MQ verwendet werden.

Datentyp Dropdown-Liste
Standardeinstellung Bindungen, dann Client
Einstellmöglichkeiten
Client
Verwenden Sie eine TCP/IP-basierte Netzverbindung für die Kommunikation mit dem WebSphere-MQ-Warteschlangenmanager.
Bindungen, dann Client
Es wird versucht, eine Verbindung im Bindungsmodus zum Warteschlangenmanager herzustellen. Wenn dies nicht möglich, wird auf den Clienttransport zurückgegriffen.
Bindungen
Es wird eine speicherübergreifende Verbindung zu einem Warteschlangenmanager hergestellt, der auf demselben Knoten ausgeführt wird. Die folgenden Eigenschaften für den Clienttransportmodus sind inaktiviert:
  • Hostname
  • Port
  • Channel der Serververbindung
Weitere Informationen zur Konfiguration des Transporttyps Bindungen, dann Client oder Bindungen finden Sie in den Abschnitten WebSphere-MQ-Messaging-Provider mit Informationen zu nativen Bibliotheken konfigurieren und Größe der vom WebSphere-MQ-Messaging-Provider verwendeten Thread-Pools festlegen.

Die Informationen zum Festlegen der Größe der Thread-Pools, die vom WebSphere-MQ-Messaging-Provider verwendet werden, sind für Fixpack 5 und höher nicht relevant, da der WMQCommonServices-Thread-Pool nicht mehr verwendet wird.

Hostname

Der Hostname, die IPv4-Adresse oder die IPv6-Adresse des WebSphere-MQ-Warteschlangenmanagers, zu dem eine Verbindung hergestellt werden soll.

Datentyp String
Port

Die Nummer des Ports, an dem WebSphere MQ empfangsbereit ist.

Datentyp Integer
Standardeinstellung 1414
Einstellmöglichkeiten 1 bis 65536 (einschließlich)
Channel der Serververbindung

Der Name des Verbindungs-Channels des WebSphere-MQ-Servers, der verwendet wird, wenn eine Verbindung zu WebSphere MQ hergestellt wird.

Datentyp String
Standardeinstellung SYSTEM.DEF.SVRCONN
Einstellmöglichkeiten Der Wert muss ein Channel der Serververbindung sein, der für den WebSphere-MQ-Warteschlangenmanager definiert ist, zu dem eine Verbindung hergestellt wird.
SSL für die Sicherung der Kommunikation mit WebSphere MQ verwenden

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 Aktivierungsspezifikation 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 Sicherheit > Verwaltung von SSL-Zertifikaten und Schlüsseln .

In der SSL-Konfiguration für eine Aktivierungsspezifikation des WebSphere-MQ-Messaging-Providers kann nur eine einzige Cipher Suite verwendet werden. Wenn Sie mehrere Cipher Suites angeben, wird nur die erste verwendet.

Datentyp Kontrollkästchen. Wenn dieses Kontrollkästchen abgewählt ist, sind die folgenden SSL-Eigenschaften inaktiviert:
  • Zentral verwaltet
  • Spezielle Konfiguration
  • SSL-Konfiguration
Zentral verwaltet

Wenn das Protokoll SSL für die Kommunikation mit WebSphere 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 WebSphere-MQ-Messaging-Providers verwendet, 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".

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 WebSphere-MQ-Warteschlangenmanager bzw. mit der Gruppe mit gemeinsamer Warteschlange verwendet wird.

Datentyp Optionsfeld
SSL-Konfiguration

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 Client-Channel basiert.

Wenn diese Ressource für den WebSphere-MQ-Messaging-Provider auf einer Definitionstabelle für Client-Channel basiert, wird dieser Parameter nur verwendet, wenn die relevanten Einträge in der Definitionstabelle für Client-Channel 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.

Datentyp Dropdown-Liste
Destination
JNDI-Name der Destination

Der JNDI-Name der JMS-Destination, von der Nachrichten für die Zustellung an eine Message-driven Bean konsumiert werden, die für die Verwendung dieser Aktivierungsspezifikation konfiguriert ist.

Datentyp String
Nachrichtenselektor

Ein Nachrichtenselektorausdruck, der angibt, welche Nachrichten zugestellt werden sollen.

Datentyp String
Destination-Typ

Der Typ der Destination (Warteschlange oder Topic), von der Nachrichten konsumiert werden.

Datentyp Dropdown-Liste
Einstellmöglichkeiten
Warteschlange
Der JNDI-Name der Destination verweist auf eine JMS-Destination, die eine Warteschlange ist.
Topic
Der JNDI-Name der Destination verweist auf eine JMS-Destination, die ein Topic ist.
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.

Datentyp Kontrollkästchen
Standardeinstellung Abgewählt (nicht permanent)
Einstellmöglichkeiten
Nicht ausgewählt
Nicht permanent
Ausgewählt
Permanent
Subskriptionsname

Der Name einer permanenten Subskription. Diese Option ist nur verfügbar, wenn das Kontrollkästchen Permanente Subskription ausgewählt ist.

Datentyp String
Erweitert
Client-ID

Die Clientkennung, die angegeben werden muss, wenn eine Verbindung zum WebSphere-MQ-Messaging-Provider hergestellt wird.

Datentyp String
Geklonte permanente Subskriptionen zulassen

Eine Option, die bestimmt, ob mehrere Instanzen einer permanenten Subskription gleichzeitig von unterschiedlichen Servern aufgerufen werden können.

Datentyp Kontrollkästchen
Standardeinstellung Nicht ausgewählt
Einstellmöglichkeiten
Ausgewählt
Es können mehrere Instanzen einer permanenten Subskription gleichzeitig von unterschiedlichen Servern aufgerufen werden.
Nicht ausgewählt
Es können nicht mehrere Instanzen einer permanenten Subskription gleichzeitig von unterschiedlichen Servern aufgerufen werden.
Providerversion

Die Version des WebSphere-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.

Anmerkung: Wenn diese Aktivierungsspezifikation vor Fixpack 5 verwendet wird, um eine Verbindung zu einem Warteschlangenmanager oder einer Gruppe mit gemeinsamer Warteschlange auf einem System mit WebSphere MQ for z/OS herzustellen, geben Sie den Wert 6.0.0.0 für die Eigenschaft Providerversion an. Die Verbindungs-Factory muss diese Providerversion verwenden, unabhängig von der Version von WebSphere MQ for z/OS, zu dem die Verbindung hergestellt wird.

Wenn diese Aktivierungsspezifikation mit Fixpack 5 oder höher verwendet wird, um eine Verbindung zu einem Warteschlangenmanager oder einer Gruppe mit gemeinsamer Warteschlange auf einem System mit WebSphere MQ for z/OS herzustellen, geben Sie den Wert 6.0.0.0 für die Eigenschaft Providerversion an.

Für Fixpack 7 oder höher gilt die Einschränkung der Providerversion nicht mehr.

Datentyp String
Einstellmöglichkeiten Der eingegebene Wert muss eine leere Zeichenfolge sein oder eines der folgenden Formate haben:
  • n.n.n.n
  • n.n.n
  • n.n
  • n
In diesen Formaten steht "n" für einen numerischen Wert größer-gleich null.

Beispiel: 6.0.0.0.

Sicherheitseinstellungen
Authentifizierungsalias

Die Benutzername/Kennwort-Kombination, die für die Verbindungsherstellung zu WebSphere MQ verwendet werden soll.

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 WebSphere MQ übergeben werden.



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

Zugehörige Konzepte
Zugehörige Tasks
Zugehörige Verweise
Aktivierungsspezifikation
WebSphere-MQ-Bibliothek (online)


Dateiname: umj_pasm.html