Einstellungen für die Warteschlangenverbindungs-Factory des WebSphere-MQ-Messaging-Providers

Verwenden Sie diese Anzeige, um die Konfigurationseigenschaften der ausgewählten Warteschlangenverbindungs-Factory für den WebSphere-MQ-Messaging-Provider anzuzeigen oder zu ändern. Mit diesen Konfigurationseigenschaften wird festgelegt, wie Verbindungen zur zugeordneten Destinations für JMS-Warteschlangen erstellt werden.

Eine Verbindungs-Factory für WebSphere-MQ-Warteschlangen wird verwendet, um JMS-Verbindungen zu Warteschlangen herzustellen, die WebSphere MQ für Punkt-zu-Punkt-Messaging bereitstellt.

Führen Sie zum Anzeigen der Einstellungen einer WebSphere-MQ-Warteschlangenverbindungs-Factory in der Administrationskonsole die folgenden Schritte aus:
  1. Klicken Sie im Navigationsfenster auf Ressourcen > JMS > Warteschlangenverbindungs-Factorys, um vorhandene Warteschlangenverbindungs-Factorys anzuzeigen.
  2. Ändern Sie bei Bedarf im Inhaltsteilfenster die Einstellung für den Geltungsbereich in die Ebene, auf der die Warteschlangenverbindungs-Factorys definiert sind. Auf diese Weise wird die Gruppe der angezeigten Warteschlangenverbindungs-Factorys eingeschränkt.
  3. Wählen Sie den Namen der Warteschlangenverbindungs-Factory aus, mit der Sie arbeiten möchten.
Unter "Allgemeine Eigenschaften" werden vier Gruppen von Eigenschaften angezeigt:

Nehmen Sie alle erforderlichen Änderungen an den Eigenschaftengruppen für die Verwaltungs-, 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" einen der folgenden Links auswählen:

Sie können unter "Zugehörige Elemente" auf JAAS - J2C-Authentifizierungsdaten klicken, um Authentifizierungsinformationen für die Warteschlangenverbindungs-Factory zu konfigurieren.

Sie können die folgenden zusätzlichen Eigenschaften mit WebSphere-MQ-Verwaltungsbefehlen angeben: Weitere Informationen zu diesen Eigenschaften finden Sie im Artikel Befehl "createWMQConnectionFactory".
Anmerkung: Wenn Sie WebSphere-MQ-Eigenschaften angeben, müssen die folgenden Einschränkungen berücksichtigt werden:

Eine WebSphere-MQ-Warteschlangenverbindungs-Factory hat die folgenden Eigenschaften.

Verwaltung
Geltungsbereich

Die Stufe, auf der diese Ressourcendefinition für Anwendungen sichtbar sind.

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-Warteschlangenverbindungs-Factory", 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 Warteschlangenverbindungs-Factory zugeordnet wird.

Der Provider für alle Warteschlangenverbindungs-Factorys, 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 Verbindungs-Factory für Verwaltungszwecke in WebSphere Application Server geführt wird.

Datentyp String
Einstellmöglichkeiten Der Name muss innerhalb der Gruppe der Warteschlangenverbindungs-Factorys, die in der der Zelle definiert sind, eindeutig sein.
JNDI-Name

Der JNDI-Name, der verwendet wird, um die Warteschlangenverbindungs-Factory an den 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 der Verbindungs-Factory 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 Warteschlangenverbindungs-Factory mit einer CCDT erstellt wurde.

Wenn die ausgewählte Warteschlangenverbindungs-Factory 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 Warteschlangenverbindungs-Factory 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".

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 Warteschlangenverbindungs-Factory 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 senden und zu empfangen.

Datentyp String
Einstellmöglichkeiten Wenn diese Warteschlangenverbindungs-Factory nicht auf einer Definitionstabelle für Client-Channel basiert, muss der Wert der gültige Name eines Warteschlangenmanagers sein.
Wenn diese Warteschlangenverbindungs-Factory 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 über die Warteschlangenverbindungs-Factory 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 Warteschlangenverbindungs-Factory 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 Artikeln 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 Warteschlangenverbindungs-Factory 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.

Wenn Sie eine Warteschlangenverbindungs-Factory 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 Warteschlangenverbindungs-Factory 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 Warteschlangenverbindungs-Factory des WebSphere-MQ-Messaging-Providers verwendet, um eine entsprechende SSL-Konfiguration auszuwählen. Informationen zum Festlegen der SSL-Konfiguration, die der Warteschlangenverbindungs-Factory 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-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
Erweitert
Client-ID

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

Datentyp String
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 Verbindungs-Factory 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 Verbindungs-Factory 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.

Protokoll für verteilte zweiphasige Festschreibung unterstützen

Eine Option, die angibt, ob die Warteschlangenverbindungs-Factory die XA-Koordination von Messaging-Transaktionen unterstützt. Aktivieren Sie diese Option, wenn mehrere Ressourcen, einschließlich dieser Warteschlangenverbindungs-Factory, 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 kann jedoch nur eine einzige Ressource in einer Transaktion in WebSphere Application Server registriert werden.

Mit der Unterstützung für den letzten Teilnehmer können Sie eine Nicht-XA-Ressource zusammen mit anderen XA-Ressourcen registrieren.

Datentyp Kontrollkästchen
Standardeinstellung Ausgewählt
Einstellmöglichkeiten
Ausgewählt
Die Warteschlangenverbindungs-Factory unterstützt die Verwendung verteilter Protokolle für zweiphasige Festschreibung für die Koordination transaktionsorientierter Arbeit.
Nicht ausgewählt
Die Warteschlangenverbindungs-Factory unterstützt die Verwendung verteilter Protokolle für zweiphasige Festschreibung für die Koordination transaktionsorientierter Arbeit nicht.

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 Warteschlangenverbindungs-Factory verwendet, die einzige Ressource in der Transaktion ist.

Sicherheitseinstellungen
Authentifizierungsalias für XA-Wiederherstellung

Die Benutzername/Kennwort-Kombination, die während der XA-Wiederherstellung 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 während der XA-Wiederherstellung keine Berechtigungsnachweise an WebSphere 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 Warteschlangenverbindungs-Factory klicken Sie unter "Zugehörige Elemente" auf JAAS/J2C-Authentifizierungsdaten.

Datentyp Dropdown-Liste
Standardeinstellung (keine)
Einstellmöglichkeiten
ClientContainer
WSLogin
WSKRB5Login
DefaultPrincipalMapping
TrustedConnectionMapping
KerberosMapping
Containergesteuerter Authentifizierungsalias

Der Authentifizierungsalias, der den Benutzernamen und das Kennwort angibt, die verwendet werden sollen, wenn eine Verbindung zum WebSphere-MQ-Messaging-Provider hergestellt wird.

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
Webseite mit der WebSphere-MQ-Bibliothek unter der Adresse http://www.ibm.com/software/ts/mqseries/library (online)
Warteschlangenverbindungs-Factory
WebSphere-MQ-Bibliothek (online)


Dateiname: umj_pqcfm.html