Technical information
FAX ON DEMAND CONNECTOR
55
can also cancel outgoing faxes from VSI-FAX LanFax Windows Client provided client-side archiving is enabled and
you see outgoing faxes in the Outbox. Keep the following in mind when canceling jobs sent using the Fax on Demand
Connector:
You can cancel a fax job that has not been transferred to Esker on Demand yet, which means that it is still in
the FoDC device's queue. However, performing a cancel action on a fax that has already been submitted to
Esker on Demand (i.e. the fax is in the FoDC hold queue) may be too late depending on which step(s) the
document has already been through on Esker's side. You are not guaranteed that your cancel action will be
effectively taken into account.
VSI-FAX receives updates on the status of faxes from the Esker on Demand server once every minute.
Because of this, you may see a fax with the status of "queued" that has, in reality, already been sent. If you try
to cancel a fax in this case, you will receive an error.
Receiving notifications about Fax on Demand fax jobs
Jobs sent from VSI-FAX to the Esker on Demand server are logged in the outbound fax log just as other VSI-FAX
jobs are. To view the outbound fax log, type vfxolog. For more information on the vfxolog command options, see
Command Reference in the Reference Addendum
documentation.
Customizing the header in outgoing faxes
By default, the following type of header is added to any fax sent using Fax on Demand:
Date: <Date> | From: <CompanyName> | Page <CurPage> of <Pages>
<Date> is filled with the date when the fax was composed.
<CompanyName> is the company name you enter during server setup.
<CurPage> is filled with the current page number in the fax transmission.
<Pages> is filled with the total number of pages in the fax transmission.
The pipe character ( | ) is used to divide the header string into three parts on the fax page:
The first part is left-justified on the fax page
The middle-part is centered on the fax page
The right part is right-justified on the fax page
You can customize this header by editing the header parameter's value in the [DEVICE:FoDC] section of the
vsisrv.ini server configuration file:
[DEVICE:FoDC]
header=Date: <Date> | From: Esker | Page <CurPage> of <Pages>
In the header parameter's value, you can enter the syntax that suits your needs. For example, you can:
Add constant text (e.g. change labels).
Add variables among the List of supported variables for Fax on Demand faxes' headers below.
For example:
[DEVICE:FoDC]
header=Today's Date: <Date> | From <FromName> to <ToName> | <Pages>
For a completely blank page header, use a single space.
Limitation
If you use <CurPage> in your custom syntax, the resulting header will be the standard page header
notwithstanding your custom syntax.