CUE Design Director Script Language - Manual (Page 18)

Reference Manual Design Director Script Language
www.cuesystem.com
Page 18 of 94
Declaration of error handling command – on error call macro –
OnErrorCallException
Designed syntax:
OnErrorCallException <macro/event name> <parameter list>
; where
• <macro/event name> - global macro name or event name – in case of an event it can be a full
event dereference (i.e. object name, ..variable name,..) – to be more precise it is an expression
type callable.
• <parameter list> - comma separated expressions that are paired with the macro /event
parameters. The number of expressions and parameters as well the types has to correspond, if
it is not this way, an error will be generated.
At the moment when an error occurs this command is called, Err object is set into error code and the
macro that handles this error is called.
If during the process of the name deference of error handling macro or during the parameters evaluation
that handles the macro an error occurs, then the macro code, where the error has originally occurred,
will be also interrupted, and the error is arisen at the position where the calling macro called the macro,
where the error has originally occurred.
The parameter evaluation called by a macro takes place within the macro context where the calling has
been declared. Therefore it is possible for the macro parameters to use even the local macro variables.
Return from error handling - resume on next command - ResumeNext
Designed syntax:
ResumeNext
The command causes to end the error handling process and then code continues with the next
command after the command where an error during the error handling has occurred.
In case the error has occurred in the condition of the structured command (that is If,Do..LoopI) then it
continues with the next command after the entire structure. See the above comments of Declaration of
error handling – OnErroResumeNext.
Return from error handling - leave error macro – ResumeLeaveMacro
Designed syntax:
ResumeLeaveMacro
This command causes to end the error handling process and then code continues with the next
command that has called the error macro (that is the macro where an error has occurred).
If the error happens directly in the macro that handles the event, then the event handling will be finished
– it is passed on the next event handling, respectively it will wait for the next event if none takes place.