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:
-
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.
-
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.
-
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.
-
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:
- 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.
- 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:
- 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.
- 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.
http://www-3.ibm.com/software/ts/mqseries/library/manualsa/manuals/platspecific.html
,
dem
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.