旼컴컴컴컴컴� 旼컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 旼컴컴컴컴컴� � 旼컴컴컴� � � WESTFIELD DATALINE, Westfield NJ 908-654-3178 � � 旼컴컴컴� � � � 旼컴� � � 읕컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� � � 旼컴� � � � � � � � � FILE DIRECTORY HEADER Ver8.0 by Vince Rifici � � � � � � � � 읕컴� � � 旼컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� � � 읕컴� � � � 읕컴컴컴� � � Files 395 K-Bytes 3,891 Updated 06-15-1995 � � 읕컴컴컴� � 읕컴컴컴컴컴� 읕컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 읕컴컴컴컴컴� - 1 - (For PCBoard Ver 14.5a and higher) This program will add an attractive looking headpiece to your file directories, and will keep track of the number of files and total kilobytes in each file directory, and the date when when the files in the directory were last updated. Version 8.0 offers a brand new design for the header, in keeping with the raised metallic plate design which became popular when PCBoard version 15.0 was introduced. It has become very popular for screen designs, and is a "standard of quality" on many large super-BB's. I have programmed seven different color combinations which can be selected by specifing the color on the last line of the FDH.CFG file. I have also increased the total number of file directories from 250 to 500, and the total number of files in each directory from 999 to 9,999. EXECUTE THE FILE "SAMPLE1.EXE" TO SEE HOW THE FINISHED PRODUCT WILL LOOK ON YOUR BOARD. Files contained in this archive are: FDH80.EXE <------------- Main evaluation program FDH.CFG <------------- Sample configuration file FDH80.DOC <------------- Documentation file FDH.HST <------------- Revision history SAMPLE*.EXE <------------- Sample screen captures DIR51 <------------- Sample directory file FILE_ID.DIZ <------------- Archive description The program was run and tested on only one PC (my own). It is an AT&T 386/dx running at 20mhz with 8 Megs of RAM memory with two PCBoard nodes using DesQview. DOS6.2 is installed as the operating system. It was written in GWBASIC and was compiled using MicroSoft's QuickBASIC Compiler Version 4.0. It takes approximately 40 seconds to run to completion on my BBS, which contains 51 directories and over 5,000 Files. It works flawlessly on my machine, but I cannot be responsible for any problems you may have with it running on your machine. Please be cautious! Make backups of your file directories before using it the first time! - 2 - The limitations of the program are as follows: Maximum number of file directories = 500 Maximum number of files per directory = 9,999 Maximum number of K-Bytes per directory = 99,999 Minimum amount of free RAM needed to run = 64k Commas CANNOT be used in the directory titles This version of FDH was designed for PCBoard 15.xx. All nodes should be down when this program is run. Ideally it is run in the daily event, but can be run directly from the DIR sub- Directory if desired. This program utilizes the PCBoard "@X" color codes to display both color and monochrome with PCBoard Version 14.5x and above. Before running the program the following conditions MUST be met: 1. FDH80.EXE and FDH.CFG must be located in the same sub-directory. They can be located anywhere on your disk (even on a different drive than your PCB files). 2. All your file directories must be named DIRx, and must be located in the same sub-directory (usually \PCB\GEN\). Example: DIR1, DIR2, ..., DIR250 - not - DIR01, DIR02, ..., DIR250 (see exception on page 5) 3. You will have to create your own FDH.CFG file, or edit the sample .CFG file included in the archive. The filename must remain FDH.CFG (it is hardcoded in the executable). 4. The clock on your PC must be correct. The date shown in the header is generated internally. - 3 - CREATING THE FDH.CFG FILE Use any pure ASCII text editor to create the FDH.CFG file. The size of this file will vary depending on the number of file directories you have. If your board's directory structure ever changes, you can re-edit the .CFG file and the program will still work. All configurable items are contained in this file. The FIRST LINE is simply the number of DIRx file directories for which you are configuring headers. The SUBSEQUENT LINES contain the titles of all your DIRx file directories. Use one title per line, in sequential order. Titles should not exceed 30 characters. End all lines with a simple carriage return & line feed. The NEXT THREE LINES are as follows: The complete path of your DIRx files (path only, no filename. Place "\" at end of path) The name of your BBS (or anything else you may want) (this line should be no longer than 20 characters) Your location and telephone number (or anything you like) (this line should be no longer than 26 characters) The LAST LINE is the color combination of the file directory header. There are seven to choose from. Use ONLY the following color names: BLUE, GREEN, CYAN, RED, MAGENTA, BROWN & SILVER. (Color names may be entered in upper or lower case). * IMPORTANT: DO NOT USE COMMAS ANYWHERE IN THE FDH.CFG FILE! THE NUMBER OF DIRECTORY TITLES MUST BE EQUAL TO THE NUMBER SHOWN ON THE FIRST LINE IN FDH.CFG! - 4 - Here is a sample illustration of a FDH.CFG file containing five file directories: 5 <------- No. of DIRs (Max 500) DOS Utilities & Shells <------- Directory Names Communication Programs (Max 30 characters) File Transfer Protocols " BBS System Software " Sysop & User Utilities " E:\PCB\GEN\ <---- Path to DIR files WESTFIELD DATALINE <---- Max 20 characters Westfield, NJ 908-654-3178 <---- Max 26 characters Silver <---- Use only colors shown on page 3 All lines are ended with a simple carriage return & line feed. Do not use any blank spaces before or after the information on any line. PREPARING YOUR FILE DIRECTORIES Each of your DIRx file directories should contain only one header line. This is the PCB 14.5a statement which calls up the header file when it's displayed on the board. Place the following statement on the first line in each of your DIRx directories: %E:\PCB\GEN\DIRx.HED <--- use the same path as your DIRx files (you MUST use .HED for the extension) This line begins with a percent (%) sign and contains the path and file name of the header files. The header files are automatically created when the program FDH71.EXE is executed. The files are named DIRx.HED and are created in the same directory as your DIRx files. See DIR51 for a "cropped" sample of my directory #51. - 5- VERSITILITY OF THE PROGRAM The preceding set-up for configuring the .CFG file applies to all conferences which use the same DIRx files. Sometimes a conference may use different DIRx files. In this case, you would configure a separate FDH.CFG tailored specifically for that conference. Be sure to specify the correct path to the directory which contains the different conference DIRx files. Let's suppose your Sysops Conference directories are named "SDIRx" instead of "DIRx". When you specify the path of the "SDIRx" files in the .CFG file, just enter, for instance: E:\PCB\SYSOPS\S instead of, E:\PCB\GEN\ If you include the first letter of the "SDIRx" files in the path, it will then find all the Directories which begin with "S", and will create all the header files with the name of "SDIRx.HED" instead of "DIRx.HED". Simple, huh! NOTE: If your public upload directory is named "UP or UPLOAD", sorry, you are out-of-luck! Either change the name of your upload directory, or be satisfied that no header will be created for it. Don't forget to change the calling statement on the first line of your Sysops directories to: %E:\PCB\SYSOPS\SDIRx.HED (or whatever path applies). FDH is idealy suited to be run in your EVENT.SYS as a daily event. Shown below are the statements which will allow you to run one or more copies of FDH in your event: E: <---- drive specifier CD\PCB\GEN <---- cd to dir containing FDH80.EXE & FDH.CFG FDH80.EXE <---- the .EXE program CD\PCB\ADULTS FDH80.EXE CD\PCB\SYSOPS FDH80.EXE - 6 - GET READY TO "GO" After you have built your FDH.CFG file, and configured all your DIRx files to add the header calling statement, you are ready to run FDH80.EXE. Please take my advice and backup all your DIRx files before running this program for the first time. It really should not do any damage to the DIRx files, even if you make mistakes in building the .CFG file. The program merely opens the DIRx's to count the files and the bytes and does not modify them in any way. If you do "mess up", just correct the errors in the .CFG file and run the program again. Each time the program is run, it overwrites the old .HED files and builds completely new ones. UPGRADING FROM PREVIOUS VERSIONS If you are upgrading from version 7.x, make the following changes: 1. Replace the file FDH7x.EXE with FDH80.EXE. 3. Delete the PCB color codes on the last 5 lines of your present FDH.CFG and replace it with one of the single colors shown on page 3. - 7 - TROUBLE SHOOTING The first place to look for possible trouble is in the FDH.CFG file. 1. Count your directory titles and make sure it is equal to the number specified on the first line. 2. Make sure you have NOT used commas (or colons) in any of the directory titles. 3. Make sure you have NOT placed any leading or trailing spaces on any of the lines. 4. Examine the ASCII editor you used to build or edit the FDH.CFG file. It must be a pure DOS ASCII editor such as QEdit or the built in DOS6.0 text editor. Every line must end with a simple carrage return and line feed. 5. Make sure the path to your DIR files ends with a "\". (An exception to this is shown on Page 5, paragraph 2) - 8 - The latest copy of FDH is always available on: WESTFIELD DATALINE Westfield, NJ (908) 654-3178 Data & Fax (908) 654-6304 Data & Fax Registration for this program is $15.00. Registration eliminates the flashing "EVALUATION COPY" which appears on the line below the header. Please send your name and address, and a check or money order to: Vincent C. Rifici 433 Mountain Avenue Westfield, NJ 07090-3033 Upon receipt of your payment, I will immediately post a private message to you on my BBS (Westfield DataLine) and attach the registered copy of the .EXE file which you can download and replace with your shareware version. You will not have to re-configure your setup. Mearly replace FDH80.EXE with the new FDH80R.EXE. Please inform me of your exact logon name when you send your registration fee. This is important so you can retrieve your private message with the file attachment. Registration does not entitle you to free upgrades since this program is generally a lifetime product and will not change unless you grow tired of it and simply can't stand the look of it anymore. I've been running it, in one form or another for more than 5 years now... Enjoy good health, and good luck.... Regards, Vince Rifici.