WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

DataDelete-Knoten

Verwenden Sie den DataDelete-Knoten zur Interaktion mit einer Datenbank innerhalb der angegebenen ODBC-Datenquelle.

Einschränkung: Die von diesem Knoten bereitgestellten Funktionen wurden durch einen überarbeiteten Mapping-Knoten ersetzt. Wenn Sie einen Nachrichtenfluss importieren, der den DataDelete-Knoten enthält, können Sie den Knoten zwar nach wie vor anzeigen und implementieren, jedoch nicht ändern.

Dieses Kapitel enthält folgende Abschnitte:

Zweck

Der DataDelete-Knoten ist eine spezialisierte Form des Datenbank-Knotens, und die Interaktion ist auf das Löschen einer oder mehrerer Zeilen in einer Tabelle der Datenbank beschränkt. Sie legen fest, was gelöscht wird, indem Sie Zuordnungsanweisungen definieren, die mithilfe der Daten aus der Eingabenachricht die erforderliche Aktion identifizieren.

Sie können eine Eigenschaft festlegen, um zu steuern, ob die Datenbank sofort oder erst nach Beendigung des Nachrichtenflusses aktualisiert wird und zu welchem Zeitpunkt die Aktualisierung entsprechend dem Gesamtbeendigungsstatus des Nachrichtenflusses festgeschrieben oder zurückgesetzt wird.

Diesen Knoten in einem Nachrichtenfluss verwenden

Stellen Sie sich vor, Sie führen eine begrenzte Werbeaktion aus. Die Waren sind nur für die Dauer dieser Aktion erhältlich, und jeder Kunde darf nur ein Produkt bestellen. Wenn der Warenbestand ausläuft, möchten Sie die entsprechenden Einzeldaten aus der Bestandsdatenbank löschen. Sobald eine Nachricht mit der Bestellung des letzten Produkts eingeht, wird der DataDelete-Knoten ausgelöst, der sämtliche Einzelangaben zu diesem Produkt aus der Datenbank entfernt.

Terminals und Eigenschaften

Wenn Sie eine Instanz des DataDelete-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn konfigurieren. Der Abschnitt Nachrichtenflussknoten konfigurieren enthält weitere Informationen hierzu. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt. (Durch Doppelklicken auf einen DataDelete-Knoten wird das Dialogfenster Neue Nachrichtenzuordnung geöffnet.) Alle verbindlichen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Sternchen gekennzeichnet.

In der folgenden Tabelle werden die Terminals des DataDelete-Knotens beschrieben.

Terminal Beschreibung
Eingabeterminal (In) Das Eingabeterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt
Fehlerterminal (Failure) Das Ausgabeterminal, an das die Eingabenachricht geleitet wird, wenn während der Berechnung ein Fehler auftritt. Wenn Sie die Option Warnungen als Fehler behandeln ausgewählt haben, gibt der Knoten die Nachricht auch dann an dieses Terminal weiter, wenn die Verarbeitung erfolgreich beendet wird.
Ausgang Das Ausgabeterminal, das die Nachricht nach Ausführung der Datenbankanweisung ausgibt.

In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte O zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte K zeigt an, ob die Eigenschaft konfigurierbar ist (Wert kann geändert werden, wenn der Nachrichtenfluss zur BAR-Datei hinzugefügt wird, um ihn einzusetzen).

In der folgenden Tabelle werden die Beschreibungseigenschaften des DataDelete-Knotens beschrieben.

Eigenschaft O K Standardwert Beschreibung
Knotenname Nein Nein DataDelete Der Name des Knotens.
Kurzbeschreibung Nein Nein   Kurze Beschreibung des Knotens.
Langbeschreibung Nein Nein   Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt

In der folgenden Tabelle werden die grundlegenden Eigenschaften des DataDeletesknotens beschrieben.

Eigenschaft O K Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Datenquelle Nein Ja   Der Name der ODBC-Datenquelle für die Datenbank mit den Tabellen, auf die Sie in den mit diesem Knoten verknüpften Zuordnungen verweisen (wie unter der Eigenschaft Anweisung festgelegt).

Dieser Name gibt den Namen der entsprechenden Datenbank an, unter dem sie in dem System, auf dem dieser Nachrichtenfluss ausgeführt werden soll, gespeichert ist. Der Broker stellt mit der Benutzer-ID und dem Kennwort, die Sie im Befehl mqsisetdbparms angegeben haben, eine Verbindung zu dieser Datenbank her.

dataSource
Anweisung Ja Nein DataDelete Der Name der Zuordnungsroutine, die die Anweisungen enthält, die gegen die Datenbank oder Nachrichtenbaumstruktur ausgeführt werden sollen. Die Routine ist eindeutig und kann nur mit diesem Knotentyp verwendet werden. Standardmäßig ist der Name der Zuordnungsroutine identisch mit dem Namen der Abgleichungsdatei, in der die Routine definiert ist. Der Standardname der Datei ist der Name des Nachrichtenflusses, der mit dem Knotennamen verknüpft wird, wenn Sie ihn in den Nachrichtenfluss einschließen (z. B. MFlow1_DataDelete.msgmap für den ersten DataDelete-Knoten im Nachrichtenfluss MFlow1). Sie können keinen Wert angeben, der Leerzeichen enthält.

Wenn Sie neben dem Eingabefeld auf Durchsuchen klicken, wird ein Dialogfenster mit allen verfügbaren Zuordnungsroutinen angezeigt, auf die dieser Knoten zugreifen kann. Wählen Sie die gewünschte Routine aus, und klicken Sie auf OK; der Name der Routine wird unter Anweisung angegeben.

Um mit der Zuordnungsroutine, die mit diesem Knoten verknüpft ist, zu arbeiten, klicken Sie doppelt auf den Knoten, oder klicken Sie mit der rechten Maustaste auf den Knoten, und klicken Sie im Kontextmenü auf Zuordnungen öffnen. Wenn die Zuordnungsroutine nicht existiert, wird sie für Sie mit dem Standardnamen in der Standarddatei erstellt. Wenn die Datei existiert, können Sie die Datei Nachrichtenflussname_Knotenname.msgmap auch in der Ansicht Brokerentwicklung öffnen.

Eine Zuordnungsroutine kann nur mit dem Knotentyp verwendet werden, mit dem sie verknüpft ist. Sie können eine für einen DataDelete-Knoten entwickelte Zuordnungsroutine nicht mit einem anderen Knoten einsetzen, der Zuordnungen verwendet (z. B. einem DataInsert-Knoten). Wenn Sie eine Zuordnungsroutine erstellen, können Sie diese nicht aus einer anderen Zuordnungsroutine heraus aufrufen, obwohl sie aus einer ESQL-Routine heraus aufgerufen werden kann.

Weitere Informationen zum Arbeiten mit Zuordnungsdateien und Definieren ihres Inhalts erhalten Sie unter Grafische Datenzuordnungen verwenden.

 
Transaktion Ja Nein Automatisch Der Transaktionsmodus für den Knoten. Folgende Werte stehen zur Verfügung:
  • Automatisch (Standardwert). Der Nachrichtenfluss, dessen Bestandteil der DataDelete-Knoten ist, wird bei erfolgreicher Ausführung festgeschrieben; d. h., die Aktionen, die Sie in den Zuordnungen definieren, werden ausgeführt, und die Nachricht setzt ihren Weg durch den Nachrichtenfluss fort. Wenn der Nachrichtenfluss fehl schlägt, wird er zurückgesetzt. Wenn Sie also die Option Automatisch auswählen, hängt die Fähigkeit, die Aktionen des DataDelete-Knotens in der Datenbank festzuschreiben bzw. zurückzusetzen, vom Erfolg oder Scheitern des gesamten Nachrichtenflusses ab.
  • Festschreiben. Wenn alle nicht festgeschriebenen Aktionen, die in diesem Nachrichtenfluss in der mit diesem Knoten verbundenen Datenbank ausgeführt werden, unabhängig vom Erfolg oder Scheitern des gesamten Nachrichtenflusses festgeschrieben werden sollen, wählen Sie die Option Festschreiben aus. Die Datenbankänderungen werden festgeschrieben, selbst wenn der Nachrichtenfluss fehlschlägt.
 
Warnungen als Fehler behandeln Ja Nein Nicht ausgewählt Wenn Datenbankwarnungen als Fehler behandelt werden sollen und der Knoten die Ausgabenachricht an das Fehlerterminal (Failure) weitergeben soll, aktivieren Sie Warnungen als Fehler behandeln. Das Kontrollkästchen ist standardmäßig inaktiviert.

Wenn Sie es aktivieren, behandelt der Knoten alle positiven Rückkehrcodes von der Datenbank als Fehler und generiert Ausnahmebedingungen auf dieselbe Art wie bei negativen oder schwerwiegenden Fehlern.

Wenn Sie das Kontrollkästchen nicht aktivieren, behandelt der Knoten Warnungen als normale Rückkehrcodes und löst keine Ausnahmebedingungen aus. Die höchstwertige Warnung, die ausgegeben werden kann, lautet nicht gefunden. Sie kann in den meisten Fällen als normaler Rückkehrcode sicher bearbeitet werden.

 
Ausnahmebedingung für Datenbankfehler ausgeben Ja Nein Ausgewählt Wenn der Broker bei Erkennung eines Datenbankfehlers eine Ausnahmebedingung generieren soll, aktivieren Sie Ausnahme für Datenbankfehler ausgeben. Das Kontrollkästchen ist standardmäßig aktiviert.

Wenn Sie das Kontrollkästchen inaktivieren, müssen Sie den Fehler im Nachrichtenfluss bearbeiten, um die Integrität des Brokers und der Datenbank zu gewährleisten. Wenn Sie den Fehler nicht über einen eigenen Prozess bearbeiten, wird er ignoriert, da Sie sich gegen den Aufruf der Standardfehlerbehandlung durch den Broker entschieden haben. Sie könnten beispielsweise das Fehlerterminal (Failure) mit einer Fehlerbehandlungs-Subroutine verbinden.

 

Verbinden, bevor Fluss startet

Nein

Ja

Nicht ausgewählt

Standardmäßig stellt der Broker eine Verbindung mit der Datenquelle her, wenn dies in einem Nachrichtenfluss erforderlich ist.

Wenn Sie das Kontrollkästchen aktivieren, werden Datenquellenverbindungen hergestellt, bevor der Nachrichtenfluss eine Nachricht empfängt, und nicht erst während der Nachrichtenflussverarbeitung.

 
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:19:54


ReferenzthemaReferenzthema | Version 8.0.0.5 | ac04680_