TIMEOUT
Top  Previous  Next

Operating Condition

Syntax: SET TIMEOUT value

Range: 0 to 1440

Default: 0

Use TIMEOUT to shut down an inactive R:BASE workstation and exit to Windows after a set amount of time passes. A countdown only begins when R:BASE is waiting for a keystroke--not while R:BASE is processing commands or while you are entering data. This is a useful feature for automatically disconnecting idle R:BASE sessions for scheduled database maintenance.

The default for TIMEOUT is 0 (zero), which does not activate a countdown. TIMEOUT is set in minutes (not seconds), and all workstations must set TIMEOUT separately.

When a TIMEOUT occurs, a command file can be run; however, the command file cannot include a FILLIN, DIALOG, or PAUSE command, or expect a keystroke. If you want to run a command file when a TIMEOUT occurs, you need to store the name of the file in a variable called RBTI_TIMEOUT.

For example:
 
SET VARIABLE RBTI_TIMEOUT TEXT = 'c:\word\cleanup.rmd'   

Note: The command file must end with a RETURN command.

The following command line will exit a user to Windows after the user's workstation is inactive for one hour:
 
SET TIMEOUT 60  

NOTE: The TIMEOUT command will close ANY and ALL open forms, designers, and editors WITHOUT saving the changes which have been made since the last save. It is the responsibility of the developer and end-user to implement proper coding and/or behavior to eliminate unexpected shutdowns without saving the changes. The TIMEOUT command will disconnect from the currently opened database (if applicable) before terminating the R:BASE session.