--------------------------- FILE DOWNLOAD COUNTER --------------------------- Version 5.00 June 13, 1995 Written by: Brandon M. Bachman Available on the World Wide Web: http://www.cc.utah.edu:80/~bmb4764 or bbachman@eng.utah.edu Copyright (c) 1990-95 by Brandon M. Bachman -------------------- TABLE OF CONTENTS -------------------------------------------------------------------------- ----------- General ----------- Overview ..................................... 1-1 Program Features ............................. 1-2 Registrered and Unregistered Versions ........ 1-3 Why Should I Register? ....................... 1-4 Disclaimer ................................... 1-5 License ...................................... 1-6 System Requirements .......................... 1-7 Files in the FDC Archive ..................... 1-8 -------- How? -------- How FDC Operates ............................. 2-1 Installation ................................. 2-2 A Configuration File ......................... 2-3 Starting New with FDC ........................ 2-4 Removing FDC Entries ......................... 2-5 Log File ..................................... 2-6 Word Wrapping ................................ 2-7 Formats For Recording Download Count ......... 2-8 ----------------- Configuration ----------------- The Configuration File ....................... 4-1 Sample Configuration File .................... 4-2 -------- Why? -------- Operational Details .......................... 5-1 Examples of Command Line Arguments ........... 5-2 Common Questions and Answers ................. 5-3 --------- What? --------- Technical Support ............................ 6-1 ------------ OVERVIEW 1-1 -------------------------------------------------------------------------- FDC will edit the descriptions in PCBoard's DIR files with the number of times the file has been downloaded from your BBS. FDC makes it easy for you and your users to see instantly which files are the most popular, and give you an idea of what software you should keep online or download and which programs are "dead wood" to be removed. PROGRAM FEATURES 1-2 -------------------------------------------------------------------------- þ Automatically finds new downloads since the last date FDC was run. þ Process any size DOWNLOAD.TXT files. (extremely large) þ Counts as many as 2 billion downloads of a single file. þ Auto word wraps the description lines to *any* column you would like leaving the "Uploaded by:" line undisturbed with word wrapping. þ Log file to monitor the program, compatible with PCBoards log file. þ Designed to run in your nightly event. þ Popular with users and SysOps as a guide to good programs. þ Creates a database of all files not found to retry on future runs, therefore making the download count 100% accurate. þ Written in Borland C++ v4.0 for fast compact code. REGISTERED AND UNREGISTERED VERSIONS 1-3 -------------------------------------------------------------------------- "File Download Counter" is not Public Domain or Free ware. Unregistered versions are 21 day evaluation copies only, after which they should either be destroyed or a license agreement purchased. Registration is only $25 so please register your copy today. Read 'REGISTER.DOC' included with this archive for more information. Unregistered versions will ONLY count 25 downloads per file. After FDC is registered it will count 2 billion downloads per file. Check the LOG file to see if you have exceeded the 25 download count limit. WHY SHOULD I REGISTER? 1-4 -------------------------------------------------------------------------- þ Unregistered versions only count up to 25 downloads in the DIR files Registered versions will continue to count as high as 2 million. þ Free technical support via the Salt City BBS. þ Lifetime free updates of all future versions guaranteed. þ Help support future updates and development of FDC. þ Support the shareware concept. DISCLAIMER 1-5 -------------------------------------------------------------------------- The authors make no warranties or representation of any kind, expressed or implied, with respect to "File Download Counter", or its quality, reliability, or performance, or its merchantability or fitness for any purpose. The user assumes the entire risk as to the quality, performance and reliability of the software and documentation. LICENSE 1-6 -------------------------------------------------------------------------- The "File Download Counter" ("The Software") is COPYRIGHT 1990-94 by Brandon M. Bachman, ALL RIGHTS RESERVED WORLDWIDE. A license grants you a nonexclusive, nontransferable license to use "File Download Counter" software on a single central processing unit at any one time. You may NOT engage in, nor permit third parties to engage in, any of the following : A) Sell, rent, sub-license, lease, or grant other rights of this software to others. B) Attempt to disassemble, decompile, or reverse engineer the software or the files it generates in any way. C) Make alterations of any kind in the files of this software, except as noted below. D) Collect fees for distribution of the software. The authors of the software grant you a license to use this software as long as you meet the above conditions. Any violation of the above conditions will result in the termination of your license to use this software. Upon termination of this license for any reason, you must stop using the software and destroy all copies of it in your possession immediately. The author(s) of this software are not liable for damages suffered as a result of the improper use, proper use, or inability to use this software. This type of disclaimer is prohibited by law in some states, and is therefore void in those states. SYSTEM REQUIREMENTS 1-7 -------------------------------------------------------------------------- To run "File Download Counter" you will need the following: 1. IBM PC/XT/AT, PS/2 or 100% compatible machine. 2. Color or Monochrome Graphics adapter. 3. MS-DOS 5.0 or higher. 4. PCBoard BBS Software. FILES IN THIS ARCHIVE 1-8 -------------------------------------------------------------------------- "File Download Counter" is distributed as a archival file "FDC-XXX.ZIP" You must have PkZip v2.04g or later to extract the files listed below. PkZip v2.04g is Shareware and is available on many computer bulletin boards. Files in the archive include: FDC.EXE - The "File Download Counter" program. SAMPLE.CFG - Sample configuration file. FDC-500.DOC - This documentation file. REGISTER.DOC - Information on registering your copy. README.DOC - Important information for new and old users. COMMENTS.DOC - List of comments from other users of FDC. Sysops are free to distribute uregistered versions of FDC as a complete unaltered archive only. HOW FDC OPERATES 2-1 -------------------------------------------------------------------------- FDC will read the DOWNLOAD.TXT file created by PCBoard, and count all recently downloaded files since the last time File Download Counter was executed successfully. It then searches your PCBoard DIR files for a match. Upon finding a match in your PCBoard DIR files FDC inserts the number of times the file has been downloaded with the file description in your PCBoard DIR file. There are 3 styles of editing your PCBoard DIR files that FDC supports. They are outlined below with samples of each style. You may choose the style you would like FDC to use by changing the STYLE= parameter in the configuration file. Sample of Style #1 and #2 ------------------------- FILENAME.ARC 35252 06-27-90 <23> This is the description of the file. FILE-TWO.ZIP 213445 06-23-88 <11> This is another description. NEXTFILE.ZIP 243536 06-21-90 <14> This one has been downloaded 14 times, | and the description is auto word-wrapped. FILEFOUR.LZH 246246 05-12-90 <13> File Four v3.3, description. With | this entry word wrapped, the "Uploaded by:" | line is not disturbed. | Uploaded by: Brandon Bachman The only difference between Style #1 & #2 is that Style #2 will truncate the first line of the description after it inserts <##>. Style #1 will word wrap long descriptions to the next line. Sample of Style #3 ------------------ FILENAME.ARC 35252 06-27-90 This is the description of the file. | Downloaded 23 times. FILE-TWO.ZIP 213445 06-23-88 This is another description. | Downloaded 12 times. NEXTFILE.ZIP 243536 06-21-90 This one has been downloaded 14 times, | and the description is auto word wrapped. | Downloaded 1234 times. FILEFOUR.LZH 246246 05-12-90 File Four v3.3, description. With | this entry word wrapped, the "Uploaded by:" | Uploaded by: Brandon M. Bachman | Downloaded 233 times. Style #3 inserts an additional line to each file description. You can customize this line by editing the TEXT= option in the configuration file. INSTALLATION 2-2 -------------------------------------------------------------------------- To install "File Download Counter" you must have the PKZip program available, then create a sub-directory for "File Download Counter" on your hard disk. Enter the sub-directory and un-Zip the files. Here is an example of how you might do this: E: (Go to E: drive) CD\ (Go to the root directory) MD FDC (Create E:\FDC sub-directory) CD FDC (Go into the E:\FDC sub-directory) COPY A:\FDC-460.ZIP (Copy the program from drive A:) PKUNZIP FDC-460.ZIP (UnZip the program into the directory) CONFIGURATION FILE 2-3 -------------------------------------------------------------------------- After you complete the installation you must then edit the FDC.CFG file included in this archive to your needs. Read the "Sample Configuration File" and "Operational Details" sections below for instructions. STARTING THE DOWNLOAD COUNT 2-4 -------------------------------------------------------------------------- First time users should initialize FDC by making sure the LAST_RUN_DATE= configuration option is a date in history older than first download from your BBS. In others if your BBS has been online for 10 years make sure the LAST_RUN_DATE is set back to at least 1984 the first time you run FDC. This ensures that downloads prior to the current date are counted the first time. STRIPPING FDC ENTRIES FROM PCBOARD DIR FILES 2-5 -------------------------------------------------------------------------- If you would like to remove all entries made by FDC in your PCBoard DIR files you may do so by using the /STRIP command line argument. At DOS this command would be "FDC /STRIP" This is useful if you decide to switch from one style of editing your DIR files to another. (ie., STYLE=1 and you would like STYLE=3). Note: Once you have STRIPed entries made by FDC from your PCBoard DIR files you will want to reset the LAST_RUN_DATE= in your configuration file to be a date earlier than the first download from your BBS. See section 2-4 above for more information. LOG FILE 2-6 -------------------------------------------------------------------------- To create a log file of all FDC's activities use the argument LOG= in your configuration file. This is the complete path and file name of the LOG file. The format of the LOG file is compatible with PCBoard CALLER log. This way you can specify the LOG file as the CALLER log created by PCBoard. Doing so will help cut down on many logs files clogging up your systems. WORD WRAPPING 2-7 -------------------------------------------------------------------------- Word Wrapping only applies if you have STYLE=1 or STYLE=2 in your configuration file. (Word Wrapping is not an option on STYLE=3). FDC handles word wrapping in two ways. If a file description requires word wrapping, FDC first searches for the "|" character in the secondary line of your file description, and when found will word wrap to the space following the "|" character. However some sysops like to have all their secondary lines of the descriptions lined up on columns other than the default of the 32nd column by PCBoard. You can change the default by using the argument CHAR=xx, where xx is the column or number of characters to word wrap to. FDC will not edit the "Uploaded by:" line when word wrapping. THREE FORMATS FOR RECORDING DOWNLOAD COUNT 2-8 -------------------------------------------------------------------------- FDC supports three different formats for recording the number of times a file has been downloaded. The first is the default which will put <##> in the first few characters of the first line of the files description in the DIR file. The second will do the same as the first, however it will not word wrap but truncate all descriptions which exceed 79 characters. The third will insert a separate line at the end of the secondary lines of the description but before the "Uploaded by:" This line will look like this: "| Downloaded 45 times." If you perfer a differnet wording you may change the format to anyway you would like to editing the TEXT= parameter in the .CFG file. By default FDC will insert this line starting at the 32nd column, however if you would like it to be inserted at another column simply use the CHAR=xx option specified section 2.9. To implement one of the various format of recording the number of times downloaded use the STYLE=x option, where x is the number of the style you would like. For samples of the 3 different styles please see section 2-1 above. CONFIGURATION FILE 4-1 -------------------------------------------------------------------------- FDC daily operations are determined by the way you setup the FDC.CFG file. The configuration file must be called 'FDC.CFG' and be in the directory from which you run FDC.EXE. It is critical that you take care in setting up this file, instructions for doing so are found in the "Sample Configuration File" section below and the above sections. If you wish to have mulitple configuration files you may use the /CFG= command line argument. If you wanted to use the configuration file FDC-01.CFG you would execute FDC with the command line "FDC /CFG=FDC-01" FDC will automatically apend the .CFG, .P and .T to the file names for the configuration file and data files. SAMPLE CONFIGURATION FILE 4-2 -------------------------------------------------------------------------- Please refer to the SAMPLE.CFG file for a sample confgiuration file. You may use any standard ASCII text editor to edit the SAMPLE.CFG file found in this archive, or to create your own. Change the data in the SAMPLE.CFG to your needs and then rename SAMPLE.CFG to FDC.CFG OPERATIONAL DETAILS 5-1 -------------------------------------------------------------------------- After you have your FDC.CFG edited to your needs then type "FDC" and watch the wiz-bangs fly! FDC will let you know if your FDC.CFG file may have errors. NOTE: If it is the first time you have run FDC see "Starting the Download Count" above (section 2-4) for more information. To update your recent downloads every day, put FDC in your EVENT.SYS file. FDC is designed to run in your nightly event. If there is an error, FDC will sound a beep, record the error in the LOG= file, pause 10 seconds and then exit. EXAMPLES OF COMMAND LINE ARGUMENTS TO RUN FDC, AND THE RESULTS 5-2 -------------------------------------------------------------------------- 1. FDC This runs FDC using settings in the FDC.CFG file. This is the most common way to run FDC. 3. FDC /STRIP This will run FDC and have it strip out all entries in your DIR files that FDC made. This is useful if you need to start the the count over for FDC. 4. FDC /CFG=FDC-02 This will run FDC using the FDC-02.CFG, and FDC-02.T filenames for the configuration file, and the data files respectfully. COMMON QUESTIONS & ANSWERS 5-3 -------------------------------------------------------------------------- Q. I am a new user with File Download Counter and I it is not counting any downloads from the PCBoard DOWNLOAD.TXT file. A. Make sure when you first run FDC to set the LAST_RUN_DATE= in the configuration file. See secction 2-4 "Starting a New Count" above. Q. When I register FDC will I need to call your BBS to obtain future registered updates, and will there be a fee for upgrading. A. FDC is self registering for all future versions, you can simply download a copy from a distributor BBS. There is and never will be and additional fee for upgrading FDC even if prices do increase, once you have are a registered user you may upgrade for free. Q. FDC gives me the error "Can not find PCBDAT= enviroment setting." how do I fixe this problem? A. Add the following statement to your AUTOEXEC.BAT file and then reboot your computer: SET PCBDAT=C:\PCB\PCBOARD.DAT Note if you have a different path to your PCBOARD.DAT you should make changes to the above statement accordingly. TECHNICAL SUPPORT 6-1 -------------------------------------------------------------------------- The latest version of "File Download Counter" software and technical support are available on: the World Wide Web http://www.c.utah.edu:80/~bmb4764 Or write to: Brandon M. Bachman 270 E. 5th Ave. #7 Salt Lake City, Utah 84103 Or InterNet: bbachman@eng.utah.edu