Technical information

INSTALLATION AND ADMINISTRATION GUIDE
216
lp merge faxing
The second method is the lp merge faxing method, which allows you to create a mail merge text stream to
personalize information to send to multiple destinations.
You can use this script to overlay forms onto selected pages of documents, such as purchase orders or quotes.
lp faxing sample interface script
This sample interface script replaces the default script used by the fax printer destination. It allows users to specify
the fax number on the lp command line. This allows the specified document to be faxed.
Important
The sample script that is shown here is a sample. It will not work in every possible instance. It does demonstrate
how and what an interface script should do.
When using the Unix lp command for faxing, a command line would typically be something like:
lp -d fax -o <fax_number> <file_name>
For example, to fax the /etc/motd file to fax number 111-222-3333, enter:
lp -d fax -o 111-222-3333 /etc/motd
Sample script:
# Set the VSI-FAX environment
. /etc/vsifax.sh
# Store the login name of the submitter
LOGIN=$2
# Extract the fax number
FAXNUM="$5"
# Extract the files to be faxed
shift 5
FILES="$*"
# Submit the fax request
vfx -U $LOGIN -n "$FAXNUM" $FILES 2>&1 | mailx -s <subject> $LOGIN
# Exit script
exit 0
Note
In the previous example script, <subject> is any user-defined character string you want for your email subject
line.
lp merge faxing sample interface script
This script allows you to send different sections of the file to different recipients by creating a text stream. VSI-FAX
provides an embedded fax command that allows you to specify the fax dialstring, the coversheet information, and the
coversheet to use for each recipient. The order in which fax commands appear is critical to its successful
implementation. Below is a list of available tag values that can be specified using the @+VFX embedded command:
Tag Description
cvr
Coversheet to use
tfn
Recipient's fax number
tnm
Recipient's name
tco
Recipient's company
ffn
Sender's return fax number
fnm
Sender's name