Dieses Kapitel enthält folgende Abschnitte:
Verwenden Sie den Datenlöschknoten zur Interaktion mit einer Datenbank innerhalb der angegebenen ODBC-Datenquelle. Der Datenlöschknoten ist eine spezielle Form des Datenbankknotens, 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 mit Hilfe der Daten aus der Eingabenachricht die erforderliche Aktion identifizieren.
Sie können eine Eigenschaft so konfigurieren, dass gesteuert wird, ob die Datenbank sofort oder erst nach Beendigung des Nachrichtenflusses aktualisiert wird, und zu welchem Zeitpunkt die Aktualisierung entsprechend dem Gesamtabschluss-Status des Nachrichtenflusses festgeschrieben oder zurückgesetzt wird.
Der Datenlöschknoten wird in der Workbench durch folgendes Symbol dargestellt:
Stellen Sie sich vor, Sie führen eine begrenzte Werbeaktion aus. Die Waren sind nur für die Dauer dieser Aktion erhältlich, und für jeden Kunde gibt es jeweils nur ein Produkt. 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 Datenlöschknoten ausgelöst und entfernt sämtliche Einzelangaben zu diesem Produkt aus der Datenbank.
Wenn Sie eine Instanz des Datenlöschknotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn konfigurieren. Klicken Sie mit der rechten Maustaste in der Editoransicht auf den Knoten, und wählen Sie die Option Eigenschaften aus. Daraufhin werden die grundlegenden Eigenschaften des Knotens angezeigt.
Alle verbindlichen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind dort mit einem Sternchen gekennzeichnet.
Konfigurieren Sie den Datenlöschknoten wie folgt:
Auf z/OS-Systemen verwendet der Broker die vom Broker gestartete Task-ID oder die Benutzer-ID und das Kennwort, die im angepassten Datensatz <hlq>.SBIPPROC im mqsisetdbparms-Befehl 'JCL, BIPSDBP' angegeben wurden.
Wenn Sie neben dem Eingabefeld auf Durchsuchen klicken, wird ein Dialogfeld 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 zu arbeiten, die mit diesem Knoten verknüpft ist, klicken Sie mit der rechten Maustaste auf den Knoten und wählen im Kontextmenü die Option Zuordnungen öffnen aus. Wenn die Zuordnungsroutine nicht existiert, wird sie für Sie mit dem Standardnamen in der Standarddatei erstellt. Wenn die Datei bereits existiert, können Sie die Datei <Nachrichtenflussname>_<Knotenname>.mfmap auch in der Navigatoransicht öffnen.
Eine Zuordnungsroutine kann nur mit dem Knotentyp verwendet werden, mit dem sie verknüpft ist. Sie können eine für einen Datenlöschknoten entwickelte Zuordnungsroutine nicht mit einem anderem Knoten einsetzen, der Zuordnungen verwendet (z. B. einem Dateneinfügeknoten). Wenn Sie eine Zuordnungsroutine erstellen, können Sie sie nicht aus einer anderen Zuordnungsroutine heraus aufrufen, obwohl sie aus einer ESQL-Routine heraus aufgerufen werden kann.
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 Kästchen nicht aktivieren, behandelt der Knoten Warnungen als normale Rückkehrcodes und gibt keine Ausnahmebedingung 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.
Wenn Sie es inaktivieren, müssen Sie den Fehler im Nachrichtenfluss bearbeiten, um die Integrität des Brokers und der Datenbank zu gewährleisten: der Fehler wird ignoriert, wenn Sie ihn nicht über ihren eigenen Prozess bearbeiten, da Sie kein Aufrufen der Standardfehlerbehandlung durch den Broker ausgewählt haben. Sie könnten beispielsweise das Fehlerterminal mit einer Fehlerverarbeitungs-Subroutine verbinden.
Klicken Sie auf Abbrechen, um das Dialogfeld zu schließen und alle Änderungen zu verwerfen, die Sie an den Eigenschaften vorgenommen haben.
In der nachfolgenden Tabelle werden die Terminals des Datenlöschknotens beschrieben.
Terminal | Beschreibung |
---|---|
Eingangsterminal | Das Eingangsterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt |
Fehlerterminal | 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 der nachfolgenden Tabelle werden die Knoteneigenschaften beschrieben. Die Spalte M zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen im Eigenschaftendialog, ob Sie einen Wert eingeben müssen, wenn kein Standardwert definiert ist). Die Spalte C zeigt an, ob die Eigenschaft konfigurierbar ist (Sie können den Wert ändern, wenn Sie der BAR-Datei den Nachrichtenfluss hinzufügen, um ihn einzusetzen).
In der nachfolgenden Tabelle werden die grundlegenden Eigenschaften des Datenlöschknotens beschrieben.
Eigenschaft | M | C | Standard | Beschreibung |
---|---|---|---|---|
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). | |
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. |
Transaktion | Ja | Nein | Automatisch | Der Transaktionsmodus für den Knoten. Dieser kann Automatisch oder Festschreiben lauten. |
Warnungen als Fehler behandeln | Ja | Nein | Nicht ausgewählt | SQL-Datenbankwarnungen als Fehler behandeln. Wenn Sie das Markierungsfeld aktivieren, wird der Vorgang ausgeführt. |
Ausnahmebedingung für Datenbankfehler ausgeben | Ja | Nein | Ausgewählt | Datenbankfehler führen dazu, dass der Broker eine Ausnahmebedingung auslöst. Wenn Sie das Markierungsfeld aktivieren, wird der Vorgang ausgeführt. |
In der nachfolgenden Tabelle werden die Beschreibungseigenschaften des Datenlöschknotens beschrieben.
Eigenschaft | M | C | Standard | Beschreibung |
---|---|---|---|---|
Kurzbeschreibung | Nein | Nein | Kurze Beschreibung des Knotens | |
Ausführliche Beschreibung | Nein | Nein | Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt |