:STOP

Verwenden Sie das Script-Statement :STOP, um die Verarbeitung eines Scripts abzubrechen. Mit dem Script-Statement 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-Script.

Hinweis: Dieses Script-Statement 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-Script durchzuführen, verwenden Sie das Script-Statement :MODIFY_STATE.

Syntax

:STOP[Stop Mode]

Parameter

• :STOP
  Bricht die Verarbeitung des Scripts ab

• Stop Mode
  (Optional) Legt fest, ob eine Fehlermeldung ausgegeben werden soll oder nicht
  Erlaubte 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 das 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]
    Dieses Statement bricht die Aktivierung des Objekts 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-Statements arbeiten, z. B. um Variablen zu setzen.

  • Kein Stoppmodus
    Wenn Sie keinen Stop-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, "Error in activating the job MM."
:ELSE
: PRINT "The job MM was activated with the activation number &ACTNR#."
:ENDIF

Siehe auch: