:ON_ERROR

Die Script-Anweisung :ON_ERROR bestimmt, was mit der Script-Verarbeitung passiert, wenn ein Script-Element einen bestimmten Fehler oder eine bestimmte Meldung zurückgibt. Verwenden Sie Schlüsselwörter mit der :ON_ERROR-Anweisung , um die Script-Verarbeitung fortzusetzen, wenn ein Fehler auftritt, sodass Sie Rückgabewerte lesen oder das Script abbrechen können. Weitere Informationen zu Script-Funktionen, mit denen Sie Fehler analysieren können, finden Sie unter Script-Elemente zur Fehlerbehandlung.

Hinweis: Einige Script-Elemente ermöglichen es Ihnen, das Fehlerverhalten direkt zu definieren, ohne eine :ON_ERROR-Anweisung zu benötigen.

Syntax

:ON_ERRORReaktion

Parameter

• :ON_ERROR
  Bestimmt die Reaktion auf bestimmte Fehler oder Meldungen von Script-Elementen

• Reaktion
  Schlüsselwort für die Reaktion auf einen Fehler oder eine Meldung
  Format:AE-Name, Script-Literal oder Script-Variable
  Zulässige Werte:

  • RESUME (Standard)
    Die Script-Verarbeitung wird fortgesetzt, sodass Rückgabewerte gelesen werden können
  • ABEND
    Die Script-Verarbeitung wird abgebrochen, wenn ein Fehler auftritt

Hinweis: Mit :ON_ERROR können Sie die Fehlerbehandlung bei Verwendung der folgenden

• Script-Funktionen definieren

  • ACTIVATE_UC_OBJECT
  • AUTOFORECAST
  • CANCEL_UC_OBJECT
  • CHANGE_LOGGING
  • CREATE_OBJECT
  • EXPORT
  • FIRST_OF_PERIOD
  • GET_FILESYSTEM
  • GET_OBJECT_TYPE
  • GET_STATISTIC_DETAIL
  • IMPORT
  • LAST_OF_PERIOD
  • MODIFY_OBJECT
  • MOVE_OBJECT
  • PREP_PROCESS_FILENAME
  • REMOVE_OBJECT
  • RESTART_UC_OBJECT
  • SEND_MAIL
  • SYS_SERVER_ALIVE
  • SYS_USER_ALIVE
• Script-Anweisungen
  • :SEND_MSG

Sie können :ON_ERROR auch verwenden, um die Fehlerbehandlung in Scripts mit Arrays aufzunehmen, die einen ungültigen Index verwenden. Weitere Informationen finden Sie unter Arrays.

Standardmäßig fährt das Automation Engine mit der Verarbeitung von Scripts fort, die diese Script-Funktionen enthalten, wenn ein Fehler auftritt.

Beispiel

Das folgende Beispiel gibt an, dass die Script-Verarbeitung im Fehlerfall fortgesetzt wird. Das System überprüft die Laufwerk-Kapazität und ruft die Fehlernummer und die Fehlermeldung ab.

:ON_ERROR RESUME
: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#)

Siehe auch: