Technical information

FAX ON DEMAND CONNECTOR
47
Configuring a proxy for the Fax on Demand Connector
If you need to use a proxy to connect to the Fax on Demand service, you need to configure VSI-FAX so that it can
connect properly. To do so, you need to add keys in the vsisrv.ini file and reload VSI-FAX when done. These keys
define the proxy name, its port, the username and the password used to access the proxy.
To add these keys, we advise that you use the vfxadmin command line four times as following:
vfxadmin config -a -i FODC DEVICE proxy-host myproxy.example.com
vfxadmin config -a -i FODC DEVICE proxy-user myproxyuser
vfxadmin config -a -e -i FODC DEVICE proxy-password myproxypassword
vfxadmin config -a -i FODC DEVICE proxy-port 8080
Important note
Notice the -e option used to specify the password. It enables encryption, which is required to store the password
for the proxy.
For more information about the vfxadmin command, refer Command Reference in the Reference Addendum
documentation.
Testing the Fax on Demand Connector
1. Create a simple text document called test.txt and at a command prompt issue the command:
vfx -n +<fax number> -d FoDC test.txt
where <fax number> is a fax number you have access to. The response should be the job number.
Example:
> C:\temp>vfx -n +<fax number> -d FoDC test.txt
> 1005
2. At a command prompt you can now issue the command vfxstat to check the status of the job:
Example (using the job number retrieved in the previous example):
C:\temp>vfxstat 1013
Status for VSI-FAX fax job: 1005
Submitted by: joes E-mail : <none>
Submit time : 10/14 14:17 Queue : FoDC
Result : done Status : Normal
To name : <none> From name : <none>
To company : <none> From company: <none>
To fax # : [phone] From fax # : <none>
To voice # : <none> From voice #: <none>
Subject : <none>
Num dialed : 8280024
File 1 : 1 pg test.txt
Total pgs : 1 pg
Attempt Send-Time Result CSI
------- ----------- ------------------ ---------------
1 10/14 14:18 Normal <none>
Changing your Fax on Demand Connector information
On occasion, you may need to change your Fax on Demand Connector Account ID, password, or hostname. This
information is stored in your vsisrv.ini file. You can change the hostname and the Account ID from this file but
not the password (which is encrypted in this file):
1. Use a text editor to edit the VSIFAX\lib\vsisrv.ini file. Find the [DEVICE:FoDC] section of the file. Edit
the following fields as needed: