SELECT LOG FILE

version 3

SELECT LOG FILE (logFile | *)

Parameter	Type		Description
logFile | *	String | *		Name of the Log file or
			"*" for closing the current Log file

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

IMPORTANT: Calling SELECT LOG FILE is the same as choosing Log File from the File menu in the User environment. This should only be used when 4D Backup is installed in the database.

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, 4th Dimension displays the following alert:

4D then generates an error -4447, which you can intercept with an ON ERR CALL method.

Note: The SELECT LOG FILE command does not do anything when used with 4D Server. For more information about this command, see the documentation for the 4D Backup plug-in.

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.