Warteschlangenverbindungsfactory für den Standard-Messaging-Provider [Einstellungen]
Klicken Sie zum Aufrufen dieser Seite in der Konsole auf einen der folgenden Pfade:
Mit dieser JMS-Verbindungsfactory in den Server-Containern (z. B. aus einer Enterprise-Bean) erstellte Verbindungen werden standardmäßig unter Verwendung des JCA-Verbindungspoolings in Pools gestellt. Sie können die Einstellungen des Verbindungspools für diese Verbindungsfactory ändern, indem Sie den Link Eigenschaften für Verbindungspool im Abschnitt "Weitere Eigenschaften" der Administrationskonsolenanzeige auswählen.
Registerkarte "Konfiguration"
In der Registerkarte "Konfiguration" werden die Konfigurationseigenschaften für dieses Objekt angezeigt. Diese Eigenschaftswerte werden beibehalten, auch wenn die Laufzeitumgebung gestoppt und anschließend erneut gestartet wird. Informationen zum Anwenden von Konfigurationsänderungen auf die Laufzeitumgebung finden Sie in den Taskbeschreibungen im Information Center.
Allgemeine Eigenschaften
Geltungsbereich
Gibt die höchste Topologiestufe an, auf der Anwendungsserver dieses Ressourcenobjekt verwenden können.
Information | Wert |
---|---|
Erforderlich | Nein |
Datentyp | Zeichenfolge |
Provider
Gibt einen JMS-Provider an, der asynchrones Messaging auf der Basis von Java Messaging Service (JMS) ermöglicht. Er stellt J2EE-Verbindungsfactorys zur Verfügung, die Verbindungen zu spezifischen Zielen der JMS-Warteschlangen oder -Topics herstellen. Die Verwaltungsobjekte des JMS-Provider werden verwendet, um die JMS-Ressourcen für den zugeordneten JMS-Provider zu verwalten.
Information | Wert |
---|---|
Erforderlich | Nein |
Datentyp | Zeichenfolge |
Name
Der erforderliche Anzeigenname der Ressource.
Information | Wert |
---|---|
Erforderlich | Ja |
Datentyp | Zeichenfolge |
JNDI-Name
Der JNDI-Name für die Ressource.
Verwenden Sie gemäß Konvention einen JNDI-Namen im Format jms/Name, wobei Name für den logischen Namen der Ressource steht. Weitere Informationen zur Verwendung von JNDI und der JNDI-Syntax finden Sie im Artikel zur JNDI-Unterstützung in WebSphere Application Server.
Information | Wert |
---|---|
Erforderlich | Ja |
Datentyp | Zeichenfolge |
Beschreibung
Eine optionale Beschreibung für die Ressource.
Information | Wert |
---|---|
Erforderlich | Nein |
Datentyp | Textbereich |
Kategorie
Eine optionale Zeichenfolge für die Kategorie, die zum Klassifizieren oder Gruppieren der Ressource verwendet wird.
Information | Wert |
---|---|
Erforderlich | Nein |
Datentyp | Zeichenfolge |
Busname
Information | Wert |
---|---|
Erforderlich | Ja |
Datentyp | Angepasst |
Ziel
Information | Wert |
---|---|
Erforderlich | Nein |
Datentyp | Zeichenfolge |
Zieltyp
Gibt den Namen eines Ziels an, mit dem die Messaging-Engines bestimmt werden, die Anforderungen verarbeiten sollen. Der Typ des Ziels wird mit der Eigenschaft Zieltyp angegeben.
Verbindungen werden gleichmäßig auf die verfügbaren Messaging-Engines verteilt, die den Auswahlkriterien entsprechen.
Definieren Sie diese Eigenschaft nicht, wenn Sie möchten, dass Anwendungen Verbindungen zu allen Messaging-Engines herstellen können.
Weitere Informationen zur Verwendung dieser Eigenschaft zusammen mit anderen Verbindungsfactory-Eigenschaften für das Workload-Management von Verbindungen finden Sie im Artikel "Verwaltungseigenschaften für JMS-Verbindungen zu einem Bus".
Information | Wert |
---|---|
Erforderlich | Nein |
Datentyp | Dropdown-Liste |
Einstellmöglichkeiten |
|
Zielsignifikanz
Weitere Informationen zur Verwendung dieser Eigenschaft zusammen mit anderen Verbindungsfactory-Eigenschaften für das Workload-Management von Verbindungen finden Sie im Artikel "Verwaltungseigenschaften für JMS-Verbindungen zu einem Bus".
Information | Wert |
---|---|
Erforderlich | Nein |
Datentyp | Dropdown-Liste |
Einstellmöglichkeiten |
|
Zieltransportkette für eingehende Daten
Wenn die ausgewählte Messaging-Engine im selben Server wie die Anwendung ausgeführt wird, wird eine direkte prozessinterne Verbindung hergestellt. In diesem Fall wird diese Transportketteneigenschaft ignoriert.
- InboundBasicMessaging
- Ein verbindungsorientiertes Protokoll, das eine TCP/IP-Standardverbindung (JFAP-TCP/IP) verwendet. Es unterstützt zweiphasige Transaktionsabläufe (fernes XA), damit ein Nachrichtenerzeuger bzw. -konsument, der auf einem Client- oder Serversystem ausgeführt wird, an einer globalen Transaktion teilnehmen kann, die auf diesem Client- bzw. Serversystem verwaltet wird. XA-Abläufe werden im Speziellen für die Unterstützung des Zugriffs von einer Anwendung, die in einem Server ausgeführt wird, auf eine Messaging-Engine in einem zweiten Server verwendet, wenn der erste Server keine geeignete Messaging-Engine besitzt. Wenn ferne XA-Abläufe verwendet werden, muss der Anwendung ein lokaler Transaktionskoordinator zur Verfügung stehen.
- InboundSecureMessaging
- Das in SSL eingebundene Protokoll InboundBasicMessaging.
Information | Wert |
---|---|
Erforderlich | Nein |
Datentyp | Zeichenfolge |
Providerendpunkte
Sie müssen diese Eigenschaft nur ändern, wenn Clientanwendungen außerhalb eines Anwendungsservers oder Anwendungen in einem Server in einer anderen Zelle ausgeführt werden, die diese Verbindungsfactory verwenden sollen, um eine Verbindung zum Ziel-SIB herzustellen, der in der Verbindungsfactory angegeben ist.
Wenn eine Anwendung die JMS-Ziele des Standard-Messaging-Providers verwenden möchte, stellt sie eine Verbindung zu einer Messaging-Engine im Ziel-SIB (Service Integration Bus) her, dem die Ziele zugeordnet sind. Beispielsweise ist eine JMS-Warteschlange einem Warteschlangenziel in einem Service Integration Bus zugeordnet.
Clientanwendungen, die nicht in einem Anwendungsserver ausgeführt werden, sondern beispielsweise in einem Client-Container oder außerhalb der Umgebung von WebSphere Application Server, können keine direkte Verbindung zu einer geeigneten Messaging-Engine im Zielbus herstellen. Dies gilt auch für Anwendungen, die in einem Server in einer Zelle ausgeführt werden und eine Verbindung zu einem Zielbus in einer anderen Zelle herstellen müssen.
In diesen Szenarien müssen die Clients (oder Server im anderen Bus) einen Bootstrapprozess über einen Bootstrap-Server ausführen, der Member des Zielbusses ist. Ein Bootstrap-Server ist ein Anwendungsserver, in dem der SIB-Service ausgeführt wird, in dem aber keine Messaging-Engines ausgeführt werden müssen. Der Bootstrap-Server wählt eine Messaging-Engine aus, die in einem Anwendungsserver ausgeführt wird, der die erforderliche Zieltransportkette unterstützt. Damit der Bootstrapprozess ausgeführt werden kann, müssen Sie einen oder mehrere Providerendpunkte in der vom Client verwendeten Verbindungsfactory konfigurieren.
Ein Bootstrap-Server verwendet einen speziellen Port und eine spezielle Bootstraptransportkette. Der Port ist die SIB_ENDPOINT_ADDRESS (bzw. SIB_ENDPOINT_SECURE_ADDRESS, wenn die Sicherheit aktiviert ist) der Messaging-Engine mit dem fernen Ende der Verbindung. Zusammen mit dem Hostnamen bilden diese die Endpunktadresse des Bootstrap-Servers.
- Sind keine Sicherheitsberechtigungsnachweise angegeben, werden standardmäßig folgende Einstellungen verwendet:
- Wenn host nicht angegeben ist: localhost
- Wenn port nicht angegeben ist: Port 7276
- Wenn keine Bootstraptransportkette angegeben ist: Bootstraptransportkette BootstrapBasicMessaging
- Sind Sicherheitsberechtigungsnachweise angegeben, werden standardmäßig folgende Einstellungen verwendet:
- Wenn host nicht angegeben ist: localhost
- Wenn port nicht angegeben ist: Port 7286
- Wenn keine Bootstraptransportkette angegeben ist und die Portnummer größer-gleich 7286 ist: Bootstraptransportkette BootstrapSecureMessaging
- Wenn keine Bootstraptransportkette angegeben ist und die Portnummer im Bereich von 7276 bis 7285 liegt: Bootstraptransportkette BootstrapBasicMessaging
![[IBM i]](../images/iseries.gif)
Wenn eine Anwendung einen Bootstrap-Server mit einer anderen Endpunktadresse verwenden soll, müssen Sie die gewünschte Endpunktadresse mit der Eigenschaft Providerendpunkte in den JMS-Verbindungsfactorys angeben, die die Clientanwendung verwendet. Sie können eine oder mehrere Endpunktadressen von Bootstrap-Servern angeben.
Die Endpunktadressen für Bootstrap-Server müssen in jeder JMS-Verbindungsfactory angegeben werden, die von Anwendungen außerhalb eines Anwendungsservers verwendet werden. Damit Sie keine lange Liste mit Bootstrap-Servern angeben müssen, können Sie einige wenige hoch verfügbare Server angeben, die als Bootstrap-Server definiert sind. So müssen Sie in jeder Verbindungsfactory nur eine kurze Liste von Bootstrap-Servern angeben.
boothost1:7278:BootstrapBasicMessaging
oder
boothost1:7278
Verwenden Sie folgende Angabe für einen Server, der dem sicheren Port 7289
auf Host boothost2
zugeordnet ist und die vordefinierte Transportkette BootstrapTunneledSecureMessaging verwendet:
boothost2:7289:BootstrapTunneledSecureMessaging
[ [Hostname] [ ":" [Portnummer] [ ":" Kettenname] ] ]
Für diese Angaben gilt Folgendes:
- Hostname
- Der Name des Hosts, auf dem der Server ausgeführt wird. Es kann auch eine IP-Adresse sein.
Setzen Sie bei IPv6-Adressen den Hostnamen wie im folgenden Beispiel in eckige Klammern ([]):
. Wenn kein Wert angegeben ist, wird der Standardwert localhost verwendet.[2002:914:fc12:179:9:20:141:42]:7276:BootstrapBasicMessaging
Anmerkung: Für die Plattform IBM i müssen Sie (mindestens) den Standardhostnamen von localhost in Name.Ihres.Servers ändern.
- Portnummer
- Wenn ein Port angegeben ist, handelt es sich um eine der folgenden Adressen der Messaging-Engine mit dem fernen Ende der Verbindung:
- SIB_ENDPOINT_ADDRESS, wenn die Sicherheit nicht aktiviert ist.
- Für sichere Verbindungen SIB_ENDPOINT_SECURE_ADDRESS, wenn die Sicherheit aktiviert ist.
Wenn keine Portnummer angegeben ist, wird der Standardwert 7276 verwendet.
Wenn Sie diese Werte über die Administrationskonsole suchen möchten, klicken Sie auf .
- Kettenname
- Steht für den Namen einer vordefinierten Bootstraptransportkette, die verwendet wird, um eine Verbindung zum
Bootstrap-Server herzustellen. Wenn Sie den Port nicht angeben, wird der
Standardwert BootstrapBasicMessaging verwendet.
Die folgenden vordefinierten Bootstraptransportketten werden bereitgestellt:
- BootstrapBasicMessaging
- Entspricht der Servertransportkette InboundBasicMessaging (JFAP-TCP/IP)
- BootstrapSecureMessaging
- Entspricht der Servertransportkette InboundSecureMessaging (JFAP-SSL-TCP/IP)
- BootstrapTunneledMessaging
- Damit Sie diese Bootstraptransportkette verwenden können, müssen Sie eine entsprechende Servertransportkette auf dem Bootstrap-Server definieren. (Siehe .) Diese Transportkette tunnelt JFAP und verwendet HTTP-Wrapper.
- BootstrapTunneledSecureMessaging
- Damit Sie diese Bootstraptransportkette verwenden können, müssen Sie eine entsprechende Servertransportkette auf dem Bootstrap-Server definieren. (Weitere Informationen finden Sie im Artikel .) Diese Transportkette tunnelt JFAP und verwendet HTTP-Wrapper.
Die Angabe von Hostname : Kettenname anstelle von Hostname : : Kettenname (mit zwei Doppelpunkten) ist ungültig. Sie können nichts oder Folgendes eingeben: "a", "a:", ":7276", "::chain" usw. Wenn Sie keinen Wert angeben, wird der Standardwert verwendet, aber Sie müssen die Felder durch Doppelpunkte (":") voneinander trennen.
boothost1:7278:BootstrapBasicMessaging,
boothost2:7289:BootstrapTunneledSecureMessaging,
[2002:914:fc12:179:9:20:141:42]:7276:BootstrapBasicMessaging
Information | Wert |
---|---|
Erforderlich | Nein |
Datentyp | Textbereich |
Proximität für Verbindung
- Wenn eine Zielgruppe angegeben ist, wird eine Verbindung zu der ersten Messaging-Engine
hergestellt, die den folgenden Bedingungen bezüglich des Zieltyps entspricht:
- Server Es wird eine Messaging-Engine auf demselben Server gesucht.
- Cluster Zuerst wird eine Messaging-Engine auf demselben Server und dann auf anderen Servern im selben Cluster gesucht.
- Host Zuerst wird eine Messaging-Engine auf demselben Server, dann auf anderen Servern im selben Cluster und dann auf anderen Servern auf demselben Host gesucht.
- Bus Zuerst wird eine Messaging-Engine auf demselben Server, dann auf anderen Servern im selben Cluster, dann auf anderen Servern auf demselben Host und dann im selben Bus gesucht.
- Wenn keine Zielgruppe oder eine Zielgruppe angegeben ist, aber keine geeignete Messaging-Engine
gefunden wird und als Bedeutung für das Ziel Bevorzugt definiert ist, wird eine Verbindung zur ersten Messaging-Engine
hergestellt, die den folgenden Bedingungen bezüglich des Zieltyps entspricht:
- Server Es wird eine Messaging-Engine auf demselben Server gesucht.
- Cluster Die Verbindung schlägt fehl.
- Host Zuerst wird eine Messaging-Engine auf demselben Server und dann auf anderen Servern auf demselben Host gesucht.
- Bus Zuerst wird eine Messaging-Engine in der Zielgruppe auf demselben Server, dann auf anderen Servern auf demselben Host und dann im selben Bus gesucht.
Weitere Informationen zur Verwendung dieser Eigenschaft zusammen mit anderen Verbindungsfactory-Eigenschaften für das Workload-Management von Verbindungen finden Sie im Artikel "Verwaltungseigenschaften für JMS-Verbindungen zu einem Bus".
Information | Wert |
---|---|
Erforderlich | Nein |
Datentyp | Dropdown-Liste |
Einstellmöglichkeiten |
|
Zuverlässigkeit nicht persistenter Nachrichten
Information | Wert |
---|---|
Erforderlich | Nein |
Datentyp | Dropdown-Liste |
Einstellmöglichkeiten |
|
Zuverlässigkeit persistenter Nachrichten
Information | Wert |
---|---|
Erforderlich | Nein |
Datentyp | Dropdown-Liste |
Einstellmöglichkeiten |
|
Vorauslesen
Nachrichten, die einem Konsumenten zugeordnet sind, werden auf dem Server gesperrt und können nicht von anderen Konsumenten für dieses Ziel konsumiert werden. Einem Konsumenten zugeordnete Nachrichten, die vor dem Schließen dieses Konsumenten nicht konsumiert werden, werden nachfolgend auf dem Server freigegeben und können dann von anderen Konsumenten empfangen werden.
Sie können diese Eigenschaft für einzelne JMS-Ziele überschreiben, indem Sie die Eigenschaft Vorauslesen für das JMS-Ziel festlegen.
Information | Wert |
---|---|
Erforderlich | Nein |
Datentyp | Dropdown-Liste |
Einstellmöglichkeiten |
|
Namenspräfix für temporäre Warteschlangen
Information | Wert |
---|---|
Erforderlich | Nein |
Datentyp | Zeichenfolge |
Nachrichtennutzdaten nach Referenz übergeben
Wenn große Objektnachrichten oder Bytenachrichten gesendet werden, können die Kosten für die Speicher- und Prozessornutzung, die durch das Serialisieren, Deserialisieren und Kopieren der Nachrichtennutzdaten entstehen, beträchtlich sein. Wenn Sie die Eigenschaften für die Übernahme von Nachrichtennutzdaten nach Referenz in einer Verbindungsfactory oder Aktivierungsspezifikation aktivieren, teilen Sie dem Standard-Messaging-Provider dadurch mit, die Spezifikation JMS 1.1 zu überschreiben und das Kopieren der Daten nach Möglichkeit einzuschränken oder zu umgehen.
Anwendungen, die diese Verbindungsfactory verwenden, um Nachrichten zu senden, müssen die folgenden Regeln einhalten:
- Die Anwendung ändert das in einer JMS-Objektnachricht enthaltene Datenobjekt nicht.
- Die Anwendung schreibt eine JMS-Bytenachricht in einem einzigen Aufruf der Methode writeBytes(byte[]) und ändert die Bytefeldgruppe, nachdem diese in der Nachricht festgelegt wurde, nicht mehr.
Information | Wert |
---|---|
Erforderlich | Nein |
Datentyp | Boolescher Wert |
Anwendungen, die diese Verbindungsfactory verwenden, um Nachrichten zu empfangen, müssen die folgende Regel einhalten:
- Die Anwendung ändert das aus einer JMS-Objektnachricht abgerufene Datenobjekt nicht. Das Datenobjekt wird als schreibgeschütztes Objekt behandelt.
Information | Wert |
---|---|
Erforderlich | Nein |
Datentyp | Boolescher Wert |
Fehlende Transaktionskontexte protokollieren
Wählen Sie diese Eigenschaft aus, um Verbindungen zu protokollieren, die ohne Transaktionskontext erstellt werden.
Information | Wert |
---|---|
Erforderlich | Nein |
Datentyp | Boolescher Wert |
Kennungen im Cache verwalten
Information | Wert |
---|---|
Erforderlich | Nein |
Datentyp | Boolescher Wert |
Authentifizierungsalias für XA-Wiederherstellung
Diese Eigenschaft stellt eine Liste mit Alias für JCA-Authentifizierungsdateneinträge bereit, die für WebSphere Application Server definiert wurden. Sie können einen Dateneintragsalias auswählen, der während der XA-Wiederherstellung für die Authentifizierung verwendet werden soll.
Wenn Sie die Sicherheit für den zugehörigen Service Integration Bus aktiviert haben, wählen Sie den Alias aus, der die gültige Benutzer-ID aus der Benutzerregistry für WebSphere Application Server mit dem zugehörigen Kennwort für die XA-Wiederherstellung angibt. Diese Eigenschaft muss gesetzt werden, wenn die Bussicherheit aktiviert ist und XA-Transaktionen verwendet werden sollen.
Information | Wert |
---|---|
Erforderlich | Nein |
Datentyp | Dropdown-Liste |
Alias für Konfigurationszuordnung
Gibt den Zuordnungskonfigurationsalias für die JAAS-Zuordnungskonfiguration (Java Authentication and Authorization Service) an, die von dieser Verbindungsfactory verwendet wird.
Dieses Feld wird nur verwendet, wenn keine Anmeldekonfiguration in der Ressourcenreferenz der Komponente angegeben ist. Die Spezifikation einer Anmeldekonfiguration und zugehöriger Eigenschaften in der Ressourcenreferenz der Komponente bestimmt die containergesteuerte Authentifizierungsstrategie, wenn res-auth den Wert Container hat. Wenn die Anmeldekonfiguration "DefaultPrincipalMapping" angegeben wird, ist die zugehörige Eigenschaft ein JAAS-J2C-Authentifizierungsdateneintragsalias. Informationen zum Definieren eines neuen Alias finden Sie unter dem zugehörigen Artikel zu JAAS-J2C-Authentifizierungsdateneinträgen.
Information | Wert |
---|---|
Erforderlich | Nein |
Datentyp | Dropdown-Liste |
Containergesteuerter Authentifizierungsalias
Dieser Alias gibt eine Benutzer-ID und ein Kennwort für die Authentifizierung von Verbindungen mit dem JMS-Provider für containergesteuerte Authentifizierung an. Diese Einstellung wird nur verwendet, wenn res-auth auf container gesetzt ist und bei der Implementierung der Anwendung kein Authentifizierungsalias definiert wurde.
Information | Wert |
---|---|
Erforderlich | Nein |
Datentyp | Dropdown-Liste |
Weitere Eigenschaften
- Eigenschaften des Verbindungspools
- Optionale Einstellungen für den Verbindungspool.