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

:SET_LAST_ERR

Script-Anweisung: Setzt Fehlernummer und -text.

Syntax

:SET_LAST_ERR Number, [Insert]

Syntax	Beschreibung/Format
Nummer	Fehlernummer Format: Zahl, Script-Variable oder Script-Funktion
Insert	Fehlertext, variabler Teil der Fehlermeldung. Format: Script-Literal, Script-Variable oder Script-Funktion

Kommentare

Die Script-Anweisung :SET_LAST_ERR setzt Fehlernummer und -text. Die Anweisung überschreibt dabei Fehlernummer und/oder variablen Teil der letzten Fehlermeldung. Die Angabe von Insert ist optional. Wird Insert nicht angegeben, ist der variable Teil der Fehlermeldung ein Leerstring.

Achten Sie darauf bei der Fehlermeldung eine gültige Nummer anzugeben. Eine Liste aller verfügbaren Meldungen mit ihren Texten finden Sie im Meldungshandbuch.

Besitzt die Meldung mehrere variable Teile, so sind diese mit einem "|" getrennt anzugeben. Die Reihenfolge ist ebenfalls im Meldungshandbuch ersichtlich.

Mit :SET_LAST_ERR 0 können Fehlernummer und -text gelöscht werden.

Die gesamte geänderte Fehlermeldung erhalten Sie mit GET_MSG_TXT.

Beispiel

Im Beispiel wird die Fehlernummer "20657" zusammen mit den beiden variablen Meldungsteilen gesetzt.

:SET_LAST_ERR 20657,"MM.DAY|20||OBJECTS"
:SET &ERRINS# = SYS_LAST_ERR_INS()
:SET &ERRNR# = SYS_LAST_ERR_NR()
:SET &MSG# = GET_MSG_TXT(&ERRNR#, &ERRINS#)
:PRINT &MSG#

Auszug aus dem Meldungshandbuch: 20657 - Laufzeitfehler in Objekt '&01' Zeile '&02': Zielordner '&04' nicht gefunden.

Das Ergebnis der Script-Anweisung lautet:

U0020657 Runtime error in object 'MM.DAY', line '20'. Destination folder 'OBJECTS' not found.

Siehe auch:

Script-Sprachmittel	Beschreibung
SYS_LAST_ERR_INS	Liefert den variablen Teil der Fehlermeldung bei einem zuletzt aufgetretenen Fehler.
SYS_LAST_ERR_NR	Gibt die Fehlernummer eines zuletzt aufgetretenen Fehlers zurück.
SYS_LAST_ERR_SYSTXT	Ermittelt den Fehlertext des Betriebssystems eines zuletzt aufgetretenen Fehlers.

Script-Sprachmittel - Fehlerbehandlung und Meldungen

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