By: Gregory Youngblood zeta@tcscs.com 707-489-7500 Of: The Complete Solution BBS Data/Fax: 707-459-9058 Date: 9/14/93; Revision 2 Date: 9/13/93; Revision 1 ************************* UPDATE for BG Fax 1.06 **************************** * BGFax 1.06 adds some new features. Make sure to read the docs for the * * new version along with these instructions to understand new options. The * * marked changes to this file to reflect new features in 1.06 with a double * * astericks ("**"). If you have version 1.05 then you can ignore those * * items, otherwise, make sure you include the updates for BGFax to work * * with Waffle BBS. * ***************************************************************************** This file explains how to set up BGFax to use with Waffle BBS. The config file and batch files are slightly edited versions of batchfiles in use at The Complete Solution BBS. This file covers BGFax 1.05. Thanks goes to marc@mala.proteus.qc.ca for his configuration files from which I was able to expand upon. Those who use Waffle as a BBS are used to the one letter commands that are used while the BBS of "Awaiting Call.." such as P for POLL and C for Chrome and so on. Using BGFax to answer calls Waffle Sysops lose those letters. These instructions will maintain several of those functions while allowing your faxmodem to receive fax or data calls. Best of all, your existing users won't see the modifications. NOTE: The MODEM init strings used in these configurations are for a Practical Peripherals PM14400FXMT (Rockwell based) fax/modem. The base configuration has been stored in location 0 and can be retrieved with ATZ0 if I should want to. Instead I always init the modem starting with the factory defaults and make the needed changes for my tastes. This way I've always got the changes if another misbehaved program changes my settings. This works under OS/2 2.1 beta (3/93) and probably under 2.1 GA as well. I also use Ray Gwinn's SIO/VSIO/VX00 package, version 1.02. I found that adding the line RUN=C:\OS2\MODE.COM COM1:19200,N,8,1,,XON=OFF,IDSR=ON,ODSR=ON,OCTS=ON, RTS=HS,DTR=ON,BUFFER=AUTO to the end of the CONFIG.SYS file helps out. Note, this line should be on one line. I had to split the line to fit in 80 columns. I also recommend using BGFax in Front End mode since I had some problems getting Waffle to recognize the +FCON message that my modem returns. First, the BGFAX.CNF file: ;Start BGFAX.CNF file ;-------------------------------------------------------------------------- ;Basic Configuration ;COM1, set speed to 19200, choose QLII Fax documents, set incoming directory ;-------------------------------------------------------------------------- po=1 ft=Q sp=19200 rp=d:\BGFAX\incoming ;** tc added in 1.06 tc=ATH0 ;-------------------------------------------------------------------------- ;Init ;Displays CONNECT xxx where xxx is speed of caller, and some extra stuff for ;data callers. Set FAX mode, set Fax Id to Data/Fax number, see BGFAX.DOC! ;-------------------------------------------------------------------------- in=AT&F0e1l1m1w2&c1&d2&k3s0=0s11=70s46=2s95=3 in=AT+FCR=1;+FLID="707-459-9058";+FDCC=1,5,0,2,0,0,0,0 ;-------------------------------------------------------------------------- ;Front End configuration ;Answer first ring with adaptive answering enabled. If data call load BBS ;immediately. Display BBS name if it displays anything. Send /xxx in ;CONNECT 14400/xxx to batch file that calls BBS. Accept all calls 300 bps ;and faster, allow Waffle to display call not accepted message if too slow. ;-------------------------------------------------------------------------- ri=1 an=AT+FAA=1;A do= lo=The Complete Solution BBS ec= sl=300 ts=Calls are not accepted below 300bps. ;-------------------------------------------------------------------------- ;Keys (ALT + letter exits with errorlevel ;S for local login ;X for exit ;C for Chrome ;P for Poll ;-------------------------------------------------------------------------- ;**ky added in 1.06 ky=C,244 ky=S,245 ky=P,246 ky=X,0 ;-------------------------------------------------------------------------- ;Events (taken from Waffle's schedule) ;-------------------------------------------------------------------------- ev=00:00,247 ev=07:00,246 ;-------------------------------------------------------------------------- ;Fax Send Setup ;-------------------------------------------------------------------------- si=AT&f0e1l1m1w2&c1&d2&k3s0=0s11=70s46=2s95=3 si=AT+FLID="713 893 9124" ds=ATDT mb=3 mf=3 ;End BGFAX.CNF file Each setting is explained. If more info is needed see the BGFAX.CNF file in the distribution file for BGFAX. The port was set to 19,200 because I was having problems getting OS/2 to change port speeds from 57,600 down to 19,200 for faxes. I will play with some other settings and such later, but for now this configuration works fine. I've received several faxes using this configuration already. The next file is what I've called BBS.BAT. This is what will replace RUN.BAT for Waffle. I used a new batch file in case I needed to go back to a known working RUN.BAT later on. Make sure to note the WAF_MENU section as that is where you can put extra options. @echo off CLS :TOP BGFAX.EXE If ERRORLEVEL == 247 goto MAINT If ERRORLEVEL == 246 goto POLL REM ** Errorlevels for 245 and 244 added for new ALT-Key codes in 1.06 IF ERRORLEVEL == 245 GOTO LOCAL IF ERRORLEVEL == 244 GOTO CHROME If ERRORLEVEL == 4 goto FAX If ERRORLEVEL == 3 goto WAF_MENU If ERRORLEVEL == 2 goto WAFFLE If ERRORLEVEL == 1 BBS.BAT Goto End :MAINT REM Run Door Maintenance call doormnt.bat REM Run ALLFILES listing call allfiles.bat REM Expire newsgroups call expire.bat REM Run VACATION call vacation.bat REM Run stats for term program to track LD costs call tmstats.bat 1 REM Delay for 60 seconds to make sure that event doesn't get run again be delay 1080 Goto TOP :POLL Rem Poll CCM for 10 minutes or until connection established call poll.bat ccm 10 REM Delay for 60 seconds to make sure that event doesn't get run again be delay 1080 Goto TOP :FAX call %BGFAX%\doprint.bat goto TOP :WAF_MENU REM USING a batch utility that allows single character input without pressing REM Return and then exits using ERRORLEVEL to determine choice. This example REM uses BE.EXE from Norton Utils 6. The options are virtually limitless, REM I personally have 12, this example just lists 4. C=Command.COM (my REM personal replacement for Chrome), P=POLL, S=Sysop Login, U=UUQ. type %BGFAX%\waf_menu.txt BE ASK "" CPSU Default=P IF ERRORLEVEL == 4 GOTO UUQ IF ERRORLEVEL == 3 GOTO LOCAL IF ERRORLEVEL == 2 GOTO POLL IF ERRORLEVEL == 1 GOTO CHROME Goto TOP :UUQ uuq.exe pause goto TOP :LOCAL call %BGFAX%\dobbs.bat LOCAL goto TOP :CHROME command.com goto TOP :WAFFLE call %BGFAX%\dobbs.bat :END Since BGFAX uses RETURN to start the local login, I have put a sort of menu system in that gives me back some of the functionality of Waffle when it is waiting for a call. Instead of starting the Waffle Local when RETURN is pressed I display a menu, such as: The Complete Solution BBS Interactive MENU C Command Shell P Poll Neighbor S Local Login U Query Outgoing And then using some utility to read input and return an errorlevel I can launch any of these or anything else I might want to put in this menu. ************************* UPDATE for BG Fax 1.06 **************************** * BGFAX 1.06 now supports exiting with errorcodes for ALT-Key combinations. * * The above example has been updated to work with 1.06 and still maintains * * the use of the MENU system as described for 1.05. Since 1.06 has this * * new feature, then the RETURN key can be put back to local log in. To * * use the return key for local logins simply change the line which reads: * * If ERRORLEVEL == 3 goto WAF_MENU --to-- * * If ERRORLEVEL == 3 goto LOCAL * ***************************************************************************** The next file, EXEBBS.BAT could go in the BGFAX directory, but I wanted it in my WAFFLE\BIN directory, so in BGFAX I put the folling as EXEBBS.BAT: @echo off call D:\BIN\EXEBBS.BAT %1 %2 %3 %4 %5 %6 %7 %8 %9 In EXEBBS.BAT (the real one) I have the following: @echo off IF "%1" == "LOCAL" WAFFLE LOCAL if not "%1" == "LOCAL" WAFFLE ONLINE %1 IF ERRORLEVEL == 99 GOTO POLL If ERRORLEVEL == 75 GOTO TELEMATE If ERRORLEVEL == 42 GOTO ANONYMOUS If ERRORLEVEL == 40 GOTO UUCICO Goto End :POLL call poll.bat ccm 10 goto End :TELEMATE C: cd \modem\telemate\tm tm.exe Goto END :Anonymous call UUANON goto END :UUCICO call UUSHELL goto END :END if EXIST D:\SPOOL\COMPRESS\*.* batch.exe Since i have my WAFFLE system set up to allow me to run Telemate if I am logged in locally I have put the catch for that ERRORLEVEL in this batch file. Similarly, this is also the batch file that would catch errorlevels for UUCICO sessions. The key here is to make sure it terminates. This batch file should NOT start itself over or call itself. Control needs to be returned to BBS.BAT so that the modem can be answered and faxes or data calls received. The last little goody I've added is a mail notification batch file. I don't want to print incoming batch files automatically but I want a reminder that I've received a fax. In the BGFAX directory create a batch file called EXEPRINT.BAT, and in that batch file put the following: @echo off rmail.exe -fFax-Daemon "-s%1" System < D:\BGFAX\INCOMING.MSG and in INCOMING.MSG all I have is: This fax was received today. The subject line "-s%1" puts the fax filename in the subject of the message. This sends a message to System from the "fax-daemon" of your system telling your that your equipment received a fax. In case the modem setup is important to you, this is what my modem is set to, and other useful/important information: ati3 PM14400FXMT [6R1] Version 2.17 (c) Practical Peripherals Inc., 1992, 1993. OK at&v ACTIVE PROFILE: DTE:57600 DCE:1200 PARITY:NONE B16 B1 E1 L0 M0 N1 T Q0 V1 W2 X4 Y0 &A0 &B1 &C1 &D2 &G0 &J0 &K3 &L0 &Q9 &R0 &S0 &T4 &U0 &X0 &Y0 S00:000 S01:000 S02:043 S03:013 S04:010 S05:008 S06:002 S07:050 S08:002 S09:006 S10:014 S11:070 S12:050 S18:000 S25:005 S26:001 S30:000 S36:007 S37:000 S38:002 S43:005 S46:002 S48:007 S49:064 S50:220 S63:000 S82:128 S86:000 S95:003 S97:030 S108:001 S109:062 S110:002 STORED PROFILE 0: B16 B1 E1 L0 M0 N1 T Q0 V1 W2 X4 Y0 &A0 &C1 &D2 &G0 &J0 &K3 &L0 &Q9 &R0 &S0 &T4 S00:000 S02:043 S06:002 S07:050 S08:002 S09:006 S10:014 S11:070 S12:050 S18:000 S25:005 S26:001 S30:000 S36:007 S37:000 S38:002 S46:002 S48:007 S63:000 S82:128 S95:003 S97:030 S108:1 S109:062 S110:2 STORED PROFILE 1: B16 B1 E1 L0 M1 N1 P Q0 V1 W0 X4 Y0 &A0 &C1 &D3 &G0 &J0 &K3 &L0 &Q5 &R0 &S0 &T4 S00:000 S02:043 S06:002 S07:050 S08:002 S09:006 S10:014 S11:095 S12:050 S18:000 S25:005 S26:001 S30:000 S36:007 S37:000 S38:020 S46:002 S48:007 S63:000 S82:128 S95:001 S97:030 S108:1 S109:062 S110:2 TELEPHONE NUMBERS: &Z0= &Z1= &Z2= &Z3= OK ati4 a097840F284C6703F bC60004000 r1001111171012000 r3000111010000000 OK at+fclass=? 0,1,2 OK If you have any questions or problems about this information, send e-mail to Zeta@tcscs.com or call The Complete Solution BBS at 707-459-9058. If you REALLY get into a bind, you can call me at the first phone number listed at the start of the instructions for Waffle BBS. You may get a voice mailbox, if so, leave a message and I'll call you back. Please don't call me voice unless your having a problem with Waffle working with BGFAX. If you have problems with BGFAX contact the author using one of the methods in BGFAX.DOC.