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

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

COPYING FILES

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

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

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 System
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 System 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  - Reserved for Later Versions

Line 5  - Custom color configuration. All of the colors on the screen,
including text, borders and file names can be configured to any color. This
single line lists the codes for every item's color. Follow the table below to
adjust the correct entries if you wish to change from the default colors.
Also see the file @X-CODES.TXT for how to set up the colors you want.

          Position      Description                                   Default
          Column 1-4    File Name Color                               @X0A
          Column 6-9    File Description Color                        @X0E
          Column 11-14  File Numbering Color                          @X0F
          Column 16-19  Main Screen Border Color                      @X02
          Column 21-24  Error Screen Border Color                     @X02
          Column 26-29  Transfer Begin Screen Border Color            @X02
          Column 31-34  Transfer Complete Screen Border Color         @X02
          Column 36-39  Don't D/L Flagged Files Screen Border Color   @X02 
          Column 41-44  Error Screen Title                            @X0C
          Column 46-49  Transfer Begin Screen Title                   @X0C
          Column 51-54  Transfer Complete Screen Title                @X0C
          Column 56-59  Don't D/L Flagged Files Screen Title          @X0C
          Column 61-64  Error Screen Main Text                        @X0E
          Column 66-69  Transfer Begin Screen Main Text               @X0E
          Column 71-74  Transfer Complete Screen Main Text            @X0E
          Column 76-79  Don't D/L Flagged Files Screen Main Text      @X0E
          Column 81-84  Error Screen Selection Examples               @X0F
          Column 86-89  Error Screen Selection Example Descriptions   @X0E
                                                                    
Lines 6-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 Online, 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.20. 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 - Log on to your system
16 - Type FREEFILE then ENTER at the Main Command prompt
17 - FreeFile will start


SETTING UP FREEFILE AS A SECURITY SPECIFIC COMMAND FILE

This section should be used if you only want to run on login FreeFile for
certain security levels. If you wish FreeFile to run on login for all callers,
skip to the next section, Setting Up FreeFile as a System Login Script.

PCBoard 15.2x allows you to set up security specific command files. If you have
a security level of 20 for some of your callers and place a file called 20. in
your GEN directory, PCBoard will execute whatever commands are in the file when
a level 20 caller logs in. If your 20. file has the following two lines in it

%C:\PCB\TEXT\123.TXT
!C:\PCB\PPL\XYZ.PPE

PCBoard will display the 123.TXT file then run the XYZ.PPE. If you have a
security level of 20 configured on your system and want FreeFile to run for
these callers create a file called 20. in your GEN directory. Add the following
line to it:

!C:\PCB\PPL\FREEFILE.PPE

Change the drive letter and directory to suit your system configuration. If you
also want FreeFile to run for levels 25 and 30, simply copy 20. to 25. and 30.
The line above must be inserted in a security specific command file for each
level you wish FreeFile to automatically run for.

To assure proper installation in the security specific command file:

1  - Create a security specific command file for your Sysop security level.
     On Best Buy Online, we created a file called 110. in the GEN directory
     with the line "!C:\PCB\PPL\FREEFILE.PPE" in it for testing.
2  - Log on to your system using User - Busy on the Call Waiting Screen
     Note: If you use Sysop - Busy to log in, FreeFile will be bypassed
3  - Enter your name and password as if you were dialing in
4  - FreeFile will start immediately after entering your password
5  - Delete the line "!C:\PCB\PPL\FREEFILE.PPE" from your Sysop security
     specific command file.


SETTING UP FREEFILE AS A SYSTEM LOGIN SCRIPT

If you wish FreeFile to run automatically on login for all security levels, it
should be set up as a System Login Script. Note: If you set up FreeFile as a
System Login Script and with security specific command files (above), the
program will run twice! Use the following steps to set up FreeFile as system
login 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  - Log on to your system using User - Busy on the Call Waiting Screen
     Note: If you use Sysop - Busy to log in, FreeFile will be bypassed
10 - Enter your name and password as if you were dialing in
11 - FreeFile will start immediately after entering your password
