This is the BGFAX help file where I will both my comments and other
people's comments and helpful hints on getting BGFAX set up with their
particular FidoNet mailer software.

* FD 2.02/NC  (thanks to a guy from Internet for showing me how!)
  FD 2.20
* Intermail 2.21  (I tested it with the trial version)
  PC Board Beta  (by the new Errorlevel 7 exit for fax, I've heard)
  GT Power Beta  (by the new GT_FAX.BAT file)
  Dutchie 3.0 Gamma
* D'Bridge 1.53
* Binkley (not via CONNECT FAX method)

Note that some of the following statements were made before I learned it is
a good thing to supply the +fDCC=1,5,0,2,0,0,0,0 in the init string for
14400 fax modems and +fDCC=1,3,0,2,0,0,0,0 for 9600 fax modems.

--------------------------------------------------------------------------
Setup hints for using BGFAX with FD 2.02/NC  (08-19-93)
B.J. Guillot
Internet: st1r8@jetson.uh.edu
Fidonet: 1:106/400
--------------------------------------------------------------------------

IMPORTANT ANNOUNCEMENT!  FRONTDOOR 2.02/NC WORKS WITH BGFAX!

Here is the relevant information from FDSETUP ...

[FDSETUP]  Modem -> Command Strings
  Init-1 ... AT+fCR=1;+fDCC=1,5,0,2,0,0,0,0|
  Init-2 ... AT+fLID="HELLO WORLD"|

Notice that the "+f" is always in LOWERCASE letters!  This is done so that
Frontdoor does not mistake an initialization string as a fax connect.

  +FAA=1  enables adaptive answer
  +FCR=1  enables fax receiption
  +FLID="xxxxx"     sets your FAX ID, it can be up to 20 characters

Note that you CANNOT put most of the fax commands in NVRAM.

[FDSETUP] Modem -> Answer control
  Force answer ... AT+FAA=1;A|

Some modems "forget" the +FAA setting after answering a call, so this is
only done to make sure adaptive answering is enabled.

[FDSETUP] Mailer -> Errorlevls

1275 ... 255

Okay, here are the settings ***** METHOD #1 *****  (Preferred method)

Some modems return a "get ready" message before the fax modems actually
start mating.  My modem, a Supra, reports "FAX" when it hears the remote
machine make a CNG tone.  This is the preferred method because
(on the Supra anyway), the "FAX" message comes about 2 seconds before the
axes start mating which gives time for FD to exit and BGFAX to load.

[FDSETUP] Modem -> Messages

1275 ... F              (yes, a SINGLE UPPERCASE letter F without pipes)

[FDSETUP] Mailer -> External mail

   String                                     Level
1  X                                          255

(That 255 is the same errorlevel I specified for 1275.)  Notice that "FAX"
is what my modem returns, thus "F" and "X".  See?

FDRUN.BAT (or whatever) should contain:

if errorlevel 255 rearend

REAREND.BAT has one line:

BGFAX /FAX

Okay, here are the settings ***** METHOD #2 *****  (Alternate method)

Modems also report a "+FCON" when they get connected (after they make the
first move in their mating dance.)  Do this if Method #1 will not work for
you:

[FDSETUP] Modem -> Messages

1275 ... +FC              (yes, the three characters +, F, and C)

[FDSETUP] Mailer -> External mail

   String                                     Level
1  N<numeric alt-13>                          255
    ^^^^^^^^^^^^^^^^--this will appear as a MUSICAL note
See "+FC" and "N" come from +FCON.

To get that <numeric alt-13>, hold down your <ALT> key, then, ON THE
NUMERIC KEYPAD, hit the <1> and then the <3> key, then LET GO of the <ALT>
key.  A musical symbol will appear.

FDRUN.BAT (or whatever) should contain:

if errorlevel 255 rearend

REAREND.BAT has one line:

BGFAX /FCON

||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||

--------------------------------------------------------------------------
Setup hints for using BGFAX with FD 2.02/NC  (08-25-93)
Mark Kerr
Fidonet: ?????????
--------------------------------------------------------------------------

Updated 25/8/93

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




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.00beta4                   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 and zfax to view the fax.

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
Printer

 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 4 call d:\zfax\rcv\doprint
   goto START

  ┌───────────────────────────────────┐
  │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 "FAX")
/mb+ sets the fax attach msg attribute

  ┌──────────────┐
  │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

||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||

--------------------------------------------------------------------------
Setup hints for using BGFAX with Intermail 2.21  (08-04-93)
B.J. Guillot
Internet: st1r8@jetson.uh.edu
Fidonet: 1:106/400
--------------------------------------------------------------------------

IMSETUP.EXE ... Modem -> Advanced setup -> Command strings

Init-1     AT+FCR=1;+FDCC=1,5,0,2,0,0,0,0|
Init-2     AT+FLID="HELLO WORLD"|

IMSETUP.EXE ... Modem -> Advanced setup -> Answer control

Manual answer    Yes
Force answer     AT+FAA=1A|  (that's all that will fit, I know that some
                             modems likes AT+FAA=1;A| with a sem, so
                             modem owners may want to try and add +FAA=1 to
                             one of the init strings and just use ATA|
                             The author of Intermail really needs to expand
                             this field)

IMSETUP.EXE ... Modem -> Advanced setup -> Connect strings

You will see a list of 14 or so preconfigured connect strings, press
<INSERT> to add one, and set it up like so:

  Connect Message                          Speed  EC  BBSexit  Terminate

  FAX                                      19200  N   0        255
            <or if your modem doesn't support that>
  +FCON                                    19200  N   0        255

-------------------------------------------------------------------------

"FAX" is the string my SupraFax Modem returns when it hears the Fax CNG
tone from the remote modem/machine.  I belive the ZyXEL returns "CONNECT
FAX", and some modems return "CONNECT 9600/FAX", etc.  You will have to
find out which your modem uses.  (The modems that don't report this answer
will always wind up reporting "+FCON", so use that as an alternate choice)

Notice that "BBSexit" is equal to ZERO.  It should stay like that!  Notice
that "Terminate" is equal to "254".  This number can be set to whatever you
want as long as its NOT ZERO (and any other value Intermail is picky
about).  I set it so that when Intermail receives the string "FAX" it will
IMMEDIATELY exit with an errorlevel of 254.  (Notice IMMEDIATELY, it
doesn't twiddle around like Frontdoor).

Here's the sample testing batch file I used for BGFAX, IMBATCH.BAT:

@echo off
im
if errorlevel 254 goto fax
goto end
:fax
  bgfax /fax
:end
imbatch

Notice I don't include any BBS handling errorlevel instructions.  You'll
have to do that yourself (it's all configured in "Connect strings").

||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||

--------------------------------------------------------------------------
Setup hints for using BGFAX with Dbridge  (06-18-93)
Randy Fox
Fidonet: 1:363/60
--------------------------------------------------------------------------

Here is the Dbridge set up that we discussed about the other night.
 
All the people need to do is the following:
 
Edit the MCF File they are using.  in my case BOCA3242.mcf
2) Change the "INIT" Line to look something like this:
   (some additional commands may be needed for regular modem use.  I left
    my extras out for less confusion.)
    The file starts off looking like this:
 
    MCF Boca3242 Boca V32b/MNP/V42b
    BAUD 38400
    LOCKED
    DELAY 60
    TIMEOUT 65
    PREINIT ATZ   <----This line can be ommited or altered, but is only sent
                       once upon loading D'bridge
 
    INIT ATH0N1&K3+FCR=1+FAA=1+FLID="MY FAX MACHINE"
    OFFHOOK ATM0H1
    etc....
 
(Note: in the mcf there is no blank lines between the entries, I just ran out
of room for the explaination.)
 
Then, they need to load dbridge and go under Utilities;Security/Miscellaneous.
 
In the EXTERNAL RECIEVERS box they need to enter:
 
FAX|C:\FAX\BGFAX /FAX
    The word FAX before the pipe is the modem response, may need to be
    CONNECT FAX is some instances, or +FCON.  After the pipe is the command
    line for the reciever.  This is the quickest way to load BGFAX if you
    have enough overhead ram.  this is just a small dos shell method.
 
Another option:  after the PIPE symbol, they may speccify a batch file to call
BGFAX.  ie: FAX|FAX.BAT
 
If there is not enough over head ram, they may try swapping Dbridge out by
placing a "+" sign in front of the command line: FAX|+FAX.BAT
 
Or the may drop Dbridge and exit at errorlevel: FAX|*X100 (100 errorlevel)

--------------------------------------------------------------------------
Setup hints for using BGFAX with Binkley  (06-18-93)
Art Geary
1:393/101@fidonet
--------------------------------------------------------------------------

                             BinkleyTerm and PPI 14400FXSA Fax

   I have run Binkley for a number of years, and act as the mail hub for my
   Net. I did not want to change to some other mailer. I also bought a
   Practical Peripherals 14400FXSA modem, and wanted to be able to continue to
   do my mail and recieve fax's on the same line.

   There seemed to be no way to do it. Then along came BGFax. This program can
   either Front-end or Rear-end a BBS. Thank you B.J. Guillot.

   Here is my cludge....

           1.      Set up BGFax to Front end. See BGFAX.CNF.
                   Event times are set 1 minute before my Binkley.evt file
                   times.
           2.      Add 'Server' verb to Binkley.cfg.
           3.      Tweak Binkley batch file. See BINK.BAT.

   Works fine here on 16MHz 386SX.

   Only bad thing is that the %'s on transfer rate will be wrong if BGFAX
   answers phone.

   BGFAX.CNF

   po=1
   ft=q
   sp=19200
   in=ATZ
   in=AT+FAA=1;+FCR=1;+FLID="UNIWARE"
   in=ATM0
   ri=1
   an=AT+FAA=1;A
   do=<load>
   lo=
   ec=/ARQ
   sl=300
   ts=Calls are not accepted below 1200 bps.  Sorry.
   cm=CQ,104
   ev=23:59,124
   ev=00:29,123
   ev=01:59,122
   ev=03:59,121
   ev=04:59,120
   ev=05:49,119
   ev=06:29,118
   ev=06:59,117
   ev=21:58,115
   ev=22:58,116

   BINK.BAT

   c:
   cd \max
   cls
   vfos_ibm
   echo off
   :start
   :chkcra
   REM IF CRASH MAIL WAITING TO GO OUT, BYPASS BGFax
   if exist \max\outbound\*.cl* goto loop
   :bfax
   bgfax
   if errorlevel 124 goto loop
   if errorlevel 123 goto loop
   if errorlevel 122 goto loop
   if errorlevel 121 goto loop
   if errorlevel 120 goto loop
   if errorlevel 119 goto loop
   if errorlevel 118 goto loop
   if errorlevel 117 goto loop
   if errorlevel 116 goto loop
   if errorlevel 115 goto loop
   if errorlevel 4 goto start
   if errorlevel 3 goto loop
   if errorlevel 2 goto loop
   if errorlevel 1 goto start
   if errorlevel 0 goto end
   goto chkcra
   :loop
   erase lastuse1.bbs
   btbig unattended share
   if errorlevel 192 goto max192
   ETC...

   All routines in the batch file end with goto start.
   Errorlevels 124 - 115 corespond the errorlevels set in BGFAX.CNF.
   I also made my F1 key in Binkley (errorlevel 10) goto bfax to enable a fax
   recieve manually.

   Any questions or suggestions to...

   Art Geary
   1:393/101@fidonet
   (817) 321-3213  Fax 07:00 - 22:00 CDT  Data 24 hrs.
   (817) 321-3903  Voice
