4. Received Fax Delivery and Viewing

One of the most common customizations that is performed on HylaFAX installations is that of changing faxrcvd from the default. This is to be considered normal. Each business or fax user seems to have a unique way of getting information to its recipients as well as the manner of presentation. Faxes are no different.

4.1 Default faxrcvd Delivery

A default faxrcvd configuration from the HylaFAX installation will e-mail a notification of the received fax to FaxMaster. The notification will appear similar to this:

Date: Sat, 20 Oct 2005 05:23:30 -0600
To: FaxMaster@faxserver.mydomain.com
From: The HylaFAX Receive Agent 
Subject: facsimile received from  

recvq/fax00008.tif (ftp://faxserver.mydomain.com:4559/recvq/fax00008.tif):
    Sender: Remote Fax ID
     Pages: 1
   Quality: Fine
      Page: ISO A4
  Received: 2005:10:20 05:23:23
TimeToRecv: 0:13
SignalRate: 14400 bit/s
DataFormat: JBIG
ErrCorrect: Yes
   CallID1: 8005551212
   CallID2: Caller ID Name
   CallID3: 4475658
ReceivedOn: ttyS0
    CommID: c00000010 (ftp://faxserver.mydomain.com:4559/log/c00000010)

If etc/hosts.hfaxd and RecvFileMode are configured for your access, then you should be able to view or retrieve the fax image or the CommID file by following the listed ftp link.

4.2 Attached TIFF/PostScript/PDF Mail Delivery

By using this procedure, the default mail will be sent with the fax image attached to that notification mail.

Create the file etc/FaxDispatch (usually /var/spool/hylafax/etc/FaxDispatch) so that it contains the following lines:

	FILETYPE=tif;
	SENDTO=FaxMaster;

Substitute pdf or ps for tif as you desire.

Note that because TIFF and PDF are binary file types, metamail, uuencode, or some other encoding program must be installed - faxsetup must be run following the installation of one of these in order to properly update setup.cache.

4.3 Common Windows Viewers

• For TIFF images, most versions of Windows 95 and Windows 98 come bundled with Wang/Kodak/Eastman/Microsoft Imaging. Usually it is installed under Programs/Accessories in the Start Menu, but if not, it can be (re)installed from the Windows CD under Control Panel/Add-Remove Programs/Windows Setup. If you still have trouble with this, the program is downloadable from Microsoft at:
  http://download.microsoft.com/download/win95upg/tool/1.0/W95/EN-US/imginst.exe
  For Microsoft's installation instructions, click here.
• For PDF images, Adobe Acrobat Reader works well. This can be obtained from Adobe at:
  http://www.adobe.com/products/acrobat/alternate.html
• For PostScript images, GSview is good (and free). Get it at http://www.cs.wisc.edu/~ghost/gsview/index.html.

Note that in order to set a default program to "Open" a file by double-clicking it, appropriate file type configuration must be entered into Explorer/View/Folder Options.../File Types for that file extension.

4.4 Common Mac Viewers

• For TIFF images, there is GraphicConverter found at http://www.lemkesoft.com.
• For PDF images, Adobe Acrobat Reader works well. This can be obtained from Adobe at:
  http://www.adobe.com/products/acrobat/alternate.html
• For PostScript images try MacGhostView found at http://www.kiffe.com/macghostview.html.

4.5 Common *NIX Viewers

• For TIFF images, GNU HaliFAX is available at http://www.gnu.org/software/halifax/.
• Also there is QFaxReader. See: http://qfaxreader.sourceforge.net/.
• Also for TIFF images, Frank D. Cringle's viewfax is a good program. It is available at: ftp://ftp.ping.de/pub/unix/viewfax-2.6.tar.gz.
• For PDF images, Adobe Acrobat Reader works well. This can be obtained from Adobe at:
  http://www.adobe.com/products/acrobat/alternate.html
• For PostScript images, GhostScript works very well. You installed this for HylaFAX server, so you surely already know all about it.

---