:SET_LAST_ERR

Verwenden Sie die Script-Anweisung :SET_LAST_ERR, um eine Fehlernummer und einen Text festzulegen. Die Anweisung überschreibt dabei die Fehlernummer und/oder den variablen Teil der letzten Fehlermeldung. Stellen Sie sicher, dass Sie eine gültige Fehlernummer angeben. Die vollständige Liste der verfügbaren Meldungen einschließlich ihrer Texte im Meldungshandbuch als Teil der Automation Engine-Plattform auf docs.automic.com oder als Teil des vollständigen Download-Pakets von Automic Automation, das in unserem Download-Center verfügbar ist.

Tipps:

• Verwenden Sie :SET_LAST_ERR 0, um eine Fehlernummer und ihren Text zu löschen.
• Sie können die vollständige geänderte Fehlermeldung abrufen. Weitere Informationen finden Sie unter GET_MSG_TXT.

Syntax

: SET_LAST_ERR Zahl[, Insert]

Parameter

• :SET_LAST_ERR
  Legt Fehlernummer und -text fest

• Zahl
  Fehlernummer
  Format: Zahl, Script-Variable oder Script-Funktion

• Insert
  (Optional) Fehlertext, variabler Teil der Fehlermeldung. Wenn die Meldung aus mehreren variablen Teilen besteht, müssen Sie diese mit einem Pipe-Zeichen (|) voneinander trennen. Die Reihenfolge der variablen Teile finden Sie im Meldungshandbuch. Wenn dieser Parameter nicht definiert ist, ist der variable Teil der Fehlermeldung einen leeren String.
  Format: Script-Literal, Script-Variable oder Script-Funktion
  

Beispiel

Das folgende Beispiel legt die Fehlernummer 20657 mit zwei variablen Meldungsteilen fest:

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

Ergebnis der Skript-Anweisung:

U0020657 Laufzeitfehler in Objekt 'MM.DAY', Zeile '20'. Zielordner 'OBJECTS' nicht gefunden.

Siehe auch: