           Ŀ
           Ŀ
           How to use a fax modem with frontdoor 2.20
           ٳ
           

This document was prepared by:

Mark Kerr @ 2:443/59, 2:443/60(fax) fidonet


This is a functional setup for fd 2.20 and a supra v32bis faxmodem with 1.71
roms.


Fossil is BNU 1.70 locked at 57600   copyright David Nugent
BGFAX is 1.06                        copyright B. J. Guillot
XRobot is 3.01 for dos               copyright Joaquim Homrighausen
Zfax is 2.23                         copyright Zyxel Corporation

This setup will receive faxes using bgfax as a rearend, xrobot to create
the netmail's and zfax to view the fax. Recieved faxes can be forwarded
to a specified no(s) and/or forwarded by means of a file attach msg.


Any ideas for improvements, queries, modifications should be forwarded to
the author via netmail for consideration..

   Ŀ
   IMPORTANT
   


This setup works for me, however it is strongly recommended that you read
fully the documentation for all the products involved!!!!!!!!

   Ŀ
   SETTING UP - the interesting bit..
   

I have set the received fax dir as d:\zfax\rcv
bgfax is on the c: drive which is a ramdisk

   Ŀ
   FDSETUP
   

 MAILER/FAX

RcvdFiles D:\ZFAX\RCV\
Recipient Mark Kerr
Print     No   (or Yes :-)
Printer   d:\zfax\zfax.com 2 =F

 MAILER/ERRORLEVELS

Fax             254
Received mail   200
Create BAT.file Yes


 EDITOR/FAX

Viewer     d:\zfax\zfax.com 4 =F
Automatic  Yes
Remove     No

 MODEM/HARDWARE

Serial port                   2
Locked port                   Yes
Maximum baudrate              Fixed
Reset modem to connect speed  Yes
Lower DTR when busy           Yes
Lower DTR to terminate call   Yes
Toggle DTR before dialing     Yes
Carrier detect mask (CDMASK)  128


 MODEM/CONNECT MESSAGES

Fax         FAX


 MODEM/COMMAND STRINGS

Escape code    +++
Return on-line ~ATO|
Onhook         ATH0|
Offhook        ~ATH1|
Dial           ATDT
Prefix
Suffix       |
Delay          5
Init-1         ATZ|
Init-2         AT+FAA=1+FCR=1|
Init-3         AT+FLID="Your Name Here....."+FDCC=1,5|
Down           ATH1|
Reset          ATz|

 MODEM/ANSWER CONTROL

Manual answer Yes
Force answer  AT+FAA=1;A|
Answer delay  5
Enable LDFRS  No

 MODEM/FAX

Internal No

  Ŀ
  RELEVANT PORTIONS OF THE MAIN BATCH FILE
  


if errorlevel 254 goto FAX

:FAX

   c:\bgfax.exe /FAX d:\zfax\rcv 2 z
   if errorlevel 5 d:\fd\xrdos TEXT /d:\faxsent.txt /r2:000/000 /n3 /TFax_sent
   if errorlevel 4 call d:\zfax\rcv\doprint
   if errorlevel 1 d:\fd\xrdos TEXT /d:\faxfail.txt /r2:000/000 /n3 /TFax_failed
   if exist d:\zfax\rcv\doprint.bat del d:\zfax\rcv\doprint.bat
   goto START

The commandline d:\fd\xrdos TEXT /d:\faxfail.txt /r2:000/000 /n3 /TFax_failed
will cause a netmail to be sent 2:000/000 (replace with your address) by
user 3 in frontdoor (Mine is BGFAX) with faxfail.txt as the body of the
msg and "Fax failed" as the subject.

   SAMPLE FAXFAIL.TXT


BGFAX had a problem receiving a fax

For more details please read bgfax.log

rgds bgfax



The commandline d:\fd\xrdos TEXT /d:\faxsent.txt /r2:000/000 /n3 /TFax_sent
will cause a netmail to be sent 2:000/000 (replace with your address) by
user 3 in frontdoor (Mine is BGFAX) with faxsent.txt as the body of the
msg and "Fax sent" as the subject.

   SAMPLE FAXSENT.TXT


BGFax has successfully sent a fax

rgds bgfax



  Ŀ
  SAMPLE DOPRINT.BAT CREATED BY BGFAX
  

D:\ZFAX\RCV\EXEPRINT.BAT D:\ZFAX\RCV\FAX0004.ZFX

  Ŀ
  MY EXEPRINT.BAT
  

d:\fd\xrdos send /f%1 /r2:000/000 /n3 /mb+

Here I use XRobot 301 for dos to send me the notification of a fax
/F%1 uses the second part of bgfax's dofax.bat to find the file
/r   is your address
/n3  is user number 3 in my fdsetup (called "BGFAX")
/mb+ sets the fax attach msg attribute

  Ŀ
  SAMPLE BGFAX.CNF FILE
  

To send faxes bgfax needs to have a correctly setup configuration
file. This must be pointed to by an environment variable. In my case
this is "SET BGFAX=D:\FD", this is where my bgfax.cnf resides.

A full .cnf file is contained in the bgfax archive.


;------------------------- generic setup ------------------------
po=2
ft=z
sp=57600
rp=d:\zfax\rcv
tc=ATHMH1
;------------------ front end and /INIT strings -----------------
in=ATZ
in=ATL0M1+FCR=1;+FLID="Your Details here";+FDCC=1,5,0,2,0,0,0,0
;--------------------- fax send mode strings --------------------
si=ATZ
si=AT+FLID="Your Details here"
ds=ATDT
mb=3
mf=3
sw=120




  Ŀ
  POSSIBLE EXEPRINT.BAT TO ALLOW FAX FORWARDING
  

d:\fd\xrdos send /f%1 /r2:000/000 /n3 /mb+
c:\bgfax /send %1 232 343 5566
d:\fd\xrdos send /f%1 /r2:000/001 /n3 /o1

The first line would create a FAX attach msg in your netmail folder
where 2:000/000 is your address, this allows you to view the fax from
fm.

The second line attempts to forward the fax to 232 343 556 using the
information in your bgfax.cnf file.

The third line will create a file attach message in your netmail
folder addressed to 2:000/001 from user 3 and the first address in your
setup.fd. The addition of a /mc+ on this line would set the crash status
on the netmail. Using this method you could poll from another address to
see if you had received any faxes while out..

  Ŀ
  MY SUPRA SETUP
  

AT&V
ACTIVE PROFILE:
B1 E1 L3 M1 N1 Q0 T V1 W2 X4 Y0 %C1 %E1 %G1 \N3 &C1 &D2 &K3 &Q5 &R0 &S0 &X0 &Y0
S00:000 S01:000 S02:043 S03:013 S04:010 S05:008 S06:002 S07:050 S08:002 S09:000
S10:014 S11:048 S12:050 S18:000 S23:063 S25:005 S26:001 S36:007 S37:000 S38:020
S40:071 S46:138 S48:007 S95:003 S109:062 S110:002


  Ŀ
   HISTORY
  

Updated 17/09/93

   BGFax no longer deletes doprint.bat so an extra line was added
   to the main batch file which checks for doprint.bat after a fax
   session and if found deletes it....
   BGFax will now allow the retry delay on fax transmissions to be
   configured.
   Now included are details of a sample bgfax.cnf file
   After successful transmission of a fax bgfax exits with an errorlevel
   of 5.
   I now use XRobot to create netmails after a successful fax transmission
   or after BGFax has a problem.
   XRobot could also be used to forward the received fax as a file attach
   If so desired, read Xrobot's docs for the necessary commandline to
   insert in exeprint.bat

Updated 09/09/93

   bgfax now supports fax transmission from the commandline (beta 5)
   adding a suitable command to your exeprint.bat should allow the
   received fax to be retransmitted/forwarded if you wish. Possible
   uses could be if you are expecting an important an important fax
   and will not be at your machine but at another location with a
   suitable fax. The problem is all faxes received until your return
   would be forwarded, unless you modified or changed the batchfile
   remotely.
   This requires that you edit the bgfax.cnf file to suit your modem
   and set an environment variable to point at its location. Full
   details of this can be found in the bgfax documentation.

Updated 25/8/93

   bgfax now makes a doprint.bat which calls exeprint.bat
   with beta 02      dofax.bat               exefax.bat


Known Bugs

   xrobot doesn't recognize the $task$ in the fd logname.

