ON TIMEOUT

Purpose

Execute a command when the timeout event flag is triggered

Syntax

ON TIMEOUT [<command>]

See Also

SET CLOCK, SET CLOCKDISPLAY, SET TIMEOUT

Description

The ON TIMEOUT command is used to specify a single command that will execute when the timeout event flag has been triggered. The timeout period is defined by the SET TIMEOUT command. Issuing an ON TIMEOUT statement without a <command> clears the previous ON TIMEOUT. SET CLOCK ON must be active for the timeout command to function, but the SET CLOCKDISPLAY command can be set to OFF if no visible clock is required.

<command>

The specified command may be any the Recital/4GL command.

Example

procedure p_timeout
  dialog box "Timeout Occurred"
  set timeout off
  quit
return
 
set clock on
on timeout do p_timeout
set timeout to 20
set timeout on
m_var = space(10)
@ 00,00 say "Enter Value:" get m_var
read
return

Products

Recital Mirage Server, Recital Terminal Developer