:STOP

Fehlerbehandlung und Meldungen

GET_MSG_TYPE

---

GET_MSG_TXT

Script-Funktion: Ermittelt den Meldungstext des zuletzt aufgetretenen Fehlers.

Syntax

GET_MSG_TXT (Number, [Insert])

Beschreibung

Bei einigen ausgewählten Script-Sprachmitteln kann durch die Verwendung von :ON_ERROR das Script bei Fehlern trotzdem fortgesetzt werden. In diesen Fällen ist die Meldung des Fehlers mit der Script-Funktion GET_MSG_TXT ermittelbar.

Grundlage für die Ermittlung des Meldungstexts ist die Fehlernummer Nummer und der variable Teil der Fehlermeldung Insert. Die Fehlernummer kann zuvor mit SYS_LAST_ERR_NR, der variable Teil der Fehlermeldung mit SYS_LAST_ERR_INS ermittelt werden. Die Script-Funktion GET_MSG_TXT setzt mit diesen Angaben und den konstanten Fehlertexten die komplette Fehlermeldung zusammen.

Der Parameter Insert ist dann nicht anzugeben, wenn der Meldungstext keine variablen Teile enthält. Dies trifft beispielsweise auf Statustexte zu, deren Nummer Sie mit GET_STATISTIC_DETAIL auslesen können.

Beispiel

Das Beispiel versucht die Speicherkapazität eines nicht vorhandenen Laufwerks zu prüfen. Dabei 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("WIN21", "Z:\", FILESYSTEM_SPACE_TOTAL)
:SET &ERRNR# = SYS_LAST_ERR_NR()
:SET &ERRINS# = SYS_LAST_ERR_INS()
:SET &MESSAGE# = GET_MSG_TXT(&ERRNR#,&ERRINS#)
:SEND_MSG BU,BU,&MESSAGE#

Im zweiten Beispiel wird der Text zum Status einer Aufgabe ermittelt.

:SET &STATUS# = GET_STATISTIC_DETAIL(&RUNNR#, STATUS)
:SET &TEXT# = GET_MSG_TXT(&STATUS#)
:PRINT &TEXT#

Die Ausgabe könnte wie folgt aussehen:

ENDED_CANCEL - manually canceled.

Siehe auch:

Script-Sprachmittel - Fehlerbehandlung und Meldungen

Beispielsammlung:
Ermittlung der Fehlermeldung und -nummer

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