:SET_LAST_ERR

Fehlerbehandlung und Meldungen

GET_MSG_TXT

---

:STOP

Script-Anweisung: Bricht die Aktivierung eines Scripts ab.

Syntax

:STOP [Stopmodus]

Kommentare

:STOP bricht die Aktivierung eines Objektes ab. Deshalb kann das Sprachmittel nicht in Post-Script-Registerkarten verwendet werden. Nutzen Sie in solchen Fällen die Anweisung :MODIFY_STATE.

Stopmodus NOMSG

Die :STOP-Anweisung mit dem Stopmodus NOMSG kann in Objekten verwendet werden, die keine Ausführung durch einen Agenten erfordern. Dadurch ist es möglich, ausschließlich mit Script-Sprachmitteln zu arbeiten, also beispielsweise Variablen zu setzen.

Beim Stopmodus NOMSG kann zusätzlich eine Meldung erzeugt werden. Die Meldungsnummer ist syntaktisch notwendig, wird aber nicht ausgewertet. Der Meldungstext wird in der Statistik gespeichert und bei einem Aufruf über das CallAPI als Teil der Quittung geschickt. Damit können Sie dem CallAPI beispielsweise die laufende Nummer (RunID) einer gestarteten Aufgabe zurückgeben.

Da der Stopmodus NOMSG die Aktivierung einer Aufgabe ohne Fehler beendet, wird diese in der Statistik nicht als abgebrochene Aufgabe angezeigt.

Stopmodus MSG

Den Stopmodus MSG können Sie benutzen, um die Aktivierung eines Objektes mit einer Fehlermeldung abzubrechen. Sie können dabei eine Fehlernummer und einen Fehlertext angeben. Dies ist besonders für Objekte relevant, 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. Die Fehlernummern 50 bis 59 sind für Benutzer reserviert.

Die Fehlernummer 50 führt zum Rückgabewert 4 und die Fehlernummern 51 bis 59 beenden das Dienstprogramm mit Rückgabewert 8.

Beachten Sie, dass nur die Fehlernummern 50–59 verwendet werden können! Andere Fehlernummern führen zum Abbruch des Scripts mit der Meldung, dass die angegebene Fehlernummer ungültig ist.

Da der Stopmodus MSG die Aktivierung einer Aufgabe einem mit Fehler beendet, wird diese in der Statistik als abgebrochene Aufgabe angezeigt (FAULT_OTHER - Start nicht möglich).

Wird die :STOP-Anweisung ohne Parameter bzw. mit dem Stopmodus MSG verwendet, bricht die Script-Verarbeitung mit einem Fehler ab. Dabei findet ein Datenbank-Rollback statt. Alle noch nicht ausgeführten Transaktionen werden rückgängig gemacht. Haben Sie Script-Variablen benutzt, kann es möglich sein, dass die zu Beginn des Scripts stehenden Variablen-Objekte ihre neuen Werte bereits gespeichert haben, jene am Ende des Scripts jedoch nicht.

Das System schreibt Transaktionen in der AE-Datenbank fest (Commit), wenn die Script-Verarbeitung unterbrochen wird. Dieser Zeitpunkt tritt

• automatisch in Abständen von 5 Sekunden,
• durch Script-Sprachmittel, wie beispielsweise ACTIVATE_UC_OBJECT, GET_FILESYSTEM, :READ, PREP_PROCESS, PREP_PROCESS_FILE,
• und durch die Script-Anweisung :WAIT ein.

Mit der Anweisung :WAIT 0 erzwingen Sie eine Unterbrechung der Script-Verarbeitung und somit ein Datenbank-Commit.

Beispiele

Das folgende Beispiel gibt eine Fehlermeldung zurück mit der Information, 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:

Script-Sprachmittel - Objekte aktivieren
Script-Sprachmittel - Fehlerbehandlung und Meldungen

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung