Automation Engine Script-Leitfaden > Funktionelle Gliederung > Fehlerbehandlung und Meldungen > SYS_LAST_ERR_INS

SYS_LAST_ERR_INS

Script-Funktion: Liefert den variablen Teil der Fehlermeldung bei einem zuletzt aufgetretenen Fehler.

Syntax

SYS_LAST_ERR_INS()

Rückgabewerte

Variabler Teil der Meldung des zuletzt aufgetretenen Fehlers.
" " - Es ist kein Fehler aufgetreten.

Kommentare

Bei einigen ausgewählten Script-Sprachmitteln kann durch der Verwendung von:ON_ERROR das Script bei Fehlern trotzdem fortgesetzt werden. In diesen Fällen ist der variable Teil der Fehlermeldung mit der Funktion ermittelbar.

Die meisten Fehlermeldungen bestehen nicht nur aus einem vorgegebenen Text. Teile der Meldung beziehen sich z.B. auf Objektnamen oder Zeilen im Script. Diese variablen Teile der Fehlermeldung sind in einfache Hochkommata eingeschlossen.

Beispiel für eine Fehlermeldung:

U0020645 - Laufzeitfehler in Objekt '&01' Zeile '&02': Es konnte kein Objekt mit dem Namen '&04' gefunden werden.

Wenn die Fehlermeldung ausgegeben wird, werden die variablen Teile entsprechend ausgefüllt:

U0020645 - Laufzeitfehler in Objekt 'MOVE_OBJECT' Zeile '0003': Es konnte kein Objekt mit dem Namen 'MAWI.ABSCHLUSS.2005' gefunden werden.

Beispiel

Das Beispiel versucht, die Speicherkapazität eines Laufwerkes zu prüfen. Ist dies nicht vorhanden oder kann darauf nicht zugegriffen werden, kommt es zu einem Fehler. Fehlernummer und variabler Teil der Fehlermeldung werden gelesen. Mit diesen Informationen wird die komplette Fehlermeldung ermittelt und als Nachricht an einen Benutzer verschickt.

:SET &CHECK#  = GET_FILESYSTEM("WIN21G", "Z:\", FILESYSTEM_SPACE_TOTAL)
:
SET &ERRINS# = SYS_LAST_ERR_INS()
:
IF &ERRINS# NE ""
:   
SET &ERRNR#   = SYS_LAST_ERR_NR()
:   
SET &MESSAGE# = GET_MSG_TXT (&ERRNR#,&ERRINS#)
:   
SEND_MSG BU,BU,&MESSAGE# 
:
ENDIF

 

Siehe auch:

Script-Sprachmittel Beschreibung

GET_MSG_TXT

Ermittelt den Meldungstext des zuletzt aufgetretenen Fehlers.

GET_MSG_TYPE

Ermittelt den Typ einer Meldungsnummer.

SYS_LAST_ERR_NR

Gibt die Fehlernummer des zuletzt aufgetretenen Fehlers zurück.

SYS_LAST_ERR_SYSTXT

Ermittelt den Fehlertext des Betriebssystems eines zuletzt aufgetretenen Fehlers.

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

Copyright © 2016 Automic Software GmbH