Equisys technical notes

Technical guidance, explanations and fixes for our products

HOWTO: Enable the Attachment handling for remote printing add-on with Exchange 5.5



ID: ZTN2024

This Zetalink technical note applies to:

  • Zetalink version 1.0


This document details instructions on enabling and licensing the 'Attachment handling for remote printing' add-on pack when Zetalink is configured with Microsoft Exchange 5.5.

More information

Zetafax is installed as the communications server component of Zetalink, but this version does not support the handling of e-mail attachments, Zetalink shows that an attachment exists when the user is browsing an e-mail in their inbox or using the 'Print-to-Fax' feature provided, but does not print it.

Should the Zetalink user require the attachment to be printed along with the e-mail message, then the Zetalink administrator must install and license additional software.


Before continuing with the instructions below, ensure you have the following:

  • Zetafax CD-ROM
  • Attachment handling for remote printing add-on pack for MSX 5.5

Applying the add-ons licenses

  1. Launch the Zetafax configuration from the Zetafax program group.
  2. Right click on the 'Licensing and Registration' and select 'Modify/upgrade license details'.
  3. Select the 'Install add-on' button, enter the 'Attachment handling for remote printing' add-on license and click OK.
  4. Make a note of the new registration code and click OK on the warning dialog.
  5. Select 'Next' to skip the next dialog.
  6. Populate the contact details on the 'User license details' dialog.  Select 'Next' and 'Next' again until you reach the license registration details box. Click 'Finish'.
  7. An 'automatic registration' box will be displayed advising you that although you have changed the contact details you are not required to reregister. If you wish to reregister the product click 'Yes' and follow the instructions below to register, if not click 'No' to close.

Reregistering the product

This step may be skipped if you chose 'No' to the question above.

  1. To register, open the Zetafax client from the Zetafax program group and login as Zetalink. The client will automatically prompt you to send a new registration fax.  If it does not prompt then go to 'Help' on the toolbar and select 'Register now'. This will send a registration fax to the centre selected during the update.

Installing and configuring the newly licensed software

Now that the Zetalink communications server has been successfully licensed you now need to add the additional software to enable attachment handling. This entails installing a connector on the Exchange 5.5 server and a mail submitter on the communications server.

Installing the Zetafaxconnector for Microsoft Exchange 5.5

Before the Zetafax connector   is installed ensure that you are logged into the Microsoft Exchange 5.5 server using the administrator account or an account with Exchange administrator.

Using the 'Services' applet in control panel, ensure that the following Microsoft Exchange 5.5 services are installed and running:

  • Microsoft Exchange Directory
  • Microsoft Exchange Information Store
  • Microsoft Exchange MTA stacks
  • Microsoft Exchange System Attendant

The Zetafax connector depends on these services and will not run unless they are all running.

The Zetafaxconnector for the Microsoft Exchange 5.5 installation program should be run on the Microsoft Exchange 5.5 server.

  1. Log on to Windows  NT using an account with administrator.
  2. Run the Zetafax connector for Exchange 5.5 setup program from the Zetafax CD-ROM.
  3. Click the 'Next' button to begin installation and follow the instructions on screen to install the Zetafax connector.

  1. Choose the 'Connector, admin extensions and templates' option.
  2. You will be prompted for the service login account information, which will be used by the Zetafax connector service when it is started. 
  3. The Setup program will automatically detect the name of the account used by the other Microsoft Exchange 5.5 services and enter it in the Service Account field:

  1. Enter the password for the listed service account and click the 'Next' button. If the Zetafax connector is unable to log on with the credentials supplied, the setup program will re-prompt during installation.
  2. The Setup program will confirm the installation options you have selected. By default, the Zetafax connector will be installed into the CONNECT subdirectory of the Microsoft Exchange 5.5 server's home installation directory, and in a subdirectory called ZETAFAX. Click the 'Next' button to proceed with the installation.
  3. Once Setup has copied all of the relevant files to your computer, the final screen will ask you whether you wish to install the Zetafax personal folders onto this computer. Uncheck this box and click 'Finish'.
  4. The Zetafax connector should now be visible from within the main Microsoft Exchange 5.5 Administrator program window. It is installed into the 'Connections' container for the site specified at installation.

  1. Once the Setup process is complete, you should check the Zetafax connector   service is started, it is important to check that there are no errors reported. If there are, check the event log for further information.

Installing the mail submitter software

You should now install the Zetafax mail submitter program onto the communications server by following the steps described below:

The mail submitter installation program should be run on the communications server (Zetafax).

  1. Log in at the communications server and check that you have full access rights to the Zetafax base directory; for example, F:\ZFAX. If you are using Windows 2000 or Windows NT 4.0, ensure that you are logged in as a user with administrator privileges.
  2. Insert the Zetafax CD-ROM into your CD-ROM drive and click on the 'Install Zetafax e-mail gateway' link.

  1. Follow the instructions on screen to install the mail submitter programs.
  2. The Setup program will copy the appropriate files to the Zetafax server's home directory.

Configuring the gateway for Microsoft Exchange 5.5

Before you can configure the Zetafax mail submitter for Microsoft Exchange 5.5, the Zetafax connector service must have been successfully installed and running as a service on the Microsoft Exchange 5.5 server.

The e-mail gateway is configured using Zetafax Configuration. This is run automatically when the Zetafax e-mail gateway upgrade is installed, as described earlier.

  1. Choose the 'Server settings' node from the left pane and click the 'Mail Gateway' icon.

  1. The default setting is for the e-mail gateway to be disabled. Select the 'Enabled' radio button to enable the e-mail gateway.

Note: Whenever you switch between 'Enabled' and 'Disabled', all e‑ mail addresses held by Zetafax are removed. These addresses can take some time to set up again, so take care not to disable the e-mail gateway unless you really need to.

  1. Click the 'Add Mail.' button, and select 'Microsoft Exchange 5.5' and click the 'Add' button.

  1. Click the OK button to close.
  2. Click the 'Configure.'button.

  1. Highlight 'Microsoft Exchange' in the -Mail systems' column and click the 'Setup' button to display the Microsoft Exchange 5.5 Setup dialog box.
  2. Verify that the 'Driver enabled' box is checked.
  3. Ensure that 'Exchange Connector Path' points to the installation directory where you installed the Zetafax connector.
  4. Ensure the 'Connector address type name' is set to 'FAX'.

  1. Click the 'Test connection' button to validate the information you have entered for the Zetafax connector.
  2. If there are any problems with the connection, you should check that the path is valid and, if using the UNC notation, that a share has been created with the right permissions. If you are still experiencing problems with the connection, please refer to the support page on the Equisys web site.
  3. If the connection to the Zetafax connector is successful, click the OK button to exit the Microsoft Exchange Setup Service dialog box.
  4. Click the 'Rendering.' button to display a dialog box with two tabs, 'Applications' and 'Rendering'.

  1. The options on the 'Applications' tab allow you to register the applications you have installed on the communications server with the gateway. Typically, these are the most common applications used by your network users as e-mail attachments.

Note: If a Zetalink user attempts to print an e‑ mail message with an attachment created by an application that has not been registered or installed on the communications server, the e-mail gateway will be unable to process the message.

  1. You must install the ASCII driver as an absolute minimum. This is the driver that converts the text of the e‑ mail message itself.
  2. To enable rich text support, click 'Associate' and associate the .RTF file extension with your Word processing package in the Configure Associations dialog box which follows.

  1. Click the 'Rendering' tab. The first time you choose this tab, Zetafax attempts to install the gateway's rendering printer driver. The mail rendering subsystem printer driver will then become visible the next time you start the Print Manager.

Note: The printer driver will not be installed successfully under Windows 2000 or Windows NT 4.0 unless the user account you are currently using has administrator privileges.

Enabling the Zetalink user to use the e-mail gateway

This section details enabling the Zetalink user specified during the Zetalink install to use the e-mail gateway.

  1. Choose the 'Users and user groups' node on the left pane of the Zetafax configuration program.
  2. Select the existing Zetalink user account by highlighting the user's entry and selecting Edit (Action menu).
  3. Check the box marked 'Allow sending from e-mail gateway' and the box marked 'Forward received messages via email'.
  4. It is important that a valid email username appears in the Email username box. If you have already created a list of Microsoft Exchange 5.5 users, as described below, then this box will be completed automatically by the configuration program.
  5. If the Email username box is still blank, click the 'Browse' button to browse the current list of email users maintained by the communications server.

  1. You can manually select a name from this list by highlighting it and clicking the 'Select' button.
  2. If this list of e-mail users is empty, you must populate the list. Click the 'Refresh' button.
  3. If the communication server is installed on the same machine as the Microsoft Exchange 5.5 Server it will start the Microsoft Exchange 5.5 Import Service, which builds a list of the Microsoft Exchange 5.5 users on the site.

  1. Enter the organization name and site name at which the Zetafax connector is installed (These details are visible from the Microsoft Exchange 5.5 Administrator program). Click the OK button to begin the import.
  2. If the communication server is installed on a different machine or on Windows 2000, clicking the Refresh button will start the Zetafax Exchange User Export service, which will export the Microsoft Exchange 5.5 users to a file that the communication server can use.
  3. Check the Exchange 5.5 box and accept the default path. Click the 'Export' button to begin the export.
  4. Highlight the e-mail address of the Zetalink user and click the 'Select' button.
  5. This will associate the e-mail address of the user with their Zetafax address and enable them to use the gateway.
  6. Click OK to close and exit the configuration program.

Configuring the Zetalink server to use the 'Attachment handling for remote printing' package.

  1. Start Registry Editor on the Zetalink server.

WARNING: Using Registry Editor incorrectly can cause serious problems that may require you to reinstall your operating system. Equisys cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk.

For information about how to edit the registry, view the "Changing Keys and Values" Help topic in Registry Editor (REGEDIT.EXE) or the "Add and Delete Information in the Registry" and "Edit Registry Data" Help topics in REGEDT32.EXE. Note that you should back up the registry before you edit it. If you are running Windows NT or Windows 2000, you should also update your Emergency Repair Disk (ERD).

  1. Locate the following key in the registry:

HKEY_LOCAL_MACHINE\SOFTWARE\Equisys\Zetalink\Communications Server

  1. Select the entries below and populate with values described:

Send Fax Via Email

1 - where 1 is enabled (via e-mail gateway)

Mail Server

Mail_server - where 'Mail_server' is the name of the Exchange server hosting the Zetafax connector.


Zetalink_user - where 'Zetalink-user' is the name of the mailbox on the Exchange server you enabled to use the e-mail gateway with the Zetafax configuration program (This user will receive success/failure notifications for all Zetalink users. Regular housekeeping will be required on this mailbox to prevent it from growing in size).

  1. Close REGEDIT.EXE.

Testing your new configuration

  1. Ensure you have an e-mail in your inbox with a valid attachment. Valid attachments are listed in the e-mail gateway configuration and require the application to be installed on the Zetafax server.
  2. Logon to Zetalink with your WAP enabled mobile device and browse to the e-mail in your inbox.
  3. Select 'View' and then 'Print' form the 'Menu' options.
  4. Enter a valid Fax number and ensure you choose 'Yes' to 'Print attachments:' hit 'OK' then 'Print'.
  5. Your selected e-mail and attachment should be faxed to the specified number shortly. The confirmation and copy of fax will be sent to the mailbox above.

Last updated: 5 December 2001 (GC/DH)

Equisys Logo, Document Management and Expense Management for Business Central

Replaced by script