Equisys technical notes

Technical guidance, explanations and fixes for our products

PRB: Email gateway troubleshooting for Zetafax



ID: ZTN1294

This Zetafax technical note applies to:

  • Zetafax 7.5 and later


The Zetafax E-mail Gateway acts as a link between an e-mail system and the Zetafax server. It allows faxes to be submitted directly from the e-mail client program, and will deliver received faxes to the e-mail Inbox. This document contains a number of known problems which may occur.

Further information

Problems are noted in bold and followed by the appropriate resolution.

Incoming faxes are being passed to the email gateway but not appearing in my Outlook client.

Is Zetafax running as a service or as an application? If you are unsure check the Zetafax server window. Look at the top left had corner of the window if it states 'Zetafax server' then it will be running as an application. If it is running as a service then it will display 'Zetafax server monitor'.

If Zetafax is running as a service then stop the service and run it as an application. If the messages are now appearing in your inbox then you will need to check the account permissions that Zetafax is running under. The account needs to have specifics rights to write/delete files in the Zetafax connector folder. This is especially important if the Zetafax server is not on the same machine as your exchange server. Normally a domain administrator account should be used.

Faxes are still not coming through even when Zetafax is running as an application and the interactive user account has domain admin rights.

Check directory zfax\server\mailout (where zfax is the location of your Zetafax installation). In this folder check to see if there are any files with a $ extension e.g. ~MAIL080.$. This file type is a corrupt fax.

Delete this file and restart the Zetafax server, faxes should now start going through to the email gateway and appearing in your in box.

There are no files with a $ extension but there are build up of .sin and .ini files in the Zfax\server\mailout folder.

Arrange these files by Date/Modified and move the oldest files out of the zfax\server\mailout directory to another location (e.g. into a temporary folder on the desktop).

If faxes start to go through move the files back again, however if after copying any of these files these files stop new faxes being processed then these files have been corrupted and should be deleted.

When I send a fax it remains in my Outbox in my outlook client.

Check to see if the driver is enabled in Email gateway setting. This can be found in Zetafax configuration, Server setting, Mail Gateway, configure.

Please note if you are on 7.5 there is known issues where Zetafax server intermittently disables the email gateway. For more information please refer to this the following technical note ZTN1189 FIX: Zetafax server intermittently disables the email gateway.


ZTN1189-FIX Zetafax server intermittently disables the email gateway for no apparent reason.

Last updated: 21th July 2003 (IM/GC)

Equisys Logo, Document Management and Expense Management for Business Central

Replaced by script