Technical Notes, Zetafax

INFO: Enabling trace logging for the Zetafax Mail Gateway.

ZTN1016

ID: ZTN1016

This Zetafax technical note applies to:

  • Zetafax 5.5 and later.

Summary

The Zetafax e-mail gateway programs include a trace logging facility to log detailed information about their operation to a series of files.  This is designed to assist technical support staff in identifying and resolving problems which are reported from customer sites.

More information

To create a trace log for the gateway edit file zfax\MAIL\DATA\DRIVER.INI (where 'zfax' is the name of the directory where the Zetafax server files are installed).

Add the following lines to the [GENERAL] section (modifying the line if present, or adding it if not)

[GENERAL]

debugdll = 1

debug = 1

Save the file, then restart the Zetafax server.  When faxes are sent through the gateway the following three text files which will be written to the zfax\MAIL\DATA directory

debugdll.txt

debugstf.txt

debugsm.txt

Some information may also be written to the WIN.INI file under the following section

[GWSTF]

On Microsoft Exchange systems, some information may also be written to the WIN.INI file on the Exchange server which has the Zetafax Connector installed, under the following sections

[IPM_IN]

[IPM_OUT]

Unless asked otherwise by technical support staff, after enabling the trace logging you should reproduce the problem which is occurring then send the 3 trace log files (*.TXT) together with WIN.INI from the Zetafax server and Zetafax Exchange Connector computers to the support engineer who has requested it.

NOTE: If the debug settings are left on then the text files produced will grow in size. It is recommended that the debug settings are removed when suitable log files have been produced.

Last updated 10 January 2000 (GC/GW)