17. Forms Statements : set_frs Statement--Set FRS Features : Setting the Timeout Period
 
Share this page                  
Setting the Timeout Period
The timeout period is the length of time that the forms system waits for a user to take an action. If the user does not make a requested response or move the cursor within the specified time, the forms system returns control to the application. The timeout constant establishes the timeout period. The syntax for this is:
set_frs frs (timeout = value)
A timeout period can only be specified for user-written, forms-based applications.
Value specifies the length of the timeout period and can be an integer constant or integer variable. The timeout's length cannot be greater than 32767 seconds. A timeout value of 0 means that no timeout occurs. If the timeout value is less than 0, the value is forced to 0 and a runtime error is issued.
Note:  For timeout periods less than 10 seconds, results are very system dependent. Some environments have problems working with small values for timers. Others experience problems with small values only when heavily loaded. For these reasons, setting your timeout period to less than 10 seconds can affect the portability of your application.
For a full discussion of the timeout feature, see Table Fields. The activate command description provides a discussion of activate timeout blocks, which can be used in applications to handle a display loop that times out.