ReFax/2 for OS/2 1.00 ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ReFax/2 1.00 OS/2 version ZyXEL Recievefax for mailer and BBS systems ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Copyright 1993, NewAge productions, All rights reserved ReFax/2 for OS/2 1.00 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 DOS environments, it is not a native OS/2 program, and will not work together with native OS/2 mailers or BBS systems. To solve these problems we decided to write a replacement for RCVFAX, to be used in true OS/2 mailer/BBS environments only, and this replacement is the ReFax/2 software. ReFax/2 uses the OS/2 communication port handles for communication. This means that if your mailer/BBS works in a given environment - then ReFax/2 will work equally well, since it is OS/2 that handles all the hardware related COM port handling. ReFax/2 simply recieves the fax transmissions and exits. ReFax/2 is not a true replacement for RCVFAX, since it is only intended to be used together with a mailer or BBS system. ReFax/2 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: þ A true OS/2 program, works with IBM or Microsoft OS/2 1.3 or higher. þ Optionally shows/logs extended connection information. þ Optional verbose recieved fax log file. þ A DOS/FOSSIL version is readily available. Credits ÄÄÄÄÄÄÄÙ Program ported to C and OS/2 environment by Anders Brink. Original ReFax program design and coding by jonny bergdahl. ReFax/2 was compiled using Microsoft C 6.0. Documentation was written and produced by jonny bergdahl. Special thanks goes to Anders Brink, Patrik Sj”berg and Joaquim Homrighausen. ReFax/2 for OS/2 1.00 Disclaimer and legal matters ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ The ReFax/2 software and documentation is subject to the following license terms and conditions. þ ReFax/2 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/2 software. þ ReFax/2 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/2 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. þ It is expressively forbidden to modify, adapt, translate, reverse engineer, decompile and/or disassemble the software in the ReFax/2 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 recieveing 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. ReFax/2 for OS/2 1.00 Fast installation ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Place the REFAX2.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

parameter. Example: REFAX 5 This setup will tell ReFax/2 to use com-handle 5, recieved fax files will be put in the current directory. Sample BinkleyTerm installation ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Requires BinkleyTerm 2.50 EE-beta-D or similar. 1. Add the following lines to your BINKLEY.CFG: EXITBAUD -99 FAX PREINIT |^v`^``AT#B1+FCLASS=6|`AT#P46 291 10150|`AT+FLID=SoftSpeed ÄÄÄÄÄÄÄÄÄÄÄÄ ÄÄÄÄÄÄÄÄÄ inserting your fax phone number and fax identification were appropriate. At least you must have the following init string: INIT A#B1+FCLASS=6| 2. Create the command file EXITBAUD.CMD in your BinkleyTerm default directory and make it look something like this: @ECHO OFF REM %3 is the hot com-handle passed by the parent process CD \FAX ReFax2.EXE %3 C:\FAX\IN CD \BINKLEY 3. Make sure MAXCOMM.DLL exist in the DPATH search path. ReFax/2 for OS/2 1.00 Command line parameters ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ReFax/2 accepts the following command line parameters: REFAX2

[path]

Hot COM-handle to use. Must be a HOT COM-handle passed by the mailer or fax answering program, You can not use 1 for COM1, it will not work. [path] Recieved fax file path. This should be a valid existing path. All recieved fax files will be placed in this directory. This parameter is optional. If not specified, ReFax/2 looks for the FAXPATH environment variable, if FAXPATH is not found it will use the default directory to store incoming fax files and the log file REFAX2.LOG Example: REFAX2 5 C:\FD\FAX Screen logging ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ When run, ReFax displays the progress on screen in the following manner; ReFax/2 1.00; ZyXEL Recievefax for OS/2 mailers Copyright 1993, Anders Brink & NewAge productions, All rights reserved Registered version, do not distribute. þ 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. ReFax/2 for OS/2 1.00 Recieved fax log file ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Specified by using the parameter. Sample recieved fax file (compressed for display purposes): ReFax/2 1.00; ZyXEL Recievefax for OS/2 mailers Copyright 1993, Anders Brink & NewAge productions, All rights reserved Registered version. Do not distribute. Date Time File Remote fax number Speed Pages Size Conf. ----------- ----- ----------- ----------------- ----- ----- ----- ---- 1993-Mar-04 00:07 93Mar04.000 46 036 175513 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 Viewing and printing ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ To view and/or print the recieved fax, use the ZFAX software bundled with your ZyXEL modem. Example: ZFAX 4 93Mar03.000 This will show the fax on screen. Support ÄÄÄÄÄÄÄÙ Support is available from the author via several channels: Snail mail: NewAge productions jonny bergdahl Lillgatan 34 B S-554 51 J™NK™PING 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/FOSSIL)