Name
Availability
FMG, FMG
swiiftfeg -a email-address [-c] [-d] [-l locale] [-m message-file] [-s subject] [-v] tiff-file
The swiiftfeg tool implements the Fax/Email Gateway (FEG) which takes a received fax, converts it into a MIME email message with the fax as an image/tiff type attachment, and calls sendmail to send the message.
Obviously the recipient of the messages needs to both (a) be running an email user agent that can handle MIME attachments and (b) have a viewer program that can handle TIFF-F attachments. Faximum provides such viewers for common operating systems as part of its SWIIFT package.
-a email-address
This argument contains the email address or addresses that are passed unchanged to sendmail. Multiple recipients may be specified as long as the list contains no embedded spaces or is enclosed in quotation marks.
-c This will cause the copyright information for the program to be displayed. No other parameters will be processed.
-d This will cause detailed debugging information to be written to a file in the /tmp directory with a name starting with feg.dbg.
-l locale-name
This argument specifies the name of the locale to be used when processing messages. This will be used as the second argument to a setlocale(LC_ALL, locale) call (see setlocale(3) in your system documentation) and will also affect the message catalogue used for messages issued by the FEG. Finally, the locale name will be used as the value of the LANG environment variable when conversion program from the mime.types file are run.
-m message-file
This optional argument specifies the path name of the file that is to be sent in the email message indentifying the received fax. If this argument is not present, the FEG will generate an email message similar to the following example:
Please find attached the following fax:
From: 1 604 926 8182
Pages: 2
Received at: 23 Dec 1997
Duration: 120 (seconds)
Fax Line: fax-line-1
Obviously the ability of the FEG to generate such a message depends upon the calling fax server having written the appropriate information in the TIFF file headers. The Faximum products do this but if the FEG is integrated with other fax servers this information may be absent (and the resulting email message description less informative).
-s subject-line
This optional argument specifies the path subject line to be sent in the email message indentifying the received fax. If this argument is not present, the FEG will generate a subject line similar to the following example:
Fax from 1 604 926 8182 (2 pages)
-v This will cause the version information for the program to be displayed. No further parameters or input will be processed.
/etc/faximum.conf Parameters
The parameters in the /etc/faximum.conf file (or /etc/opt/faximum.config on HP-UX 10.x systems) that affect the operation of the FEG are described below.
swiift-feg-sendmail
This optional parameter indicates which program is to be run to deliver the email message. The program will be passed the email addresses on the command line and the file containing the MIME message including the fax and all appropriate headers will be set up as the standard input to this program. If this parameter is not specified then /usr/lib/sendmail will be used by default. Example:
swiift-feg-sendmail = /opt/BETTERMAIL/mailagent
swiift-feg-debug
This optional parameter has the same effect as setting the "-d" argument on the command. Example:
swiift-feg-debug = yes
Fax Server Configuration
The FEG only handles the delivery of the fax to the user by MIME-email. It is the responsibility of the fax server to receive the fax and to pass it to the FEG for ultimate delivery.
The method of configuring the fax server will depend on the fax server being used. With Faximum Software's Fax Server it is necessary to configure the Action and Dispatch databases of the fax server.
For example, with the Faximum Client/Server product you would bring up the Fax Routing window (accessed through the Administration pull-down menu), select the criteria by which the fax server is to determine which faxes are to be routed to whom (i.e. by sending machine TSI, by receiving fax phone line, or by Direct Inward Dialling extension number), and specify that swiiftefg is to be called (with the appropriate email address) to deliver the fax.
Please see your Faximum manuals or on-line help for further information. Note that routing by DID (or the ISDN equivalent, DNIS) is a feature recently added to Faximum's products. If your server does not support DID/DNIS you may wish to contact Faximum Technical Support (support@faximum.com) for an upgrade.
See the documentation for the sendmail utility on your system.