GET_MSG_TXT

Script-Funktion: Ruft den Meldungstext des zuletzt aufgetretenen Fehlers ab.

Syntax

GET_MSG_TXT (Number [,Insert])

Syntax	Beschreibung/Format
Number	Fehlernummer Format: Script-Variable oder Zahl Die Fehlernummer wird auch von der Script-Funktion SYS_LAST_ERR_NR geliefert.
Insert	Variabler Teil der Fehlermeldung (Text) Format: Script-Literal oder Script-Variable Der variable Teil der Fehlermeldung wird auch von der Script-Funktion SYS_LAST_ERR_INS geliefert.

Rückgabewerte
Meldungstext des zuletzt aufgetretenen Fehlers. " " - Es ist kein Fehler aufgetreten.

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 die Fehlermeldung mit der Script-Funktion GET_MSG_TXT ermittelbar.

Die Fehlernummer Zahl und der variable Teil Insert sind die Grundlage für das Abrufen des Nachrichtentextes. 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 verwendet diese Informationen und die Fehlertexte, um die komplette AE Fehlermeldung zusammenzustellen.

Der Parameter Insert ist dann nicht anzugeben, wenn der Meldungstext keine variablen Teile enthält, wie beispielsweise in Statustexten, deren Nummern durch Verwendung von GET_STATISTIC_DETAIL gelesen werden kann.

Beispiel

Das folgende Beispiel überprüft die Speicherkapazität einer nicht vorhandenen Festplatte, was zu einem Fehler führt. Die Fehlernummer und der variable Teil der Fehlermeldung werden gelesen. Diese Informationen werden verwendet, um die komplette AE Fehlermeldung abzurufen, die dann als Meldung an einen Benutzer gesendet wird.

: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: