Equisys Technical Notes

Technical guidance, explanations and fixes for our products

PRB: Zetafax service unable to log onto Lotus Notes when user logs off the NT desktop



ID: ZTN1063

This Zetafax technical note applies to:

  • Zetafax 5.5 and later
  • Lotus Notes 4.x and later


This affects the Zetafax e-mail gateway module STM32.EXE and the least cost routing module ROUTER.EXE if configured with Lotus Notes/Domino server. If installed on NT, Zetafax may be run in the background as an 'NT' service. Once running as a service, if you log off the current user session the Zetafax service will continue to run however STMAIL will report 'Unable to link with the device', and ROUTER says 'Lotus Notes reports 'Operation stopped at your request''.


Zetafax uses the NSFDbOpen function that is supplied in the Notes API. The service starts correctly and can open databases remotely until the current user logs off the NT desktop.  At this point, the following error message is returned by the program, specifically the NSFDbOpen() call: " Operation stopped at your request." This is interpreted by STMAIL as 'Unable to link with the device' and logs this in the zfax\SERVER\Z-DB\SERVER.LOG, where 'zfax' is the name of the directory where the Zetafax server files are installed.


Zetafax server service needs to set an NT environment variable when it starts up.

To achieve this, point to Start> Settings> Control Panel and launch the 'System' applet.

  1. Click on the Environment tab and highlight the 'System variables' and enter a new variable as follows:





and click 'Set'.

  1. Confirm the new variable has been entered under 'System variables' and restart the Zetafax service.


This has been identified by Equisys as a fault with the modules STM32.EXE and ROUTER.EXE.

Last updated: 21 March 2000 (GC/DH)


Recent news

As part of our drive towards making the software simpler to use, Zetadocs Expenses now supports single sign-on using Microsoft work or school accounts. This makes it easier for Office 365 ...

This article describes the new features and other improvements in the August 2019 release of the Zetadocs Expenses service. Zetadocs Expenses ...