JMS-Gateway konfigurieren

Verwenden Sie die folgende Prozedur, um JMS-Gateways zu erstellen.

  1. Klicken Sie auf Kontenadmin > Profile > Community-Teilnehmer.
  2. Geben Sie Suchkriterien ein, und klicken Sie auf Suchen, oder klicken Sie auf Suchen, ohne Suchkriterien einzugeben, um eine Liste aller Teilnehmer anzuzeigen.
  3. Klicken Sie auf das Symbol Details anzeigen, um das Profil des Teilnehmers anzuzeigen.
  4. Klicken Sie auf Gateways.
  5. Klicken Sie auf Erstellen.

Gateway-Details

Führen Sie über die Seite Gateway-Liste die folgenden Schritte aus:

  1. Geben Sie einen Namen ein, um das Gateway anzugeben. Dies ist ein erforderliches Feld.
  2. Geben Sie optional den Status des Gateways an. Aktiviert ist die Standardeinstellung. Ein aktiviertes Gateway ist für das Senden von Dokumenten bereit. Ein inaktiviertes Gateway kann keine Dokumente senden.
  3. Geben Sie optional an, ob das Gateway online oder offline ist. Die Standardeinstellung ist Online.
  4. Geben Sie optional eine Beschreibung für das Gateway ein.

Gatewaykonfiguration

Führen Sie die folgenden Schritte im Abschnitt Gatewaykonfiguration der Seite aus:

  1. Wählen Sie JMS in der Liste Transport aus.
  2. Geben Sie in das Feld Adresse die URI ein, der das Dokument zugestellt werden soll. Dieses Feld ist erforderlich.

    Für WebSphere MQ-JMS lautet das Format der Ziel-URI wie folgt:

    file:///<benutzerdefinierter_MQ_JNDI_bindings_pfad>

    Beispiel:

    file:///opt/JNDI-Directory

    Das Verzeichnis enthält die ".bindings"-Datei für die dateibasierte JNDI. Diese Datei gibt WebSphere Partner Gateway an, wie das Dokument an sein beabsichtigtes Ziel weitergeleitet wird.

    Dieses Feld ist erforderlich.

  3. Geben Sie optional einen Benutzernamen und ein Kennwort ein, wenn ein Benutzername und ein Kennwort für den Zugriff auf die JMS-Warteschlange erforderlich sind.
  4. Geben Sie in das Feld Wiederholungszahl die Anzahl Versuche ein, die das Gateway unternehmen soll, um ein Dokument zu senden, bevor es fehlschlägt. Der Standardwert ist 3.
  5. Geben Sie in das Feld Wiederholungsintervall die Zeit ein, die das Gateway warten soll, bevor es versucht, das Dokument erneut zu senden. Der Standardwert ist 300 Sekunden.
  6. Geben Sie in das Feld Anzahl Threads die Anzahl Dokumente ein, die gleichzeitig verarbeitet werden können. Der Standardwert ist 3.
  7. Wählen Sie im Feld Client-IP prüfen die Option Ja aus, wenn Sie wollen, dass die IP-Adresse des Absenders geprüft wird, bevor das Dokument verarbeitet wird. Wählen Sie andernfalls Nein aus. Die Standardeinstellung ist Nein.
  8. Wählen Sie im Feld Autom. Warteschlange die Option Ja aus, wenn Sie wollen, dass das Gateway (automatisch) offline gehen soll, wenn ein Übermittlungsfehler auftritt, weil die Anzahl Wiederholungen aufgebraucht ist. Wählen Sie andernfalls Nein aus. Die Standardeinstellung ist Nein.

    Wenn Sie Autom. Warteschlange auswählen, bleiben alle Dokumente so lange in der Warteschlange, bis das Gateway wieder manuell online gestellt wird.

  9. Geben Sie im Feld Authentifizierung erforderlich an, ob ein Benutzername und ein Kennwort mit dem Dokument bereitgestellt werden. Die Standardeinstellung ist Nein.
  10. Geben Sie im Feld JMS-Factory-Name den Namen der Java-Klasse ein, den der JMS-Provider verwendet, um eine Verbindung zur JMS-Warteschlange herzustellen. Dieses Feld ist erforderlich.

    Für interne JMS-Gateways sollte dieser Name mit dem Namen übereinstimmen, den Sie mit dem Befehl define qcf angegeben haben, als Sie die .bindungs-Datei erstellt haben (Schritt 4).

    Wenn Sie den Unterordner für den JMS-Kontext in Schritt 2 eingegeben haben, geben Sie hier nur den Factory-Namen ein, z. B. Hub. Wenn Sie den Unterordner für den JMS-Kontext nicht im Feld Adresse eingegeben haben, geben Sie den Unterordner vor dem Factory-Namen ein, z. B. JMS/Hub.

  11. Geben Sie im Feld JMS-Nachrichtenklasse die Nachrichtenklasse ein. Zu den Auswahlmöglichkeiten gehören alle gültigen JMS-Nachrichtenklassen, wie z. B. TextMessage oder BytesMessage. Dieses Feld ist erforderlich.
  12. Geben Sie in das Feld JMS-Nachrichtentyp den Nachrichtentyp ein. Dies ist ein optionales Feld.
  13. Geben Sie in das Feld Provider-URL-Pakete den Namen der Klassen (oder JAR-Datei) ein, mit denen Java den JMS-Kontext-URL versteht. Dieses Feld ist optional. Wenn Sie keinen Wert angeben, wird der Dateisystempfad zur ".bindings"-Datei verwendet.
  14. Geben Sie in das Feld JMS-Warteschlangenname den Namen der JMS-Warteschlange ein, an die Dokumente gesendet werden. Dieses Feld ist erforderlich.

    Für interne JMS-Gateways sollte dieser Name mit dem Namen übereinstimmen, den Sie mit dem Befehl define q angegeben haben, als Sie die .bindungs-Datei erstellt haben (Schritt 4).

    Wenn Sie den Unterordner für den JMS-Kontext in Schritt 2 eingegeben haben, geben Sie hier nur den Namen der Warteschlange ein, z. B. outQ. Wenn Sie den Unterordner für den JMS-Kontext nicht im Feld JMS-Provider-URL eingegeben haben, geben Sie den Unterordner vor dem Namen der Warteschlange ein, z. B. JMS/outQ.

  15. Geben Sie in das Feld JMS-JNDI-Factory-Name den Factory-Namen ein, der für den Verbindungsaufbau zum Namensservice verwendet wird. Dieses Feld ist erforderlich. Sie werden wahrscheinlich den Wert com.sun.jndi.fscontext.RefFSContextFactory verwenden, wenn Sie Ihre JMS-Konfiguration, wie in Den Hub für das JMS-Transportprotokoll konfigurieren beschrieben, einrichten.
  16. Wenn Sie den Vorverarbeitungs- oder den Nachverarbeitungsschritt für das Gateway konfigurieren wollen, fahren Sie mit Handler konfigurieren fort. Ansonsten klicken Sie auf Speichern.

Copyright IBM Corp. 2003, 2005