Eine JMS-Aktivierungsspezifikation wird einer oder mehreren MDBs (Message-Driven Beans, nachrichtengesteuerte Beans) zugeordnet und enthält die erforderliche Konfiguration, damit die MDBs Nachrichten empfangen können.
Klicken Sie zum Aufrufen dieser Anzeige in der Konsole auf einen der folgenden Pfade:
Sie erstellen eine JMS-Aktivierungsspezifikation, wenn Sie eine nachrichtengesteuerte Bean für die Kommunikation mit dem Standard-Messaging-Provider über Java EE Connector Architecture (JCA) 1.5 verwenden möchten. JCA unterstützt die Java-Konnektivität zwischen Anwendungsservern wie WebSphere Application Server und Enterprise Information Systems (EIS). JCA ist eine standardisierte Methode für die Integration von JMS-Providern und Java-EE-Anwendungsservern und bietet ein Framework für den Austausch von Daten mit Unternehmenssystemen, in dem die Daten in Form von Nachrichten übertragen werden.
Alle Konfigurationseigenschaften der Aktivierungsspezifikation mit Ausnahme von Name, JNDI-Name, JNDI-Name der Destination und Authentifizierungsaliasname werden durch die entsprechend benannten Aktivierungskonfigurationseigenschaften im Implementierungsdeskriptor einer zugeordneten MDB der EJB Version 2.1 überschrieben. Für eine MDB der EJB Version 2.0 werden die Eigenschaften Destination-Typ, Subskriptionspersistenz, Bestätigungsmodus und Nachrichtenselektor durch die entsprechenden Elemente im Implementierungsdeskriptor überschrieben. Bei beiden Bean-Typen kann die Eigenschaft JNDI-Name der Destination durch einen Wert überschrieben werden, der in den Bindungen der nachrichtengesteuerten Bean angegeben ist.
Die Eigenschaften der Aktivierungsspezifikation haben Einfluss darauf, wie der Standard-Messaging-Provider die Messaging-Steuerkomponente auswählt, zu der Ihre MDB-Anwendung eine Verbindung herstellt. Standardmäßig verbindet die Umgebung Anwendungen automatisch mit einer verfügbaren Messaging-Steuerkomponente im Bus. Sie können jedoch zusätzliche Konfigurationsdetails angeben, um den Verbindungsprozess zu beeinflussen. Beispielsweise können Sie Konfigurationsdetails definieren, um spezielle Bootstrap-Server anzugeben, die Verbindung auf eine Untergruppe der verfügbaren Messaging-Steuerkomponenten zu beschränken, Verfügbarkeit oder Leistung zu verbessern oder die sequenzielle Verarbeitung der empfangenen Nachrichten sicherzustellen. Informationen zum Warum und Wie finden Sie im Artikel So stellen JMS-Anwendungen eine Verbindung zu einer Messaging-Steuerkomponente in einem Bus her (online).
Links, die mit (online) gekennzeichnet sind, erfordern Internet-Zugriff. Jeder Link startet eine Suche nach dem Artikel im online verfügbaren Information Center. Wählen Sie in der Auflistung mit den Suchergebnissen den Artikel aus, der Ihrer Konfiguration am besten entspricht.
Nach Aktualisierungen für diesen Artikel suchen (online)
Auf 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. Die Task-Beschreibungen im Information Center enthalten Informationen zum Anwenden von Konfigurationsänderungen auf die Laufzeitumgebung.
Gibt die höchste Topologiestufe an, auf der Anwendungsserver dieses Ressourcenobjekt verwenden können.
Erforderlich | Nein |
Datentyp | Text |
Gibt einen JMS-Provider an, der asynchrones Messaging auf der Basis von Java Messaging Service (JMS) ermöglicht. Er stellt J2EE-Verbindungs-Factorys zur Verfügung, die Verbindungen zu spezifischen Destinations 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.
Erforderlich | Nein |
Datentyp | Text |
Der JNDI-Name für die Ressource.
Erforderlich | Ja |
Datentyp | Text |
Gibt an, ob die MDB eine Warteschlangen- oder Topic-Destination verwendet.
Erforderlich | Ja |
Datentyp | Auswahlliste |
Einstellmöglichkeiten |
|
JNDI-Name der Destination
Wählen Sie den Typ der Destination mit der Eigenschaft Destination-Typ aus.
Erforderlich | Ja |
Datentyp | Text |
Der JMS-Nachrichtenselektor, mit dem bestimmt wird, welche Nachrichten die MDB empfängt. Der Wert ist eine Zeichenfolge, die zur Auswahl einer Untermenge verfügbarer Nachrichten verwendet wird. Die Syntax basiert auf einem Teil der SQL-92-Syntax für Bedingungsausdrücke, der in der JMS-Spezifikation beschrieben ist. Weitere Informationen finden Sie im Information Center.
JMSType='car' AND color='blue' AND weight>2500
Die Selektorzeichenfolge kann sich auf Felder im JMS-Nachrichtenkopf und Felder in den Nachrichteneigenschaften beziehen. Nachrichtenselektoren können nicht auf Werte im Nachrichtenhauptteil verweisen.
Ein Nullwert (eine leere Zeichenfolge) zeigt an, dass kein Nachrichtenselektor für den Nachrichtenkonsumenten vorhanden ist.
Erforderlich | Nein |
Datentyp | Text |
Der Name des Busses, zu dem eine Verbindung hergestellt werden soll.
Erforderlich | Nein |
Datentyp | Angepasst |
Gibt an, wie die Sitzung die empfangenen Nachrichten bestätigt.
Erforderlich | Nein |
Datentyp | Auswahlliste |
Einstellmöglichkeiten |
|
Der Name eines Ziels, der eine Gruppe von Messaging-Steuerkomponenten angibt. Geben Sie den Typ des Ziels mit der Eigenschaft "Zieltyp" an.
Erforderlich | Nein |
Datentyp | Text |
Der Typ des mit der Eigenschaft "Ziel" angegebenen Ziels.
Erforderlich | Nein |
Datentyp | Auswahlliste |
Einstellmöglichkeiten |
|
Diese Eigenschaft gibt die Signifikanz der Zielgruppe an.
Erforderlich | Nein |
Datentyp | Auswahlliste |
Einstellmöglichkeiten |
|
Der Name der Transportkette für eingehende Anforderungen, die die Anwendung verwendet, wenn sie eine Verbindung zu einer Messaging-Steuerkomponente in einem von der Anwendung separaten Prozess herstellt. Wenn eine Messaging-Steuerkomponente in einem anderen Prozess ausgewählt wird, kann eine Verbindung nur dann hergestellt werden, wenn die Messaging-Steuerkomponente in einem Server ausgeführt wird, der die angegebene Transportkette für eingehende Anforderungen verwendet. Weitere Informationen finden Sie im Information Center.
Wenn die ausgewählte Messaging-Steuerkomponente im selben Server wie die Anwendung ausgeführt wird, wird eine direkte prozessinterne Verbindung hergestellt. In diesem Fall wird diese Transportketteneigenschaft ignoriert.
Erforderlich | Nein |
Datentyp | Text |
Eine durch Kommata getrennte Liste mit Endpunkt-Triplets im Format Hostname:Portnummer:Kettenname, die zum Herstellen einer Verbindung zu einem Bootstrap-Server verwendet wird, z. B. Merlin:7276:BootstrapBasicMessaging,Gandalf:5557:BootstrapSecureMessaging.
Wenn der Hostname nicht angegeben ist, wird standardmäßig localhost verwendet.
Wenn die Portnummer nicht angegeben ist, wird standardmäßig 7276 verwendet.
Wenn das Protokoll nicht angegeben ist, wird standardmäßig eine vordefinierte Kette wie BootstrapBasicMessaging verwendet.
Erforderlich | Nein |
Datentyp | Textbereich |
Der Name eines J2C-Authentifizierungsalias für die komponentengestützte Authentifizierung von Verbindungen zum Service Integration Bus.
Ein JCA-Authentifizierungsalias gibt die Benutzer-ID und das Kennwort an, das für die Authentifizierung der Erstellung einer neuen Verbindung zum JMS-Provider verwendet werden.
Erforderlich | Nein |
Datentyp | Auswahlliste |
Die maximale Anzahl der Nachrichten, die von der Messaging-Steuerkomponente in einem Stapel empfangen werden kann.
Erforderlich | Nein |
Datentyp | Integer |
Einstellmöglichkeiten | 1 bis 2147483647 |
Die maximale Anzahl der Endpunkte, an die parallel Nachrichten übermittelt werden können.
Erforderlich | Nein |
Datentyp | Integer |
Einstellmöglichkeiten | 1 bis 2147483647 |
Diese Parameter ermöglichen das automatische Stoppen eines Endpunkts, wenn die Anzahl aufeinanderfolgender fehlgeschlagener Nachrichten einen von Ihnen definierten Grenzwert erreichen. Auf diese Weise können Sie Nachrichten, die wegen eines Problems mit den Nachrichten selbst fehlschlagen, und Nachrichten, die wegen eines Systemressourcenproblems fehlschlagen, das zahlreiche nacheinander fehlschlagende Nachrichten verursacht, voneinander unterscheiden.
Wenn ein Endpunkt automatisch gestoppt wird, wird sein Status in der Anzeige der Administrationskonsole in rot angezeigt. Der Endpunkt muss durch Klicken auf die Schaltfläche Fortsetzen manuell erneut gestartet werden.
Nach dem Neustart eines Endpunkts werden alle fehlerhaften Nachrichten, die zum Stoppen des Endpunkts geführt haben, wiederholt. Wenn die Nachrichten erneut fehlschlagen, werden sie an eine Ausnahme-Destination verschoben, sofern eine solche konfiguriert ist.
Automatisches Stoppen eines Endpunkts auf der Basis der folgenden Parameter stoppen.
Erforderlich | Nein |
Datentyp | Kontrollkästchen |
Der Endpunkt wird gestoppt, wenn die Anzahl aufeinanderfolgender fehlerhafter Nachrichten den konfigurierten Grenzwert erreicht. Wegen des gemeinsamen Zugriffs in der MDB kann die tatsächliche Anzahl der verarbeiteten Nachrichten diesen Wert überschreiten.
Diese Eigenschaft ist nur aktiviert, wenn die Eigenschaft Endpunkte bei wiederholten Nachrichtenfehlern automatisch stoppen aktiviert ist.
Erforderlich | Nein |
Datentyp | Integer |
Jede Nachricht, die nicht von der MDB verarbeitet werden kann, aber ihr maximales Zustellungslimit noch nicht erreicht hat, wird erst nach Ablauf dieses Zeitraums wiederholt. Es können andere Nachrichten in dieser Zeit verarbeitet werden, sofern der Schwellenwert für aufeinanderfolgende Fehler und die maximale Anzahl gleichzeitiger Zugriffe nicht auf "1" gesetzt sind.
Diese Eigenschaft ist nur aktiviert, wenn die Eigenschaft Endpunkte bei wiederholten Nachrichtenfehlern automatisch stoppen aktiviert ist.
Erforderlich | Nein |
Datentyp | Integer |
Einstellmöglichkeiten | Die Zeit in Millisekunden. Der Wert 0 gibt an, dass die Wiederholungen ohne Verzögerung erfolgt. |
Gibt an, ob eine JMS-Topic-Subskription permanent oder nicht permanent ist.
Erforderlich | Nein |
Datentyp | Auswahlliste |
Einstellmöglichkeiten |
|
Der für permanente Topic-Subskriptionen erforderliche Subskriptionsname. Dieses Feld muss ausgefüllt werden, wenn eine permanente Topic-Subskription verwendet wird.
Der Subskriptionsname muss für jede Client-ID eindeutig sein.
Erforderlich | Nein |
Datentyp | Text |
Die ID des JMS-Clients, die für permanente Topic-Subskriptionen in allen Verbindungen erforderlich ist, die mit dieser Aktivierungsspezifikation erstellt werden.
Erforderlich | Nein |
Datentyp | Text |
Der Name der Messaging-Steuerkomponente, die zum Speichern von Nachrichten verwendet wird, die dauerhaften Subskriptionen für Objekte zugestellt werden, die aus dieser JMS-Aktivierungsspezifikation erstellt wurden. Dieses Feld muss bei der Verwendung permanenter Topic-Subskriptionen ausgefüllt werden.
Erforderlich | Nein |
Datentyp | Text |
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 Verbindungs-Factory 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.
Wenn diese Option aktiviert ist, werden die Nachrichtendaten von Objektnachrichten, die über diese Aktivierungsspezifikation empfangen werden, nur dann vom System serialisiert, wenn es unbedingt erforderlich ist. Die aus diesen Nachrichten abgerufenen Daten müssen von Anwendungen als schreibgeschützte Daten behandelt werden.
Erforderlich | Nein |
Datentyp | Kontrollkästchen |
Wenn diese Eigenschaft aktiviert ist, werden die Daten von Objekt- oder Bytenachrichten, die über diese Aktivierungsspezifikation weitergeleitet werden und geänderte Nutzdaten enthalten, nicht kopiert, wenn sie in der Nachricht festgelegt werden, und das System serialisiert die Nachrichtendaten nur, wenn es absolut erforderlich ist. Anwendungen, die solche Nachrichten senden, dürfen die Daten, sobald sie in der Nachricht enthalten sind, nicht mehr ändern.
Erforderlich | Nein |
Datentyp | Kontrollkästchen |
Vorauslesen (Read Ahead) ist ein Optimierungsverfahren, das Nachrichten präventiv Konsumenten zuordnet. Damit wird die Bearbeitungszeit von Konsumentenanforderungen verkürzt.
Nachrichten, die einem Konsumenten zugeordnet sind, werden auf dem Server gesperrt und können nicht von anderen Konsumenten für diese Destination 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-Destinations überschreiben, indem Sie die Eigenschaft Vorauslesen für die JMS-Destination festlegen.
Erforderlich | Nein |
Datentyp | Auswahlliste |
Einstellmöglichkeiten |
|
Diese Eigenschaft wird nur verwendet, wenn die MDB-Anwendung in einem Server ausgeführt wird, der Member des Zielbusses der Anwendung ist. Sie hat keine Auswirkung, wenn die MDB in einem Server ausgeführt wird, der kein Member des Zielbusses ist.
Falls die MDB-Anwendung in einem Server ausgeführt wird, der Member des Zielbusses ist, ist die MDB-Anwendung bei Aktivierung dieser Option in der Lage, Nachrichten zu verarbeiten, unabhängig davon, ob in dem Server auch eine aktive Messaging-Steuerkomponente vorhanden ist. Falls diese Option nicht aktiviert wird, verarbeiten MDB-Anwendungen in Servern ohne lokale aktive Messaging-Steuerkomponente keine Nachrichten.
Weitere Informationen
finden Sie im Artikel
So stellen nachrichtengesteuerte Beans
eine Verbindung in einem Cluster her (online).
Erforderlich | Nein |
Datentyp | Kontrollkästchen |
Die Verzögerung (in Sekunden) zwischen den Versuchen, eine Verbindung zu einer Messaging-Steuerkomponente herzustellen. Diese Einstellung gilt sowohl für die erste Verbindung als auch für alle nachfolgenden Versuche, eine bessere Verbindung herzustellen.
Erforderlich | Nein |
Datentyp | Integer |
Einstellmöglichkeiten | 1 bis 2147483647 |