How to enable logging with a CAPI 2.0 driver

25 January 2008

The CAPI 2.0 driver provided with Unimessage Pro is capable or producing disk .LOG files showing all of the communication between the PC and the card and also summarises of the messages exchanged with the scheduler. Normally these logging functions are not enabled as they can slow the operation of the driver very slightly.

Should problems occur during the communication between a CAPI 2.0 compatible fax card and the PC, perhaps transmissions are frequently failing with an unlikely error, then such details can be useful when investigating the cause of the problem. Typically your supplier, or Wordcraft International, will ask you produce these disk .LOG files should you experience a problem where they might provide useful information.

To enable logging of the communications between the PC and card performed by the CAPI 2.0 driver follow the instructions below.

During installation of Unimessage Pro each device is assigned a name, 'devicename' hereafter. A device configuration file is created for the device in the main Unimessage Pro directory, this file is named devicename.DEV. The devicename.DEV file is a text file and can be edited using NotePad or any other Text Editor.

1. Open the appropriate devicename.DEV file.
2. Under the [FAX] section add the following line beneath it:

LOG=C:\CAPI-###.LOG

Presuming that you want to create .LOG files in C:\, change the drive and path if appropriate.

3. Save the file back to disk and restart the Unimessage Pro device.

After doing the above files for the device name will be created in the C:\ folder. The files will be named:

CAPI-000.LOG
CAPI-001.LOG
CAPI-002.LOG
CAPI-003.LOG
etc

On reaching CAPI-999.LOG the Class 2/2.0 driver will loop back to produce CAPI-000.LOG, so at any one time details of the last 1000 jobs performed will be recorded (reduce the number of "#" characters to reduce the number of log files produced.

Copies of the .LOG files should be kept, together with a description of the events they relate to.