Konfiguration des JMS-Empfänger-Adapters 
Verwendung
Sie konfigurieren den JMS-Empfänger-Adapter, um XI-Messages vom Integration Server oder vom PCK in JMS-Nachrichten zu verwandeln.
Integration
Die Adapterkonfiguration ist Teil der Festlegung eines
Kommunikationskanals im 
Integration Server
oder im PCK und wird auf
der Registerkarte Parameter vorgenommen.
Zusätzlich zur Adapterkonfiguration können auf der Registerkarte Module im Modul-Prozessor
generische Module angegeben werden, die den Adapter mit Zusatzfunktionen
ausstatten.
Voraussetzungen
1. Sie haben einen Kommunikationskanal angelegt oder einen bestehenden Kommunikationskanal geöffnet.
2. Sie haben auf der Registerkarte Parameter den Adaptertyp JMS ausgewählt.
3. Sie haben den Adapter über den Auswahlknopf Empfänger als Empfänger-Adapter definiert.
Aktivitäten
Zur Konfiguration des Adapters machen Sie folgende Angaben:
Transport-Protokoll
SonicMQ JMS Provider
WebSphereMQ (MQ Series) JMS Provider
Zugriff auf JMS Provider mit JNDI
Administrierbare Objekte des JMS Provider aus Datei lesen
Generischer Zugriff auf JMS Provider
Message-Protokoll
JMS 1.x
Adapter-Engine
Wählen sie die Adapter-Engine auf dem Integration Server aus oder wählen Sie eine dezentral installierte Adapter-Engine aus. Diese Auswahl ist im PCK nicht möglich.
JMS-Provider-spezifische Einstellungen
Die Bedeutung der Parameter entnehmen Sie der jeweiligen JMS Provider-Dokumentation.
In Abhängigkeit vom gewählten Transport-Protokoll machen Sie Angaben zum jeweiligen JMS Provider. Siehe auch JMS-Provider-spezifische Einstellungen
JMS-Einstellungen
Parameter |
Eingabe |
Transaktionale JMS-Sitzung |
Falls eine transaktionale JMS-Sitzung verwendet werden soll, setzen Sie das Kennzeichen. Eine transaktionale Sitzung wird nach der Verarbeitung einer Nachricht entweder mit COMMIT abgeschlossen oder im Fehlerfall mit ROLLBACK zurückgesetzt. |
Zustellungsmodus des Message-Erzeugers |
Geben Sie den Zustellungsmodus des Message-Erzeugers an. Sie haben folgende Möglichkeiten: · JMS-Nachrichten im JMS-Provider speichern · JMS-Nachrichten im JMS-Provider nicht speichern |
JMS-ReplyTo-Queue-Name |
Geben Sie den Namen der Queue an, an die Antworten geschickt werden sollen. |
Gültigkeitsdauer der JMS-Message |
Geben Sie die Verfallszeit der JMS-Nachricht als JMS-Parameter in msec. an. |
JMS-Message-Priorität |
Geben Sie die Priorität der JMS-Message an. |
JMS-Queue-Benutzer |
Benutzer für den Zugriff auf die JMS-Queue |
JMS-Queue-Passwort |
Kennwort mit Bestätigung für den Zugriff auf die JMS-Queue. |
Einstellungen zur Korrelation
Legen Sie fest, wie die JMS-Correlation-ID gesetzt werden soll.
· Setze JMS-Correlation-ID auf:
¡ XI-Message-ID (Vorgabewert)
¡ RefToMessageID
¡ ConversationID
¡ Kein Wert
· Setze dieses JMS-Property:
Geben Sie den Namen des JMS-Property an.
· Geben Sie an, welchen Wert das JMS-Property haben soll:
¡ XI-Message-ID
¡ RefToMessageID
¡ ConversationID
¡ Kein Wert
XI-Einstellungen
Parameter |
Eingabe |
Mapping der Message |
· Wenn die gesamte Message in der JMS-Payload enthalten sein soll, wählen Sie Gesamte Message = JMS-Payload. · Wenn nur die Payload der Message in die JMS-Payload eingestellt werden soll, dann wählen Sie Message-Payload = JMS-Payload. |
Behandlung von blockierten XI-Messages |
Der Adapter ist in der Lage festzustellen, ob ein Abbruch zwischen dem JMS-Commit und dem Commit auf der Datenbank des Adapter-Framework eingetreten ist. Der Adapter erkennt den dadurch erzeugten doppelten Datensatz. Sie haben folgende Einstellung zur Auswahl: · Ausnahme auslösen (erneuter Sendeversuch später möglich) (Vorgabe). · Warnung ignorieren und Message an JMS senden (Dubletten möglich) Ein doppelter Datensatz wird dann erzeugt, wenn das JMS-Commit durchgeführt wird, nicht jedoch das Commit auf der Datenbank des Adapter-Framework. Wenn Sie diese Option wählen, dann müssen Sie im JMS-Umfeld sicherstellen, dass diese Message noch nicht empfangen wurde. · Message als übermittelt markerien (Verlust der Message möglich) Ein Verlust der Message tritt dann ein, wenn auch das JMS-Commit noch nicht durchgeführt wurde. Wenn Sie diese Option wählen, dann müssen Sie im JMS-Umfeld sicherstellen, dass diese Message schon empfangen wurde.
Ein Beispiel für die Verwendung des Parameters finden Sie unten unter Beispiel. |
Zeitraum der Duplikatprüfung für EI(IO) in Sek. |
Für die Prüfung von doppelten Messages müssen IDs auf der Datenbank gespeichert werden. Damit die Größe der Datenbank nicht unnötig wächst, müssen diese IDs nach einiger Zeit gelöscht werden. Geben Sie in Sekunden an, wann die IDs gelöscht werden sollen (z.B. nach einem Tag, wenn Sie täglich das Message-Monitoring kontrollieren). |
XI Delivery Acknowledgment senden (Adapter ist Empfänger) |
Wenn der JMS-Empfänger eine Anwendung ist, dann sollte der JMS-Adapter ein Delivery-Acknowledgment zurückschicken. Setzen Sie hierzu das Kennzeichen. |
Einstellungen für die Fehlerbehandlung
Parameter |
Eingabe |
Warten nach Message-Fehler (ms) |
Geben Sie die Anzahl der Millisekunden an, die bei einem Verarbeitungsfehler gewartet werden soll, bis weitere Nachrichten verarbeitet werden. Eine gewisse Wartezeit kann beispielsweise bei transaktionaler Verarbeitung sinnvoll sein, da fehlerhafte Nachrichten nach einem ROLLBACK in der Warteschlange stehen bleiben.
|
Warten bis zur neuen Verbindung (ms) |
Geben Sie einen Zeitraum an, nachdem bei einem JMS-seitigen Verbindungsfehler versucht werden soll, die Verbindung neu aufzubauen. Das Zeitintervall wird in Millisekunden angegeben. Bei einem Wert von -1 wird nicht versucht die Verbindung neu aufzubauen.
Diese Funktionalität setzt voraus, dass Ihr JMS-Provider die Registrierung eines ExceptionListener unterstützt.
|
Neue Verbindung, wenn Ausnahmetext beginnt mit
|
Falls der JMS Provider bei Verbindungsfehlern nicht den vom JMS-Adapter registrierten ExceptionListener aufruft, können Sie mit dieser Eingabe die Wiederaufnahme der Verbindung erzwingen. Falls beim Verschicken einer Nachricht eine JMS-Exception ausgelöst wird, wird der hier enthaltene Freitext mit dem angegebenen String verglichen und nach dem unter Reconnect Delay angegebenen Zeitintervall ein Wiederaufbau der Verbindung vorgenommen.
Setzen Sie diesen Parameter nur, wenn Ihr JMS-Provider die Registrierung eines ExceptionListener nicht unterstützt.
|
Adapterstatus
Setzen Sie den Adapter aktiv, um ihn für den Message-Austausch einzusetzen.
Beispiel
Ein typischer Vorgang zur Behandlung von hängenden Messages ist:
...
1. Der JMS-Empfänger-Adapter hat für den Parameter die Voreinstellung Ausnahme auslösen.
2. Sie sehen im Message- und/oder Adapter-Monitor folgende Ausnahme:
The channel is configured to throw a recoverable, temporary error for this warning (default). Decide whether you want to bypass this message. If so, set the Pending Handling channel parameter to 'Bypass' and restart the message afterwards.
3. Stellen Sie sicher, dass keine weiteren Messages durch diesen Kommunikationskanal geschickt werden, indem Sie den korrespondierenden Senderkanal deaktivieren.
4. Sie prüfen, ob die Message(s) im JMS-Umfeld angekommen sind.
a. Falls die Message im JMS-Umfeld angekommen ist, wählen Sie Option Message als übermittelt markerien (Verlust der Message möglich).
b. Falls die Message nicht im JMS-Umfeld angekommen ist, wählen Sie Option Warnung ignorieren und Message an JMS senden (Dubletten möglich).
c. Stoßen Sie Wiederholen im Message-Monitoring an.
Haben Sie Messages vorliegen, von denen einige im JMS-Umfeld angekommen sind und andere nicht, dann müssen Sie den Vorgang zweimal durchführen und jeweils die passenden Messages wiederholt senden.
5. Stellen Sie nun den Parameter im Kommunikationskanal wieder auf Ausnahme auslösen um.
6. Aktivieren Sie den korrespondierenden Sender-Kommunikationskanal.