Automation Engine Script-Leitfaden > Funktionelle Gliederung > Fehlerbehandlung und Meldungen > :ON_ERROR

:ON_ERROR

Script-Anweisung: Legt die Reaktion auf bestimmte Fehler bzw. Meldungen von Script-Sprachmitteln fest.

Syntax

:ON_ERRORReaction

Syntax	Beschreibung/Format
Reaktion	Schlüsselwort für die Reaktion auf Fehler bzw. Meldungen. Format: AE-Name, Script-Literal oder Script-Variable Erlaubte Werte: "ABEND", "RESUME" Standardwert: "RESUME" "ABEND" - Script-Prozessierung wird abgebrochen "RESUME" - Script-Prozessierung wird fortgesetzt

Syntax

Beschreibung/Format

Reaktion

Schlüsselwort für die Reaktion auf Fehler bzw. Meldungen.
Format: AE-Name, Script-Literal oder Script-Variable

Erlaubte Werte: "ABEND", "RESUME"
Standardwert: "RESUME"
"ABEND" - Script-Prozessierung wird abgebrochen
"RESUME" - Script-Prozessierung wird fortgesetzt

Anmerkungen

Die Script-Anweisung beeinflusst folgende Script-Funktionen:

ACTIVATE_UC_OBJECT	LAST_OF_PERIOD
AUTOFORECAST	MODIFY_OBJECT
CANCEL_UC_OBJECT	MOVE_OBJECT
CHANGE_LOGGING	PREP_PROCESS_FILENAME
CREATE_OBJECT	REMOVE_OBJECT
EXPORT	RESTART_UC_OBJECT
FIRST_OF_PERIOD	SEND_MAIL
GET_FILESYSTEM	SEND_MSG
GET_OBJECT_TYPE	SYS_SERVER_ALIVE
GET_STATISTIC_DETAIL	SYS_USER_ALIVE
IMPORT

AE arbeitet standardmäßig so, dass bei diesen Script-Funktionen die Script-Prozessierung nicht abbricht, wenn bestimmte Fehler auftreten. Der Fehler kann nach Auftreten mit den Script-Funktionen zur Fehlerbehandlung analysiert werden.

Mit dem Parameter "ABEND" zwingen Sie das Script bei Fehlern zum Abbruch. Bei der Verwendung von "RESUME" hingegen wird das Script fortgesetzt und die Rückgabewerte der zuvor aufgelisteten Funktionen sind auslesbar.

Beispiel

Im Beispiel wird festgelegt, dass bei einem Fehler das Script nicht abbricht. Anschließend wird versucht, die Speicherkapazität eines nicht vorhandenen Laufwerkes zu prüfen. Dabei kommt es zu einem Fehler, der mit den Script-Funktionen zur Fehlerbehandlung analysiert wird.

:ON_ERROR RESUME
:SET &CHECK# = GET_FILESYSTEM('WIN21', 'Z:\', FILESYSTEM_SPACE_TOTAL)
:SET &ERRNR# = SYS_LAST_ERR_NR
:SET &ERRINS# = SYS_LAST_ERR_INS
:SET &MESSAGE# = GET_MSG_TXT (&ERRNR#,&ERRINS#)

Siehe auch:

Script-Sprachmittel - Fehlerbehandlung und Meldungen

Beispielsammlung:
Ermittlung der Fehlermeldung und -nummer

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

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support