Equisys technical notes

Technical guidance, explanations and fixes for our products

HOWTO: Increasing the refresh rate for the ZfxGetServerStatus API function



ID: ZTN1015

This Zetafax technical note applies to:

  • Zetafax API version 5.5 and later


The ZfxGetServerStatusEx API function returns information about the server status, including the status of devices and the number of entries in the server queue.  It reads this information from a data file, STATUS.LOG, which is updated by the server periodically.  By default this is updated every 10 minutes, and so the values returned by the function will only change every 10 minutes even if you call it more frequently.  This frequency can be changed using an INI file setting.

More information

The ZfxGetServerStatusEx and ZfxGetServerStatus functions are intended for programs which wish to perform background checking of the server status, to alert in case of device failures etc.  The information returned by the functions is stored by the Zetafax server in the file STATUS.LOG, updated by default every 10 minutes.

The update frequency may be changed using the following line in the [QUEUEMAN] line of the settings file zfax\SYSTEM\Z-DB\SETUP.INI

QueueStatsFrequency: < frequency>

where '< frequency> ' is the update frequency in seconds.  A value of '0' will disable updating.

There is an overhead in creating this file, so you should avoid making the update very frequent.  We recommend a minimum of 60 (ie 1 minute).

Please note that this function is not designed for use in tracking individual messages.  This should be done using the per-message functions (eg ZfxGetMsgInfoEx) which give real-time information when called.

Last updated: 11 January 2000 (GC/GW)

Equisys Logo, Document Management and Expense Management for Business Central

Replaced by script
Recent news

The sudden rush towards remote working practices in 2020 led many organizations to implement changes to upgrade their document capture processes on Microsoft Dynamics 365 Business Central or ...

Company credit cards are often seen as the most convenient way to incur travel & entertainment expenses, however it can be a very different story when it comes to the administration of these ...

North America
Equisys Inc
30000 Mill Creek Avenue
Suite 335
Alpharetta, GA 30022
(770) 772 7201
Equisys Ltd
91 Southwark Bridge Road
United Kingdom
+44 (0)20 7203 4000

© Equisys Ltd
All rights reserved

© Equisys Ltd    All rights reserved    Contact    Privacy policy    Cookies