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