Log monitor

This utility program monitors and displays the contents of a Cardbox log file while Cardbox is running.

The Cardbox log file contains technical information about what Cardbox is doing, and normally it is only used when we are investigating a problem or bug. However, the Cardbox macro language also contains a command (WriteLog) for writing to the log, and you may find this a useful tool when developing and testing your own macros.

You can always view the log file by double-clicking it in Windows (it will open in Notepad) but the log monitor utility can display the log continuously and show each addition to the log as soon as it happens.

Log monitor	Executable program , 19KB.
	If for any reason you want to download using the FTP protocol instead of the usual HTTP, press the symbol next to the description of the file you want. Some firewall configurations may need adjusting before you can use FTP.

Click on the link above to download and save the file logwatch.exe. Your web browser may display security warnings as you do this because logwatch.exe is an application program: you will have to accept these warnings in order to download the file.

Locating the log file

Cardbox 3.0

The name and location of the log file will depend on which workspace you're using. The simplest way to locate the log file is to open Cardbox and use the command Help > About Cardbox. Look for the "Files" section of the report (on the second page of the on-screen report"), and the entry "Debug log file" will tell you where the log file is.

A second log file is created by the "Cardbox Engine", the hidden program that actually performs the database access for Cardbox 3.0. If you ever need to view this log file, you will find it as Cardbox\Logs\Engine\Engine.log in your My Documents folder.

Cardbox Server

The name and location of the log file can be configured: the default is Server.log in the same folder as your cbox3svr.exe program file. To locate the log file, open the Cardbox Server control in the Windows control panel (or double-click on cbox3cpl.cpl) and go to the tab marked "Log".

Controlling what goes in the log file

Cardbox 3.0

Use the command Tools > Options > Log.

Cardbox Server

Open the Cardbox Server control in the Windows control panel (or double-click on cbox3cpl.cpl) and go to the tab marked "Log".

Monitoring the log file

Open the Start menu in Windows and select Run, then type a command that looks like the following:

"C:\Client-Server\Server\logwatch.exe" C:\Documents and Settings\Owner\My Documents\Cardbox\Logs\Cardbox.log

Your browser will probably have split this command into two or more parts; but when you type it, you should type it as one continuous line.

Replace the first part of the command with the full drive, directory and filename of the logwatch.exe file that you have downloaded.
Replace the second part of the command with the full drive, directory and filename of the log file you want to watch.

We recommend that you create a Windows shortcut for these log monitor commands, since they are very tedious to type.