ON FINISH

Purpose

Execute a command when the Recital process ends

Syntax

ON FINISH <command>

See Also

ERROR(), GETSIG(), ON TERMINATION

Description

The ON FINISH command causes the specified <command> to be executed when the Recital process has finished executing. This can be used in conjunction with the GETSIG() and ERROR() functions to determine if the user exited by themselves or if they received a signal to terminate.

Example

procedure on_finish
  if getsig() != 0
      dialog box "Signal received. signo = "+alltrim(str(getsig())) label "ON FINISH"
  elseif error() > 0
      dialog box "Error received, error = "+alltrim(str(error())) label "ON FINISH"
  else
      dialog box "Successful exit" label "ON FINISH"
  endif
return
 
on finish do on_finish

Products

Recital