INSTALL.TXT
-------------

=============================================================================
This document describes in detail how to install FreeFile v1.00
=============================================================================

COPYING FILES

Although there are several documentation files that come with FreeFile v1.00,
you must copy the following files into your PPL directory:

FREEFILE.PPE - The PCBoard Programming Executable
FREEFILE.CFG - The Configuration File for FreeFile v1.00

The directory for the PPL programs your run on your system is usually
C:\PCB\PPL\


SETTING UP FREEFILE.CFG

A sample freefile.cfg configuration file is included in this archive.

Line 1  - Your Registration Number
With a legitimate registration number you will be able to put your BBS name
on the main screen of the program and customize the banner. These are
defined on lines 2 and 3. Without a legitimate registration number, these
two lines will be ignored.

Line 2  - Your BBS Name & Number. Registered Version Only.
The default for Line 2 is "(Unregistered)". If you change this and do not
have a legitimate registration number, it will be ignored. When registered,
this line supports @X Color Codes.

Line 3  - Custom Program Title. Registered Version Only.
The default for Line 3 is "Free Files Available On This System". If you
change this and do not have a legitimate registration number, it will be
ignored. When registered,this line supports @X Color Codes.

Line 4  - Security level that FreeFile will run for.
The default for Line 4 is "*". On Best Buy BBS, we only want FreeFile to run
for callers who are not paying members. On our system, they are level 11 and
we have "11" here. If you wish FreeFile to run for all callers, leave the
default of "*".

Lines 5-15 - Reserved for Later Versions

Line 16 - Directory Free Files are located in.
The default value for line 16 is "C:\PCB\FreeFile\". On Best Buy BBS, we
have about 30 files in our Free directory. We have configured FreeFile with
the 10 that we most want non-paying callers to download. These may be a
subset of your Free directory. If this is the case, just enter the path to
your Free directory. If you wish to have a special set of files available to
your non-paying callers, create a new directory, add it to your download
path and populate it with up to ten files. Make sure there is a \ at the end
of the file location path!

Line 17 - The number of files set up in FreeFile.
The default value for line 17 is 10. This is also the maximum value accepted
by FreeFile v1.00. If 0 or a number greater than 10 is entered, FreeFile
will not run.

Lines 18-27 - Position 1-12 - The exact names of your Free Files in the order
you wish for them to be displayed.

Lines 18-27 - Position 14-63 - The description you wish to display for your
Free Files.


SETTING UP FREEFILE IN THE CMD.LST

Putting FreeFile in the CMD.LST will allow FreeFile to be run from the Main
Command prompt on your system. To set this part up, do the following steps:

1  - Start PCBSetup
2  - Select B for File Locations
3  - Select B for Configuration Files
4  - Scroll down to Name/Loc of Default CMD.LST File
     The default location and filename are C:\PCB\GEN\CMD.LST
5  - With the entry highlighted, press F2 to edit the CMD.LST file
6  - In the Command column enter FREEFILE
7  - In the Sec column enter 0
8  - In the Charges per Minute column enter 0
9  - In the Charges Per Use column enter 0
10 - In the PPE/MNU File Specification column enter C:\PCB\PPL\FREEFILE.PPE
     If you locate your PPEs elsewhere, substitute the appropriate path.
     Note: Unlike putting PPEs in the PCBTEXT file or attached to display
           files, you do NOT need a ! before C:\PCB\PPL\FREEFILE.PPE
11 - Press ESC
12 - When prompted, press ENTER to accept the default Yes for saving changes
13 - Exit PCBSetup

To assure proper installation in the CMD.LST file do the following steps:

14 - Assuming you are a sysop reading this, set Line 4 of FreeFile.cfg to * or
     whatever your sysop security level is
15 - Log on to your BBS
16 - Type FREEFILE then ENTER at the Main Command prompt
17 - FreeFile will start
18 - Reset Line 4 of FreeFile.cfg to either * for all or the secutiry level
     you wish FreeFile to run for


SETTING UP FREEFILE AS A SYSTEM LOGON SCRIPT

1  - Start PCBSetup
2  - Select B for File Locations
3  - Select D for New User/Logon/off Questionnaires
4  - Scroll down to Name/Loc of Logon Script Quest.
5  - Enter !C:\PCB\PPL\FREEFILE.PPE
     If you locate your PPEs elsewhere, substitute the appropriate path.
     Note: You MUST have a ! before C:\PCB\PPL\FREEFILE.PPE
6  - Press ESC twice to return to the PCBSetup Main Menu
7  - Press ESC to exit PCBSetup
8  - When prompted, press ENTER to accept the default Yes for saving changes

To assure proper installation in the CMD.LST file do the following steps:

9  - Assuming you are a sysop reading this, set Line 4 of FreeFile.cfg to * or
     whatever your sysop security level is
10 - Log on to your BBS using User - Busy on the Call Waiting Screen
     Note: If you use Sysop - Busy to log in, FreeFile will be bypassed
11 - Enter your name and password as if you were dialing in
12 - FreeFile will start immediately after entering your password
13 - Reset Line 4 of FreeFile.cfg to either * for all or the secutiry level
     you wish FreeFile to run for
