SELECT LOG FILE

version 2004.3 (Modified)

SELECT LOG FILE (logFile | *)

The SELECT LOG FILE command opens, creates, or closes the Log File according to the value you pass in logFile.

Note: Calling SELECT LOG FILE is the same as selecting/deselecting the Use Log File option on the Backup/Configuration page of the application Preferences.

In logFile, pass the name or the full pathname of the log file to be opened or created. If you only pass a name, the file will be searched for or created next to the database structure file.

If you pass an empty string in logFile, SELECT LOG FILE presents an Open File dialog box, allowing the user to open a log file or to create a new one. If the user clicks the Open button and the file is opened correctly, the OK variable is set to 1. Otherwise, if the user clicks Cancel or if the Log File could not be opened or created, OK is set to 0.

If you pass "*" in logFile, SELECT LOG FILE closes the current Log File for the database. The OK variable is set to 1 when the log file is closed.

If you use SELECT LOG FILE to create or open a Log File when a full backup has not yet been performed and the data file already contains records, 4D then generates an error -4447, which you can intercept with an ON ERR CALL method.

ON ERR CALL.

OK is set to 1 if the Log File is correctly opened, created, or closed.

An error -4447 is generated if the operation cannot be performed because the database needs to be backed up. You can intercept the error with an ON ERR CALL method.