ON ERROR action

Function The action allows handling of the processing of error states.

Declaration

 ON ERROR label/NONE/ON/OFF

Parameters

label

in

Label (a sequence of characters that meets the conditions for the given object name).

Description

If an error occurs during the execution of a sequence of defined actions, the script interpreter is controlled according to the setting to process the error. The local variables

_ERR_LINE,
		_ERR_NR and _ERR_MSG

are always adjusted and explain in more detail the error.

The possible current setting of the processing and the operation at an error occurrence:

ON ERROR label
At an error occurrence, the script continues the execution of the action, which follows the given label.
ON ERROR NONE
The label to handle an error is not defined after the action execution. The script occurs in this state after its start. An error occurrence causes logging into the log database and the script termination.
ON ERROR OFF
An error occurrence does not interrupt the sequence of the actions' execution, the execution continues directly by the following action (for the action IF THEN, too). Detection of an error occurrence is enabled by using the test of a value of the predefined local variable _ERR_NR. Accessing the local variable _ERR_NR in this mode causes that it is set to the value _ERR_NO_ERROR!!!.
ON ERROR ON
To avoid the effect of the action ON ERROR OFF. If a label to handle an error is defined before the action, the label becomes the active one.

Strom stránky

ON ERROR

ON ERROR action