Fax Merge - How to create your own Fax Merge application

This document will show you how to use FaxMerge from another applications than Microsoft Word.

What software is necessary for FaxMerge

FaxMerge needs a support from Faxchange client printer. How to ensure that printer is ready for FaxMerge? Check registry value HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\FaxChange\Client\FaxMerge. If this value is set to "4.1", all is OK. If this value doesn’t exist or is not set to "4.1", you must upgrade to higher version of the client printer.

How to create your own FaxMerge in other application

An application must fit the only condition for cooperation with the client faxprinter – it must have access to the registry.

Your application should set necessary registry items, print document, and then wait until document is processed by FaxChange Client Printer. When the printer goes ready again, it set registry item so your application can set registry and print the next document... and so on.

Necessary registry keys for FaxMerge are stored in two places:

HKEY_LOCAL_MACHINE\software\datasys\faxchange\client - here are located information necessary for all users

HKEY_CURRENT_USER\software\datasys\faxchange\client - here are located information necessary only for specific user

Description of registry settings used by FaxMerge

Items in HKEY_LOCAL_MACHINE\software\datasys\faxchange\client:

Value	Description	Comment
FaxMerge	Informs about printer’s ability to support FaxMerge	If value does not exist or is not set to 1, a printer does not support FaxMerge
FaxPr Version	Client Printer version number
Printer	Which printer are sent documents from FaxMerge to	For future use; at this time the value must be set to "FaxChange Client Printer"

Items in HKEY_CURRENT_USER\software\datasys\faxchange\client:

Value Description Comment

Busy For synchronization between an application and a client printer. The application sets this value to "1", sends a document to printer and waits until value changes to "0" Set by application, changed by printer

FaxMerge Application switches client printer to FaxMerge mode by setting this value to „1“ After finishing application must set this value back to "0". Set by application

File Sequence number of the file being printed. If application sends also a title page, application must ensure that title page is in the file number 1. Set by application

MergeFile%n% A FaxMerge stored filename %n% marks sequence of the file in the fax. Set by application

MergeFiles A numeric value determining file count for one fax Set by application

MergeStamp Shows last access of the application to the registry. Must be set by application Will be used in the future for invalid setting detection. Set by application

Nocover If set to "1", Faxchange will not use preselected coverpage Set by application

Note This value will be embeded to the fax message body Set by application

Recipient Sequence number of the currently processed fax Set by application

Recipients Total number of faxes being sent from FaxMerge Set by application

Subject Will be inserted to the fax message subject Set by application

To Fax number Set by application