[Release 5.1 und höher]Einstellungen der Verbindungs-Factory für WebSphere-MQ-Warteschlangen

In dieser Anzeige können Sie die Konfigurationsmerkmale der Verbindungs-Factory der ausgewählten Warteschlange, die mit dem WebSphere-MQ-JMS-Provider verwendet werden soll, anzeigen oder ändern. Diese Konfigurationsmerkmale steuern, wie Verbindungen zu der zugeordneten Zieladresse für JMS-Warteschlangen erstellt werden.

Die Verbindungs-Factory für eine Warteschlange wird verwendet, um JMS-Verbindungen zu Zieladressen von Warteschlangen herzustellen. Die Verbindungs-Factory für eine Warteschlange wird vom WebSphere-MQ-JMS-Provider erstellt. Die Verbindungs-Factory für eine Warteschlange, die mit dem WebSphere-MQ-JMS-Provider verwendet werden soll, hat die folgenden Merkmale:

Anmerkung:

Klicken Sie zum Anzeigen dieser Seite der Administrationskonsole auf Ressourcen-> WebSphere-MQ-JMS-Provider-> (im Inhaltsfenster unter "Weitere Merkmale") Verbindungs-Factory für WebSphere-MQ-Warteschlangen-> Verbindungs-Factory.

Name
Der Name, unter dem die Verbindungs-Factory für Warteschlangen für die Administration in IBM WebSphere Application Server geführt wird. Der Name muss unter den JMS-Verbindungs-Factorys innerhalb der WebSphere-Administrationsdomäne eindeutig sein.
Datentyp String
JNDI-Name
Der JNDI-Name, der zum Binden der Verbindungs-Factory an den Namespace des Anwendungsservers verwendet wird.

Verwenden Sie als Konvention den vollständig qualifizierten JNDI-Namen, z. B. im Format jms/Name. Dabei bezeichnet Name den logischen Namen der Ressource.

Dieser Name wird verwendet, um die Bindungsinformationen für die Plattform zu verlinken. Die Bindung ordnet die im Deployment-Deskriptor des Moduls definierten Ressourcen den "echten" (physischen) Ressourcen zu, die über die Plattform an JNDI gebunden sind.

Datentyp String
Beschreibung
Eine Beschreibung dieser Verbindungs-Factory für die Administration in IBM WebSphere Application Server.
Datentyp String
Standardwert Keiner
Kategorie
Eine Kategorie, die verwendet wird, um diese Verbindungs-Factory für Ihre Administrationsdaten unter IBM WebSphere Application Server zu klassifizieren bzw. zu gruppieren.
Datentyp String
Aliasname für komponentengestützte Authentifizierung
Dieser Aliasname gibt eine Kombination aus Benutzer-ID und Kennwort an, die verwendet wird, um eine Verbindung zu einem JMS-Provider anwendungsgesteuert zu authentifizieren.

Dieses Merkmal stellt eine Liste mit Aliasnamen für Dateneinträge für J2C-Authentifizierung bereit, die für den WebSphere Application Server definiert wurden. Sie können einen Aliasnamen für einen Dateneintrag auswählen, der verwendet werden soll, um die Erstellung einer neuen Verbindung zum JMS-Provider zu authentifizieren.

Wenn Sie die globale Sicherheit für den WebSphere Application Server aktiviert haben, müssen Sie den Aliasnamen auswählen, der die Kombination aus Benutzer-ID und Kennwort angibt, mit der die Erstellung einer neuen Verbindung zum JMS-Provider authentifiziert wird. Die Verwendung dieses Aliasnamens hängt von der Einstellung für die Ressourcenauthentifizierung (res-auth) ab, die in der Ressourcenreferenz der Verbindungs-Factory von Deployment-Deskriptoren einer Anwendungskomponente deklariert ist.

Anmerkung:

  1. Mit dem eingebetteten JMS-Provider von WebSphere können für die Authentifizierung nur Benutzer-IDs mit maximal 12 Zeichen verwendet werden. Beispielsweise ist die Standardbenutzer-ID von Windows NT, Administrator, für das eingebettete WebSphere-Messaging nicht gültig, da sie 13 Zeichen enthält. Daher muss der Aliasname für die Authentifizierung eines WebSphere-JMS-Provider eine Benutzer-ID angeben, die nicht länger als 12 Zeichen ist.
  2. Soll die JMS-Verbindung des WebSphere-MQ-JMS-Provider im Transportmodus "Bindings" (Bindungen) verwendet werden, müssen Sie das Merkmal Transporttyp=BINDINGS in der Verbindungs-Factory für WebSphere-MQ-Queue-Warteschlangen festlegen. Außerdem müssen Sie eine der folgenden Optionen auswählen:
    • Damit die Sicherheitsberechtigungen verwendet werden können, muss der angegebene Benutzer derzeit als Benutzer für den WAS-Prozess angemeldet sein. Ist der angegebene Benutzer derzeit nicht als Benutzer für den WAS-Prozess angemeldet, dann gibt die WebSphere-MQ-JMS-Bindings-Authentifizierung den folgenden Fehler zurück: "MQJMS2013 invalid security authentication supplied for MQQueueManager".
    • Geben Sie keine Sicherheitsberechtigungen an. Vergewissern Sie sich, dass die Merkmale Aliasname für komponentengestützte Authentifizierung und Aliasname für containergestützte Authentifizierung in der WebSphere-MQ-Verbindungs-Factory nicht festgelegt sind.

Aliasname für containergestützte Authentifizierung
Dieser Aliasname gibt eine Kombination aus Benutzer-ID und Kennwort an, die verwendet wird, um eine Verbindung zu einem JMS-Provider containergestützt zu authentifizieren.

Dieses Merkmal stellt eine Liste mit Aliasnamen für Dateneinträge für J2C-Authentifizierung bereit, die für den WebSphere Application Server definiert wurden. Sie können einen Aliasnamen für einen Dateneintrag auswählen, der verwendet werden soll, um die Erstellung einer neuen Verbindung zum JMS-Provider zu authentifizieren.

Wenn Sie die globale Sicherheit für den WebSphere Application Server aktiviert haben, müssen Sie den Aliasnamen auswählen, der die Kombination aus Benutzer-ID und Kennwort angibt, mit der die Erstellung einer neuen Verbindung zum JMS-Provider authentifiziert wird. Die Verwendung dieses Aliasnamens hängt von der Einstellung für die Ressourcenauthentifizierung (res-auth) ab, die in der Ressourcenreferenz der Verbindungs-Factory von Deployment-Deskriptoren einer Anwendungskomponente deklariert ist.

Anmerkung:

  1. Mit dem eingebetteten JMS-Provider von WebSphere können für die Authentifizierung nur Benutzer-IDs mit maximal 12 Zeichen verwendet werden. Beispielsweise ist die Standardbenutzer-ID von Windows NT, Administrator, für das eingebettete WebSphere-Messaging nicht gültig, da sie 13 Zeichen enthält. Daher muss der Aliasname für die Authentifizierung eines WebSphere-JMS-Provider eine Benutzer-ID angeben, die nicht länger als 12 Zeichen ist.
  2. Soll die JMS-Verbindung des WebSphere-MQ-JMS-Provider im Transportmodus "Bindings" (Bindungen) verwendet werden, müssen Sie das Merkmal Transporttyp=BINDINGS in der Verbindungs-Factory für WebSphere-MQ-Queue-Warteschlangen festlegen. Außerdem müssen Sie eine der folgenden Optionen auswählen:
    • Damit die Sicherheitsberechtigungen verwendet werden können, muss der angegebene Benutzer derzeit als Benutzer für den WAS-Prozess angemeldet sein. Ist der angegebene Benutzer derzeit nicht als Benutzer für den WAS-Prozess angemeldet, dann gibt die WebSphere-MQ-JMS-Bindings-Authentifizierung den folgenden Fehler zurück: "MQJMS2013 invalid security authentication supplied for MQQueueManager".
    • Geben Sie keine Sicherheitsberechtigungen an. Vergewissern Sie sich, dass die Merkmale Aliasname für komponentengestützte Authentifizierung und Aliasname für containergestützte Authentifizierung in der WebSphere-MQ-Verbindungs-Factory nicht festgelegt sind.

Warteschlangenmanager
Der Name des WebSphere MQ Queue Manager für diese Verbindungs-Factory. Die von dieser Factory erstellten Verbindungen stellen eine Verbindung zu diesem Warteschlangenmanager her.
Datentyp String
Standardwert Keine
Bereich Der gültige Name eines WebSphere MQ Queue Manager. Zulässig sind 1 bis 48 ASCII-Zeichen.
Host
Der Name des Host, auf dem der WebSphere MQ Queue Manager ausgeführt wird (nur für Clientverbindungen).
Datentyp String
Standardwert Keine
Bereich Gültiger TCP/IP-Hostname
Port
Die TCP/IP-Port-Nummer, die für den WebSphere MQ Queue Manager verwendet wird (nur für Clientverbindungen).

Dieser Port muss im WebSphere-MQ-Warteschlangenmanager konfiguriert werden.

Datentyp Integer
Standardwert Keiner
Bereich Eine gültige TCP/IP-Port-Nummer, die im WebSphere MQ Queue Manager definiert ist.
Kanal
Der Name des Kanals, der für die Verbindung zum WebSphere MQ Queue Manager verwendet werden soll (nur für Clientverbindungen).
Datentyp String
Standardwert Keiner
Bereich 1 bis 20 ASCII-Zeichen
Transporttyp
Gibt an, ob die WebSphere-MQ-Clientverbindung oder die JNI-Bindungen verwendet werden, um die Verbindung zum WebSphere MQ Queue Manager herzustellen. Der externe JMS-Provider steuert die Kommunikationsprotokolle zwischen JMS-Clients und JMS-Servern. Passen Sie den Transporttyp an, wenn Sie nicht dauerhaftes, nicht transaktionales ohne ASF verwenden oder wenn Sie auf Sicherheitsprobleme reagieren müssen und der Client ein lokaler Client des Queue-Manager-Knotens ist.
Datentyp Enum
Einheiten Nicht anwendbar
Standardwert BINDINGS
Bereich
BINDINGS
JNI-Bindings wird verwendet, um eine Verbindung zum Queue Manager herzustellen. BINDINGS ist ein Shared-Memory-Protokoll und kann nur verwendet werden, wenn sich der Queue Manager auf demselben Knoten wie der JMS-Client befindet und Sicherheitsprobleme auftreten, die durch die Verwendung von EJB-Aufgabenbereichen gelöst werden müssen.

Soll die JMS-Verbindung des WebSphere-MQ-JMS-Provider im Transportmodus "Bindings" (Bindungen) verwendet werden, müssen Sie das Merkmal Transporttyp=BINDINGS in der Verbindungs-Factory für WebSphere-MQ-Queue-Warteschlangen festlegen. Außerdem müssen Sie eine der folgenden Optionen auswählen:

  • Damit die Sicherheitsberechtigungen verwendet werden können, muss der angegebene Benutzer derzeit als Benutzer für den WAS-Prozess angemeldet sein. Ist der angegebene Benutzer derzeit nicht als Benutzer für den WAS-Prozess angemeldet, dann gibt die WebSphere-MQ-JMS-Bindings-Authentifizierung den folgenden Fehler zurück: "MQJMS2013 invalid security authentication supplied for MQQueueManager".
  • Geben Sie keine Sicherheitsberechtigungen an. Vergewissern Sie sich, dass die Merkmale Aliasname für komponentengesteuerte Authentifizierung und Aliasname für containergesteuerte Authentifizierung in der WebSphere-MQ-Verbindungs-Factory nicht festgelegt sind.

CLIENT
Die MQSeries-Clientverbindung wird verwendet, um eine Verbindung zum Queue Manager herzustellen. CLIENT ist ein typisches TCP-basiertes Protokoll.
Direkt
Verwenden Sie für WebSphere MQ Event Broker den Modus DIRECT. DIRECT ist ein Lightweight-Socket-Protokoll, das für nicht transaktionales, nicht dauerhaftes und nicht persistentes Publish/Subscribe-Messaging verwendet wird. DIRECT funktioniert nur für Clients und nachrichtengesteuerte Beans, die das Protokoll ohne ASF verwenden.
Aus der Warteschlange
QUEUED ist ein TCP-Standardprotokoll.
Empfohlene Einstellung
Transporttyp der Verbindungs-Factory für Warteschlangen
BINDINGS ist um mindestens 30 % schneller, bietet aber weniger Sicherheit. Sollten Sie Sicherheitsbedenken haben, sollten Sie BINDINGS den Vorzug vor CLIENT geben.
Transporttyp der Verbindungs-Factory für Topcis
DIRECT ist am schnellsten und sollte, sofern möglich, immer verwendet werden. Verwenden Sie BINDINGS, wenn zusätzliche Sicherheitsaspekte zu berücksichtigen haben und der Queue Manager für den JMS-Client lokal ist. Auf QUEUED kann in allen andere Fällen zurückgegriffen werden. WebSphere MQ 5.3 vor CSD2 mit der Einstellung DIRECT kann Nachrichten verlieren, wenn nachrichtengesteuerte Beans verwendet werden und die Arbeitslast hoch ist. Dies passiert auch bei clientbasierten Anwendungen, sofern die Einstellung maxClientQueueSize des Brokers nicht auf 0 gesetzt ist. Sie können diese Einstellung mit dem Befehl #wempschangeproperties WAS_nodeName_server1 -e default -o DynamicSubscriptionEngine -n maxClientQueueSize -v 0 -x executionGroupUUID setzen. Die executionGroupUUID können Sie ermitteln, indem Sie den Broker starten und im Ereignis- oder Anwendungsprotokoll nach dem Ereignis 2202 suchen. Der Wert ist in der Regel ffffffff-0000-0000-000000000000.
Definition von Modellwarteschlangen
Der Name der Modellwarteschlangendefinition, die der Warteschlangenmanager verwenden kann, um temporäre Warteschlangen zu erstellen, wenn eine angeforderte Warteschlange noch nicht vorhanden ist.
Datentyp String
Standardwert Keiner
Bereich 1 bis 48 ASCII-Zeichen
Client-ID
Die JMS-Client-ID, die für Verbindungen zum WebSphere MQ Queue Manager verwendet wird.
Datentyp String
Standardwert Keiner
CCSID
Die CCSID (Coded Character Set Identifier, ID des codierten Zeichensatzes), die vom WebSphere MQ Queue Manager verwendet wird.

Diese CCSID muss von WebSphere MQ unterstützt werden.

Datentyp String
Einheiten Integer
Standardwert Keiner
Bereich 1 bis 65535

Weitere Informationen zu den unterstützten CCSIDs und zum Konvertieren von Nachrichtendaten aus einem codierten Zeichensatz in einen anderen finden Sie in den Handbüchern WebSphere MQ System Administration und WebSphere MQ Application Programming Reference. Sie finden diese Handbücher für die verschiedenen Plattformen auf den Webseiten von WebSphere MQ, wie z. B. Zugriff auf das Ziel ist nur möglich, wenn dieses Topic mit dem World Wide Web verlinkt ist    http://www-3.ibm.com/software/ts/mqseries/library/manualsa/manuals/platspecific.html , dem Zugriff auf das Ziel ist nur möglich, wenn dieses Topic mit dem World Wide Web verlinkt ist    IBM Publications Center und im WebSphere MQ Collection Kit, SK2T-0730.

Aufbewahrung von Nachrichten
Wählen Sie dieses Markierungsfeld aus, wenn unerwünschte Nachrichten in der Warteschlange bleiben sollen. Andernfalls werden diese Nachrichten entsprechend den für sie festgelegten Optionen behandelt.
Datentyp Enum
Einheiten Nicht anwendbar
Standardwert Gelöscht
Bereich
Ausgewählt
Unerwünschte Nachrichten werden in der Warteschlange gelassen.
Gelöscht
Unerwünschte Nachrichten werden entsprechend den für sie festgelegten Optionen behandelt.
XA aktiviert
Gibt an, ob die Verbindungs-Factory für die XA- oder Nicht-XA-gestützte Koordination von Nachrichten bestimmt ist, und steuert, ob der Anwendungsserver XA QCF/TCF verwendet. Aktivieren Sie XA, wenn in einer Transaktion nicht mehrere Ressourcen verwendet werden.

Wenn Sie dieses Merkmal auf NON_XA setzen, bleibt die JMS-Sitzung zwar in einer Transaktion registriert, 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 aber auch, dass in WebSphere Application Server jeweils nur eine Ressource in einer Transaktion registriert sein kann. In WebSphere Application Server können Sie mit der Unterstützung für den letzten Teilnehmer (Last Participant Support) eine Nicht-XA-Ressource zusammen mit anderen XA-Ressourcen registrieren.

Bei einer Verbindungs-Factory für WebSphere-Topics, bei der das Merkmal Port-Typ auf DIREKT eingestellt wurde, wird dieses Merkmal nicht verwendet. In diesem Fall ist der Standardwert NON_XA.

Datentyp Enum
Einheiten Nicht anwendbar
Standardwert XA aktiviert
Bereich
XA
Die Verbindungs-Factory ist für die XA-Koordination von Nachrichten bestimmt.
NON_XA
Die Verbindungs-Factory ist für die Koordination von Nachrichten ohne XA bestimmt.
Empfohlene Einstellung Aktivieren Sie XA nicht, wenn die Nachrichtenwarteschlange oder das empfangene Topic die einzige Ressource in der Transaktion ist. Aktivieren Sie XA, wenn andere Ressourcen, einschließlich anderer Warteschlangen und Topics, an der Transaktion beteiligt sind.
Verbindungspool
Gibt optionale Einstellungen für den Verbindungspool an.

Die Merkmale des Verbindungspools gelten für alle J2C-Connector.

Der Anwendungsserver fasst Verbindungen und Sitzungen mit dem JMS-Provider zu Pools zusammen, um die Leistung zu verbessern. Dies geschieht unabhängig von der Verwendung von WebSphere-MQ-Verbindungspools. Sie müssen die für Ihre Anwendungen erforderlichen Merkmale der Verbindungs- und Sitzungspools konfigurieren, damit das Verbindungs- und Sitzungsverhalten Ihren Vorstellungen entspricht.

Ändern Sie die Größe des Verbindungspools, wenn die Anzahl gleichzeitiger Zugriffe von Seiten des Servers auf die JMS-Ressource den Standardwert überschreitet. Die Größe des Verbindungspools wird pro Warteschlange oder Topic festgelegt. Nähere Informationen hierzu finden Sie in der folgenden Tabelle.

Sitzungspool
Eine optionale Gruppe von Einstellungen für den Sitzungspool.

Dieser Link ruft eine Anzeige mit optionalen Merkmalen für den Verbindungspool auf, die für alle J2C-Connector gültig sind.

Der Anwendungsserver fasst Verbindungen und Sitzungen mit dem JMS-Provider zu Pools zusammen, um die Leistung zu verbessern. Dies geschieht unabhängig von der Verwendung von WebSphere-MQ-Verbindungspools. Sie müssen die für Ihre Anwendungen erforderlichen Merkmale der Verbindungs- und Sitzungspools konfigurieren, damit das Verbindungs- und Sitzungsverhalten Ihren Vorstellungen entspricht.

Benutzerdefinierte Merkmale
Eine optionale Gruppe von Namen- und Wertpaaren für benutzerdefinierte Merkmale, die an WebSphere MQ übergeben werden.

Sie können die folgenden WebSphere-MQ-SSL-Merkmale (Secure Sockets Layer) auf der Seite mit den benutzerdefinierten Merkmalen festlegen. Diese Merkmale gelten nur für den Fall, dass das Merkmal Transporttyp=CLIENT festgelegt ist.

Weitere Informationen zum Festlegen dieser Merkmale finden Sie im Abschnitt SSL-Merkmale in der Veröffentlichung WebSphere MQ Using Java.