--------------------------------------------------------------------------
Setup hints: BGFAX, Class 2 fax modems, Binkley 2.60 (DOS & OS/2) 04-18-96
B.J. Guillot                                              bgfax@blkbox.com
FidoNet 1:106/400                            http://www.blkbox.com/~bgfax/
--------------------------------------------------------------------------

YOU MUST BE USING BINKLEY 2.60...  DO NOT USE THE 2.59 BETAS OR EARLIER.

Here is a clip from the BINKLEY.CFG file...

;***************************************************************
;*  Fax Related Section of Binkley.CFG for a Class 2 faxmodem  *
;*  Class 2 such as Supra, Zoom, PPI, etc. NOT FOR US ROBOTICS *
;***************************************************************
PreInit    |v``^``ATHZ|~~
Init       AT+FAA=1;+FCR=1;+FLID="713\ 555\ 1212";+FDCC=1,3,0,2,0,0,0,0|
PreDial    `
Prefix     ATDT
Answer     ATA|
DtrHigh
;MailNote                      ; must be COMMENTED OUT for BGFAX to work!!!
;FaxInDir   NOT_USED           ; must be COMMENTED OUT for BGFAX to work!!!
;FaxBaud    NOT_USED           ; useless when used with BGFAX
ExtrnMail     123 FAX
Extern        spawn            ; this causes Bink to spawn EXTMAIL.BAT|CMD
ModemFax      FAX
ModemIgnore   RINGING
ModemIgnore   RING RESPONSE
ModemRinging  RING
ModemConnect  CONNECT
ModemIgnore   RRING
ModemRetry    BUSY
ModemFailure  VOICE
ModemFailure  ERROR
ModemFailure  OK
ModemFailure  NO CARRIER
ModemIncoming NO DIAL
ModemIgnore   DIALING
ModemFailure  NO ANSWER
ModemIgnore   DIAL TONE


Miscellaneous notes about BINKLEY.CFG...

  1. The "123" number I choose in the "ExtrnMail" verb above is just a
     dummy number.  Since we are spawning to EXTMAIL.BAT|CMD, the number
     itself does not make any difference
  2. The "\" character used in the PreInit and Init strings allow
     Binkley to "escape" the following character, e.g., \. sends a
     period.  If we did not put a "\.", Binkley would convert the
     period to a comma, and we do not want that.
  3. Binkley will NOT report modem initialization errors and this makes
     finding errors almost impossible.

The other important file we must create is EXTMAIL.BAT|CMD, which will
reside in the Binkley directory...

=======================================================================

IF YOU ARE USING A MODEM THAT REPORTS A "FAX" RESPONSE, SUCH AS A SUPRA
OR ZOOM, ...........  (METHOD #1)

EXTMAIL.CMD  (If you are using Binkley and BGFAX for OS/2)
~~~~~~~~~~~
@d:\util\sio\su 1 lock 0
@c:\bgfax\bgfax2 /fax c:\bgfax h%3 z

The "SU" command in the first line will tell the SIO.SYS drivers to unlock
the communications port so that BGFAX is able to adjust the DTE speed to
whatever value your modem needs to be set to for fax receive mode.  The "1"
stands for "COM1".  The "H%3" is a communications handle which is auto-
matically passed by Binkley so you do not need to tell BGFAX/2 which com
port you are using.


EXTMAIL.BAT  (If you are using Binkley and BGFAX for DOS)
~~~~~~~~~~~
@c:\bgfax\bgfax /fax c:\bgfax 1 z

The "1" above tells BGFAX to receive using COM1.

If Binkley/2 is working correctly, your BINKLEY.LOG will show an entry
like this...

+ 18 Apr 16:36:39 BINK begin, BinkleyTerm-OS/2 Ver. 2.60 -IBMC/2
# 18 Apr 16:38:54 BINK Ring
# 18 Apr 16:38:55 BINK Fax
: 18 Apr 16:38:56 BINK Spawning external mailer
: 18 Apr 16:39:31 BINK Returned from external mailer
* 18 Apr 16:39:35 BINK Seconds: 45  Tariff: 0  Fee: 0  System: FAX
: 18 Apr 16:39:35 BINK Exit after receiving mail with errorlevel 20
+ 18 Apr 16:39:35 BINK end, BinkleyTerm-OS/2 Ver. 2.60 -IBMC/2

Notice that after the fax is received, Binkley will go ahead and exit
with the errorlevel defined by E2= in the BINKLEY.EVT file after BGFAX
releases control back to Bink.  Again, this happens AFTER the BGFAX
transfer has already happened.

====================================================================

IF YOU ARE USING A MODEM THAT REPORTS A "+FCON" RESPONSE, SUCH AS A
PRACTICAL PERIPHERALS PPI, ............ (METHOD #2)

First, we need to go back to BINKLEY.CFG we just modified a few minutes
ago and make two quick changes...

        ExtrnMail     123 +FCON
        ModemFax      +FCON

EXTMAIL.CMD  (If you are using Binkley and BGFAX for OS/2)
~~~~~~~~~~~
@d:\util\sio\su 1 lock 0
@c:\bgfax\bgfax2 /fast:4 c:\bgfax h%3 z

EXTMAIL.BAT  (If you are using Binkley and BGFAX for DOS)
~~~~~~~~~~~
@c:\bgfax\bgfax /fast:4 c:\bgfax 1 z

The "1" mentioned on the SU and BGFAX lines are for COM1.

The /FAST:4 parameter tells BGFAX to wait for an "OK" message for
up to 4 seconds before assuming it was missed during the transition
from Binkley to BGFAX.  Depending upon the speed of your computer and
several other factors, the 4 timing parameter may need to be adjusted.
Try /FAST:2, or /FAST:0, or perhaps even /FAST:6 if BGFAX does not
appear to be working correctly.