:STOP

Verwenden Sie die Script-Anweisung:STOP, um die Verarbeitung eines Scripts abzubrechen. Mit der Script-Anweisung können Sie das Script mit oder ohne Fehlermeldung abbrechen.

Wichtig! :STOP bricht die Aktivierung des Objekts ab, das das Script enthält. Verwenden Sie :STOP nicht auf der Seite Post-Prozess.

Hinweis: Diese Script-Anweisung bewirkt, dass alle offenen Transaktionen des Scripts in die AE-Datenbank geschrieben werden. Weitere Informationen finden Sie unter Script-Verarbeitung.

Tipp: Um Änderungen über Scripts auf der Seite Post-Prozess durchzuführen, verwenden Sie die Script-Anweisung :MODIFY_STATE.

Syntax

:STOP[Stopp-Modus]

Parameter

• :STOP
  Bricht die Verarbeitung des Scripts ab

• Stopp-Modus
  (optional) gibt an, ob eine Fehlermeldung ausgegeben werden soll
  Zulässige Werte:

  • MSG, Fehlernummer, Fehlertext
    bricht die Aktivierung des Objekts ab und gibt eine Fehlermeldung aus
    Wichtig!

    • Verwenden Sie nur Fehlernummern zwischen 50 und 59. Dieser Bereich ist für Benutzer reserviert. Andere Fehlernummern führen dazu, dass das Script mit einer Fehlermeldung abbricht.
    •  Die Fehlernummer 50 führt zum Rückgabewert 4 und die Fehlernummern 51 bis 59 beenden das Dienstprogramm mit Rückgabewert 8.
    Hinweise:
    • Die Angabe einer Fehlernummer und Fehlermeldung ist für Objekte wichtig, die über die AE-CallAPI starten. Die so zurückgegebenen Informationen bilden dort die einzige Möglichkeit, etwas über die Durchführung des Scripts zu erfahren.
    • Aufgaben, die Sie in diesem Modus stoppen, werden in den Ausführungsdaten als abgebrochene Aufgaben aufgelistet.

  • NOMSG, Meldungsnummer[, Meldungstext]
    Bricht die Aktivierung des Objekts ohne Fehler ab
    Hinweise:

    • Die Meldungsnummer ist syntaktisch notwendig, wird aber nicht ausgewertet.
    • Geben Sie optional einen Meldungstext ein. Der Text wird in den Ausführungsdaten gespeichert und als Teil der Bestätigung gesendet, wenn ein Aufruf über die CallAPI erfolgt.
    • Dieser Modus kann in Objekten verwendet werden, die keinen Agenten zur Bearbeitung benötigen. Sie können nur mit Script-Anweisungen arbeiten, z. B. um Variablen zu setzen.

  • Kein Stopp-Modus
    Wenn Sie keinen Stopp-Modus-Parameter angeben, bricht :STOP die Verarbeitung des Scripts ab und schreibt die Fehlermeldung U0010014 in den Aktivierungsreport.
    Hinweise:

    • Es findet ein Datenbank-Rollback statt. Alle Transaktionen, die nicht speziell ausgeführt werden, werden zurückgesetzt.
    • Variablen, die am Anfang des Scripts verwendet werden, können bereits neue Werte enthalten, während Scripts am Ende des Scripts keine Werte erhalten haben.

Beispiel

Das Beispiel gibt eine Fehlermeldung in Abhängigkeit davon aus, ob ein Job korrekt aktiviert wurde oder nicht.

:SET &ACTNR# = ACTIVATE_UC_OBJECT(JOBS, MM)
:IF &ACTNR# = "0"
: STOP MSG, 50, "Fehler bei der Aktivierung des Jobs MM."
:ELSE
: PRINT "Der Job MM wurde mit der Aktivierungsnummer &ACTNR# aktiviert."
:ENDIF

Siehe auch: