GET_MSG_TXT

Die Script-Funktion GET_MSG_TXT ruft den Meldungstext ab, der der Meldungsnummer entspricht, die im Parameter Number angegeben ist. Mit GET_MSG_TXT können Sie eine vollständige AE-Fehlermeldung verfassen, wenn Sie die Funktion mit SYS_LAST_ERR_NR kombinieren, um die Fehlernummer abzurufen, und mit SYS_LAST_ERR_INS, um den variablen Teil der Fehlermeldung abzurufen.

Tipp: Verwenden Sie die Script-Anweisung ON_ERROR:ON_ERROR, um mit der Script-Verarbeitung fortzufahren, selbst wenn ein Fehler auftritt. Verwenden SYS_LAST_ERR_NR, um die Fehlernummer abzurufen, und SYS_LAST_ERR_INS, um den variablen Teil der Fehlermeldung abzurufen. Verwenden Sie dann die Script-Funktion GET_MSG_TEXT, um die vollständige Fehlermeldung abzurufen.

Weitere Informationen finden Sie hier: Fehlerbehandlung in Scripts.

Syntax

GET_MSG_TXT (Zahl[,Einfügen])

Parameter

• GET_MSG_TXT
  Ruft den Meldungstext ab, der der angegebenen Meldungsnummer zugewiesen ist

• Number
  Fehlernummer
  Format: Script-Variable oder Zahl
  Tipp: Verwenden Sie die Script-Funktion SYS_LAST_ERR_NR, um die Nummer des Fehlers abzurufen, der von einer vorhergehenden Anweisung verursacht wurde.

• Insert
  (Optional) Variabler Teil der Fehlermeldung (Text). Dieser Wert ist nicht erforderlich, wenn der Meldungstext keine variablen Teile enthält, wie z. B. in Statustexten, deren Nummern mit GET_STATISTIC_DETAIL gelesen werden können
  Format: Script-Variable oder Zahl
  Tipp: Verwenden Sie die Script-Funktion SYS_LAST_ERR_INS, um den variablen Teil der Fehlernummer abzurufen.

Rückgabewerte

Die Script-Funktion hat die folgenden Rückgabewerte:

• Der Meldungstext, der der angegebenen Meldungsnummer zugewiesen wird, einschließlich des variablen Teils, falls vorhanden
• Leer, wenn kein Text zugewiesen ist
• ??? wenn die bereitgestellte Meldungsnummer ungültig ist

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 - manuell abgebrochen.

Siehe auch: