home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
High Voltage Shareware
/
high1.zip
/
high1
/
DIR11
/
MSGFAX12.ZIP
/
MSG2FAX.DOC
< prev
next >
Wrap
Text File
|
1993-05-03
|
7KB
|
170 lines
──────────────────────────────────────────────────────────────────────────────
MSG2FAX V1.10 - Automatic *.MSG message to fax system.
Copyright (c) 1993 Harvey Parisien, FidoNet 1:249/114
For custom applications, please netmail.
──────────────────────────────────────────────────────────────────────────────
██ Purpose:
This utility can be used on any *.MSG type message base. It scans the message
base for messages that have a subject line that contains a keyword, fax
number, and password. Example:
Subj: FAX 1-333-555-1212 password
By default if the number is a local number only 7 digits in length, no
password is necessary. If it is there it is not checked. Either of these
numbers are 7 digits... 5551212 555-1212 555--1212
██ The message base:
SysOps should setup a message area for dealing with faxes. This can be either
an echomail area or netmail area, as long as it is a *.MSG format message
base.
Most users, including Squish users, would find it easier to setup an echomail
type echo called MYFAXES or the like. NETMAIL areas are just fine, but since
there are many other non fax messages, it will just be a bit slower on older
systems with 1000's of messages. Otherwise it really doesn't matter.
Squish users, just add this line to your squish.cfg file...
EchoArea MYFAXES C:\max\msg\FAX
██ Your BBS.BAT (or other controlling batch file)
In your controlling batch file, right after you process incoming mail, run
MSG2FAX. If it finds messages with FAX keywords and correct passwords it will
send them out. If lines are busy, faxes are monitored and sent out next time
MSG2FAX is run, which is the next time you receive email.
Example PARTIAL batch file...
:MAILin
SQUISH IN OUT SQUASH LINK -fECHOTOSS.LOG
MSG2FAX
GOTO BINKLOOP
██ The config files:
1. MSG2FAX.CFG
c:\max\faxtmp
c:\max\msg\myfaxes
c:\fax
c:\max\texts\max.log
NOW
FAXIT.BAT
The first 6 lines contain critical data. All other lines in this
configuration file can be used for comments.
The first line is the path for a dedicated working directory where temporary
fax files will be created and launched. As they are successfully launched,
they will be cleared. If they are not successfully launched, they will remain
until cleared. This should be a sub directory ONLY for this process, since
the system will check if it is empty to determine certain processing logics.
The second line is the path to your *.MSG files. This is the message base
described earlier on in this document.
The third line is the path to your FAX software, and where your batch file
called SENDFAX.BAT is located. The system will goto this directory for
processing and then return to it's original position.
The fourth line is the path and name of your system activity log. I have my
MAXIMUS and BINKLEY logs using the same name, and use this for all my
processors that maintain logs. You might want to do the same, or have a
separate fax.log.
The fifth line is a control command which should be NOW or WAIT. NOW causes
the system to send the fax as it is received. WAIT causes the system to wait
until you choose to run FAXIT.BAT (a batch file created by msg2fax) in a
future event under your own control. See info below re NOW or WAIT.
The sixth line is a user definable batch file which MSG2FAX will spawn. This
batch file is user definable so you can define a DOS FAXIT.BAT or OS/2
FAXIT.CMD file name. If you intend on processing under OS/2 with the .CMD
file, use the WAIT command as described above, and issue the os/2 commands
outside of this process. This batch file will contain the following structure
for each fax in the outbound que:
@call SENDFAX c:\max\faxtmp\26175759.3 555-1212
One line for each fax calls your batch file SENDFAX.bat (or SENDFAX.CMD) with
2 command line parameters of drive:\path\faxname.ext and fax phone number.
Make sure your SENDFAX.BAT file is on your fax directory as described in line
3 above.
Your batch file SENDFAX might look like this. It is important that you check
your fax software for an errorlevel (or use some other means of checking) to
see if the fax was infact sent out. If it was, then delete the fax in the fax
temporary directory. Example SENDFAX.BAT for a ZyXel setup:
@ZFAX 1 %1 %2
@if not errorlevel 1 del %1
See sample sendfax.bat in original archive.
2. MSG2FAX.PWD (not required for local faxes ie 7 digit numbers)
Format is NAME,PASSWORD
Example:
Jim Smith,Apples
Steve Martin,Chair
If Jim Smith enters a message with a subject line of...
FAX 1-416-555-1212 APPLES
... the system will convert the message body to a fax and send it in
this format...
DATE: 23 Aug 92 16:38:49
FROM: Harvey Parisien
TO: Steve Martin
FAX: 555-1212
──────────────────────────────────────────────────────────────────────────────
Thanks for the invite. We should arrive at around 7:pm your time.
Regards...
──────────────────────────────────────────────────────────────────────────────
MSG2FAX v1.10 - Automated EMAIL to FAX, by Overerx Inc @ 1:249/114
Advanced notes...
NOW or WAIT: If you want to control sending faxes in your event processing,
use the WAIT command in your configuration file (see above for detail). In
your batch processing, you should check for the existance of faxit and then
run it. You should also check for files on your dedicated fax directory and
if none exist, delete faxit.bat to avoid continual processing of that batch
file. Basically, every fax that comes along gets appended to faxit.bat (or
your user defined batch file name - see above) for processing. Until the
working fax directory is empty, all faxes in the faxit.bat are processed.
Sendfax.bat checks if it's there and processes it if it is and deletes it when
it's successfully sent. So if your working fax directory is empty, then the
current faxit.bat file can be deleted and save some processing time.
This is all handled internally if you use the NOW command and is something you
should never have to worry about or know. However, if you plan to use the
WAIT command and handle processing yourself, you should understand this
concept.
Here's an example of manual processing for setups using the WAIT command...
IF EXIST FAXIT.BAT FAXIT
IF EXIST FAXIT.BAT IF NOT EXIST C:\TMPFAXES\*.* DEL FAXIT.BAT
──────────────────────────────────────────────────────────────────────────────
Please use the enclosed registration form and register.
Thanks...
──────────────────────────────────────────────────────────────────────────────
MSG2FAX v1.10 - Automated EMAIL to FAX, by Overerx Inc @ 1:249/114