Equisys technical notes

Technical guidance, explanations and fixes for our products

PRB: Printing to Zetafax Faxmerge printer on NT4 Terminal server fails.



ID: ZTN1343

This Zetafax technical note applies to:

  • Zetafax 9.0 Client installations on NT4 Thin-Client (e.g. Citrix Metaframe) systems


The Zetafax Client does not respond when users print documents with the Zetafax FaxMerge Printer.


The Zetafax Version 9.0 Client install does not fully configure all the settings required for the Zetafax FaxMerge Printer on NT4 Thin-Client systems.


The workaround for this fault is accomplished by editing ini files and the registry on the NT4 Server where the Zetafax Client is installed. Once you have done this on the terminal server

  1. Shut down the Zetafax client.
  2. Run REGEDIT (using Run from the Start menu)
  3. Navigate to HKEY_CLASSES\.
  4. Add a new key called 'Zetafax' using Edit> New> Key (or change the existing value if already present).
  5. In the Key add a new value using Edit> New> String Value. This value should be a letter not yet used for a drive-mapping.
  6. Value name:


    Value data:


  7. Navigate to HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\Ports.
  8. Find the value for the port used by the Zetafax FaxMerge Printer. This will be something like 'C:\Temp\Zetafax_spl' or 'C:\Temp\Zetafax.spl'. Rename this so it is a 'Zetafax.spl' file in the root of the chosen mapped drive, so if the chosen drive letter is 'Z' it would be: -

  9. Close REGEDIT
  10. Find all the ZFClient.ini files on the system. The Default client ini file will be in the Zetafax Client's installation folder, which is typically 'C:\Program Files\Zetafax\'. Any user who has run a Zetafax Client will have their own copy of the file in their Application Data directory.
  11. Open each ZFClient.ini file and modify the 'LogArea:' setting so it matches the SpoolDrive setting in the registry (see step 5 above). The line should now read something like: -

    LogArea: Z:
  12. Add a new line to the ZFClient.ini immediately below this: -

    MapSpoolDrive: YES
  13. Save the modified ZFClient.ini files.
  14. Start the Zetafax Client, this will set up the drive mapping and should after which the Zetafax Client will start picking print jobs spooled by the Zetafax FaxMerge Printer.


This has been identified by Equisys as an issue with only the programs listed in this technical note. It is not present in older or newer versions.

Last updated: 25 March 2004 (GES/SV)

Keywords: Zetafax Client Terminal Server

Equisys Logo, Document Management and Expense Management for Business Central

Replaced by script