FreeFile Version 1.00 Copyright (c)1994 Gorgon Enterprises, Inc. P.O. Box 200 Avenel, NJ 07001 Best Buy BBS 908.634.5117 Copyrights herein are the property of their respective owners. INTRODUCTION Why FreeFile? Gorgon Enterprises, Inc. runs Best Buy BBS a subscription Bulletin Board Service in Woodbridge, New Jersey at (908)634-5117. Even though our service is for paid subscribers, there are certain files we make freely available to non-subscribing callers: file lists, RipTerm, subscription information, etc. In order for a non-subscriber to obtain these files, they would have to log on, find the free file directory, flag the file or files and download them. With FreeFile installed as a Logon Script (see INSTALL.TXT) they are auto- matically presented with these files as soon as they log in. This program was written with the idea of drastically increasing the number of times these selected files are downloaded. We felt as though this would increase our base of paying callers by making it easier for the callers to obtain our file lists and other system information. With this information in hand, the caller will be more likely to call again and end up registering. BACKROUNDER Gorgon Enterprises, Inc. is a New Jersey corporation that was founded in November, 1993. We provide consulting, networking and custom application services to small and medium size businesses throughout Northern New Jersey, Manhattan, Long island and upstate New York. The company's founder and President, John P. Carroll, has been in the computer industry for over a decade. Besides hardware and networking, John has been working with X-Base languages for over six years. He started out with dBase III plus and worked through dBase IV, Foxpro 2.0 for DOS, Foxpro 2.5 & 2.6 for Windows and Microsoft Access 2.0. We currently develop custom applications for clients in Foxpro 2.6 for Windows and Lotus Notes 3.2. With our interest in the BBS community, Shareware and PCBoard itself, we saw PPL 3.0 as being a natural extension of the services we currently offer. OVERVIEW FreeFile is a PPE for PCBoard 15.2+ that makes it very easy for unregistered callers to obtain files that you wish to make freely available. FreeFile is installed as a Logon Script and in the CMD.LST. As a Logon Script, the program is started immediately after a caller enters their password. In the CMD.LST, FreeFile becomes a command available to the caller from the Main Board Command prompt. Although we already have ideas for the next version of FreeFile (see WHATNEXT.TXT), version 1.00 is a complete, debugged application. We have seen many BBS applications, whether they are doors or PPEs or whatever, that have bugs or functions that just don't work. This usually happens because the programmer just can't figure out a problem and releases the program with no concern for fixing the problem. Such programs are rarely supported and many of them are never updated to fix these problems. There are features of FreeFile that are disabled in unregistered versions of FreeFile. However, this program is not CrippleWare, BegWare or PauseWare. FreeFile is Shareware. It is FULLY functional - none of the main features or functions are disabled to encourage registration. For additional information on registration see REGISTER.TXT. For information on the shareware concept, see SHAREWAR.TXT. MAJOR FEATURES OF FreeFile v1.00 - File Existence Testing When displaying the files that you have configured, FreeFile tests for their existence. If the files do not exist, a red * is automatically inserted in front of the file name. A line similar to the following also appears below the list of files: *FILENAME = Unavailable File The * here is also red. This works nicely because if a caller flags all of the free files for download, they are not surprised when one is missing. - Immediate Download Part of the intent of this program was to get our free files into the hands of the new caller right away. When installed as described in INSTALL.TXT, FreeFile will activate for a New Caller immediately after Quick Registration and for a caller who is calling for the second or later time immediately after entering their password. When the caller has selected the files they wish to download, they are presented with the option of downloading the files right away. When the caller responds 'Yes' to the question, they end up downloading the free files before they even get to the Main Command Prompt! - Selection Errors If a caller makes an invalid file selection an error message is displayed. There are currently only 3 valid selections. * selects all files, #-# selects a range of consecutive files and #,# selects multiple, non-sequential files. If a caller makes a selection that does not fit these criteria or selects a file number higher than the number of files available, an error screen is displayed. This screen informs the caller of the error and shows the proper ways of selecting files. The FreeFile program is then restarted. TIPS AND IDEAS Best Buy BBS is configured for FreeFile to run for Security Level 11 only. As such, Line 4 in our FreeFile.cfg file has '11' in it. Configured for Level 11, FreeFile will not run for any other security level - not even sysop. While we were setting up FreeFile, the sysop (obviously not at Level 11) needed to be able to run it. He did not wish to put a * in Line 4 in case people of higher security levels called in while he was setting it up. What he did was put 110 in Line 4 which is our Sysop Security Level. This, along with logging into the node he was working on using USER - BUSY instead of SYSOP - BUSY on the Call Waiting screen allowed him to test the full functionality of FreeFile. When finished configuring and testing FreeFile, the sysop simply changed Line 4 in FreeFile.cfg to '11'. TROUBLESHOOTING Problem: You have the correct directory specified on Line 16 of FreeFile.cfg and the files are in the specified directory, but they all have the red 'Unavailable File' asterisk in front of them when you start the program. Answer: Make sure you have a \ at the end of your directory specification on Line 16 of FreeFile.cfg. If you have 'C:\PCB\FREEFILE' with out the \ and one of the file names is YOURBBS.ZIP, FreeFile will be looking for C:\PCB\FREEFILEYOURBBS.ZIP and this obviously won't exist! Problem: FreeFile only runs for one security level and not others. Answer: We designed FreeFile with the idea of running it for only one security level. If it were a door, we would have installed it as a security specific logon door. PCBoard does not currently have a similar feature for PPE's, so we had to figure out an acceptable way of installing it. We came up with installing FreeFile as a Logon Script as our best option, because this would run every time a caller logs on. However, the Logon Script is one of the few items in PCBoard that does not recognize Security Level specific versions i.e. configure PCBSETUP with C:\PCB\GEN\SCRIPT and create a script called SCRIPT11. What we did to get around this was to read Line 4 from FreeFile.cfg. Line 4 will only accept a * or a number. A * will cause FreeFile to run for all security levels on your BBS. A number will cause FreeFile to run for ONLY that security level. At this point, FreeFile will only accept one specific level on Line 4 of FreeFile.cfg. So, it's either have FreeFile run for one security level or all. Future versions of FreeFile will be able to configure multiple security levels on Line 4 of FreeFile.cfg.