ReFax 1.00 / FOSSIL version 旼컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� ReFax 1.00 FOSSIL version ZyXEL Recievefax for mailer and BBS systems 읕컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� Copyright 1993, NewAge productions, All rights reserved ReFax 1.00 / FOSSIL version Introduction 컴컴컴컴컴컴� When the excellent modem ZyXEL U-1496 was introduced it added a new dimension to the mailer/BBS community by allowing the modem to automatically detect wether an incoming call was a fax or a modem. With modern mailer/BBS software it was suddenly possible to recieve fax transmissions interchangable with ordinary modem calls. There was only one little problem - the RCVFAX software. Even if it works in most environments, it completely refuses to run in others. For instance, RCVFAX refuses to work in DOS windows of Windows and OS/2, even though the mailer or BBS software happily runs without a problem. Another area of difficulties is where the system is using non-standard COM ports. RCVFAX also had problems with higher locked DTE rates, like 57600 bps. To solve these problems we decided to write a replacement for RCVFAX, to be used in mailer/BBS environments only, and this replacement is the ReFax software. ReFax uses the FOSSIL for communication. This means that if your mailer/BBS works in a given environment - then ReFax will work equally well, since it is the FOSSIL that handles all the hardware related COM port handling. ReFax simply recieves the fax transmissions and exits. ReFax is not a true replacement for RCVFAX though, since it is only intended to be used together with a mailer or BBS system. ReFax can only pick up after the mailer/BBS has already made the connection, and it is not capable of going resident to handle fax transmissions as a background task. Given the above limitations, ReFax is a full-fledged batch fax recieveing program with the following features: � Uses the FOSSIL for minimum of compatibility problems. � Optionally shows/logs extended connection information. � Optional verbose recieved fax log file. � Optionally logs the action to your mailer/BBS log file. � Selectable FrontDoor, BinkleyTerm and D'Bridge log styles. � Has been successfully tested in DOS-boxes of Windows 3.1 and OS/2 2.0. � Creates fax files compatible with ZFAX. � A true OS/2 version is readily available. ReFax 1.00 / FOSSIL version Credits 컴컴컴켸 Program design and coding by jonny bergdahl. ReFax was written using OOP techniques with the excellent toolkit Async Professional from Turbo Power Software. ReFax was compiled using Borland Pascal with objects 7.0. Documentation written and produced by jonny bergdahl. Special thanks goes to Anders Brink (who ported ReFax to OS/2), Patrik Sj봟erg and Joaquim Homrighausen. Disclaimer and legal matters 컴컴컴컴컴컴컴컴컴컴컴컴컴컴� The ReFax software and documentation is subject to the following license terms and conditions. � ReFax is supplied as is. The author disclaims all warranties, expressed or implied, including, without limitation, the warranties of merchantability and of fitness for any purpose. The author assumes no liability for damages, direct or consequential, which may result from the use of the ReFax software. � ReFax is distributed as a "shareware program" and is provided at no charge to the user for evaluation for a period not extending 30 days, after which You are required to register. Feel free to share it with your friends, but please do not give it away altered or as part of another system. The essence of "user-supported" software is to provide personal computer users with quality software without high prices, and yet to provide incentive for programmers to continue to develop new products. � The ReFax distribution package, all programs, the documentation and support files are copyrighted 1993 by NewAge productions. All rights are reserved. You may copy this package for backup purposes. You may also copy and share unmodified copies of the whole distribution package, providing that the copyright notice is reproduced and included on all copies. � You may not sell the product for a fee and/or distribute the product along with other products without written permission, nor may you modify or remove the Copyright Notices from the programs or the documentation files. User clubs, if they are NOT commercial, are allowed to ask a small amount of money for distribution and storage when they want to share this package amongst their members. ReFax 1.00 / FOSSIL version � It is expressively forbidden to modify, adapt, translate, reverse engineer, decompile and/or disassemble the software in the ReFax package. Patching the medium at places that carry the software is seen as a program change and is also forbidden. � The registered software is licensed to run in conjunction with 1 (one) ZyXEL modem only. Thus You will have to purchase one license for each of your fax reieveing mailer/BBS lines. Acknowledgement 컴컴컴컴컴컴컴켸 This document makes reference to a number of third-party products. All copyrights, trademarks and reserved rights held in these products are acknowledged. Fast installation 컴컴컴컴컴컴컴컴켸 Place the REFAX.EXE executable file in a directory of your choice, and change your mailer/BBS setup to run ReFax with a parameter line that contains at least the /p parameter. Example: REFAX /P:0 This setup will tell ReFax to use COM1:, recieved fax files will be put in the current directory. The FOSSIL is assumed to be locked. Sample FrontDoor installation 컴컴컴컴컴컴컴컴컴컴컴컴컴컴켸 1. Add the string "#B1+FCLASS=6" to the init string. Make sure that the "+FCLASS=6" string is the last command on the line. 2. Change the CONNECT 1200/75 message string to "CONNECT FAX". 3. Set the external mail string to "ZyXEL" (Please note that this string is case sensitive) and give it an errorlevel. 4. Edit your FrontDoor batch file, to make it execute ReFax with appropriate parameters when FrontDoor exits with the above errorlevel. ReFax 1.00 / FOSSIL version Command line parameters 컴컴컴컴컴컴컴컴컴컴컴켸 ReFax accepts the following command line parameters: REFAX /p:n [/b:n] [/w:path] [/l:path] [/m:path /t:F|B|D] [/x] /p:n COM-port to use, this parameter is mandatory. Note that n=0 means COM1:, n=1 means COM2:. Example: /p:1 Use COM2: /b:n Baudrate, used only if running unlocked FOSSIL. Example: /b:38400 Set to 38400 bps. /w:path Recieved fax file path. This should be a valid existing path. All recieved fax files will be placed in this directory. Example: /w:C:\FD\FAX /l:path Recieved fax log file. This should be a valid DOS file name. If not specified, no log file is created. (Note: Available in registered version only) Example: /l:C:\FD\FAX\REFAX.LOG /m:path Mailer log file. This should be a valid DOS file name. If not specified, or if /t is not used, no log file is created. (Note: Available in registered version only) Example: /m:C:\FD\FDFILE\FD.LOG /t:type Select FrontDoor/Binkley/D'Bridge log style for the log file specified by the /m parameter. Valid choices are: F FrontDoor B BinkleyTerm D D'Bridge (Note: Available in registered version only) Example: /t:F Set to FrontDoor log style. ReFax 1.00 / FOSSIL version /x Log extended connection information to screen and to a defined mailer log file. If specified, the following information is logged to screen: � Connection information: Speed : 9600 Remote phone number : 46 036 1755 Vertical resolution : Normal Coding scheme : One dimensional Recording width : 1728 pixels [215 mm] Recording length : Unlimited Min. scan line time : 20 ms, T(7.7)=T(3.85) (Note: Available in registered version only) Screen logging 컴컴컴컴컴컴컴� When run, ReFax displays the progress on screen in the following manner; ReFax 1.00; ZyXEL Recievefax for mailers Copyright 1993, jonny bergdahl, NewAge productions, All rights reserved Registered to jonny bergdahl � Fossil initialized BNU FOSSIL Communications Driver v1.70 � Creating Fax file [93Mar03.009] � Initiating fax recieve � Page 1 [14791] � Remote confirmed disconnect [46 036 175513] where the byte recieved counter is updated once a second. If the parameter /x is specified, extended connection information is logged to screen as well. Recieved fax log file 컴컴컴컴컴컴컴컴컴컴켸 Specified by using the /l:path parameter. Sample recieved fax file (compressed for display purposes): ReFax 1.00; ZyXEL Recievefax for mailers Copyright 1993, NewAge productions, All rights reserved Registered to jonny bergdahl Date Time File Remote fax number Speed Pages Size Conf. ----------- ----- ----------- ----------------- ----- ----- ----- ---- 1993-Mar-04 00:07 93Mar04.000 46 036 121323 9600 1 42562 Yes 1993-Mar-04 00:10 User abort 1993-Mar-04 00:22 93Mar04.001 46-291-10150 14400 2 87465 Yes ReFax 1.00 / FOSSIL version Mailer log file logging 컴컴컴컴컴컴컴컴컴컴컴켸 FrontDoor log style 컴컴컴컴컴컴컴컴컴� Specified by the /m:path and /t:F parameters together. Sample FrontDoor log file: ---------- Wed 3 Mar 93, ReFax 1.00 02:19:30 Fossil initialized 02:19:30 Creating Fax file [93Mar03.002] 02:19:30 Initiating fax recieve 02:20:04 Page 1 recieved [42992] 02:20:08 Remote confirmed disconnect [46 036 175513] BinkleyTerm log style 컴컴컴컴컴컴컴컴컴컴� Specified by the /m:path and /t:B parameters together. Sample BinkleyTerm log file: 03 Mar 23:03:29 RFAX Fossil initialized 03 Mar 23:03:29 RFAX Creating Fax file [93Mar03.009] 03 Mar 23:03:29 RFAX Initiating fax recieve 03 Mar 23:03:52 RFAX Page 1 recieved [29900] 03 Mar 23:03:56 RFAX Remote confirmed disconnect [46 036 175513] D'Bridge log style 컴컴컴컴컴컴컴컴컴 Specified by the /m:path and /t:D parameters together. Sample D'Bridge log file: 03/03/93 23:09:39.15 RFAX; Fossil initialized 03/03/93 23:09:39.20 RFAX; Creating Fax file [93Mar03.010] 03/03/93 23:09:39.20 RFAX; Initiating fax transfer 03/03/93 23:10:02.10 RFAX; Page 1 recieved [29735] 03/03/93 23:10:06.11 RFAX; Remote confirmed disconnect [46 036 175513] Viewing and printing 컴컴컴컴컴컴컴컴컴컴� To view and/or print the recieved fax, use the ZFAX software bundled with your ZyXEL modem. Example: ZFAX 4 93Mar03.00 This will show the fax on screen. ReFax 1.00 / FOSSIL version Support 컴컴컴켸 Support is available from the author via several channels: Snail mail: NewAge productions jonny bergdahl Lillgatan 34 B S-554 51 J셄K셆ING Sweden Netmail (Crashmail capable): 2:204/503@fidonet 9:463/101@virnet BBS: NewAge BBS, +46-36-121323, 1200-16800 ZyX. Fax: +46-36-121323 (Using ReFax)