ÛÛÛÛÛÛÛ¿ ÛÛÛÛÛÛÛÛ¿ ÛÛÛÛÛÛÛÛ¿ ÛÛÛÛÛÛÛ¿ ÛÛÛÛÛÛÛ¿ ÛÛÛÛÛÛÛÛ¿ ÛÛÚÄÄÛÛ³ ÀÛÛÚÄÄÛÛ³ ÀÛÛÚÄÄÛÛ³ ÛÛÚÄÄÛÛ³ ÛÛÚÄÄÄÄÙ ÀÛÛÚÄÄÛÛ³ ÛÛÛÛÛÛÛ³ ÛÛ³ ÛÛ³ ÛÛ³ ÛÛ³ ÛÛÛÛÛÛÛ³ ÛÛ³ ÛÛÛÛÛÛÛ³ ÛÛÚÄÄÛÛ³ ÛÛ³ ÛÛ³ ÛÛ³ ÛÛ³ ÛÛÚÄÄÄÄÙ ÛÛ³ ÛÛÚÄÄÛÛ³ ÛÛ³ ÛÛ³ ÛÛÛÛÛÛÛÛ³ ÛÛÛÛÛÛÛÛ³ ÛÛ³ ÛÛÛÛÛÛÛ¿ ÛÛÛÛÛÛÛÛ³ ÀÄÙ ÀÄÙ ÀÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÙ ÀÄÙ ÀÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÙ ADDPCB Version 2.0 December 1, 1992 For PCBoard Systems Copyright (C) 1992 by Bob Aune - All Rights Reserved. Latest Versions and Support Available at the OnLine Exchange BBS (714) 870-4614 2400-14,400 Baud V.32bis/HST Are you tired of typing in the descriptions every time you add files to your board? With this program, typing in descriptions by hand will be over. This time-saving program aids the PCB Sysop by importing files with their descriptions downloaded from other PCBoard BBS's to your PCBoard BBS automatically. Table of Contents ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ What is ADDPCB . . . . . . . . . . . . . . . . . . . . . . . . . 1 Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Possible Uses . . . . . . . . . . . . . . . . . . . . . . . . . 3 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . 4 Starting ADDPCB . . . . . . . . . . . . . . . . . . . . . . . . 4 Command Line Options . . . . . . . . . . . . . . . . . . . . . . 5 Operating ADDPCB . . . . . . . . . . . . . . . . . . . . . . . . 6 Configuration (Fields) . . . . . . . . . . . . . . . . . . . . . 6 Configuration (Options) . . . . . . . . . . . . . . . . . . . . 7 External Testing . . . . . . . . . . . . . . . . . . . . . . . . 8 FILE_ID.DIZ Support . . . . . . . . . . . . . . . . . . . . . . 8 Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Registration Information . . . . . . . . . . . . . . . . . . . .10 Legal Stuff . . . . . . . . . . . . . . . . . . . . . . . . . .11 ADDPCB User Documentation Page 1 ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ WHAT IS ADDPCB ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ADDPCB is a program that import files with their descriptions to your board painlessly. ADDPCB works off of 4 fields in the configuration as shown on the main screen. They are: / FILE - Containing descriptions (field 1) FROM \ DIRECTORY - Location of files to import (field 2) / FILE - Descriptions get added to (field 3) TO \ DIRECTORY - Location to import files (field 4) ADDPCB looks for files in the directory (field 2), it might be your download dir., misc. dir., or directory of files to be tested. Next it will search for the descriptions in a text file (field 1), The text file could be a 'allfiles' list or a capture file. If the description is found, then the program will optionally test the file by calling an external batch file and if the file passes the test, then will process the description and the file into your system. This program can be run from a batch file or on the command line. It's a ideal program to use after a download session as it will import the new files into your PCBoard system along with their descriptions. The automatic feature enables it to run in the unattended mode such as in events and with unattended communication programs. ADDPCB User Documentation Page 2 ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ FEATURES ÄÄÄÄÄÄÄÄ - Complete user interface with a built in configuration editor. - Several configuration files can exist for importing files to different conferences or directories. - Can test whole directories of files without moving their location or effecting the descriptions. - Can be used in your event, comm program batch file, or on the command line. - Imports description from any ZIP archive containg FILE_ID.DIZ. - Duplicate description and file detection with options. - Optional test each file as it is imported to your board. - Description Modification Options such as: - First letter capitalized. - All letters upper case. - All letters lower case. - Add 'Uploaded by (your name)' to the bottom of the description. - Option to re-date the the file and the date in the description to today's date. - Can be used under a network or multitasker. ADDPCB User Documentation Page 3 ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ POSSIBLE USES ÄÄÄÄÄÄÄÄÄÄÄÄÄ Import files from another PCBoard BBS to your BBS. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 1) Call your favorite BBS. ³ ³ 2) Turn your Communication program CAPTURE on. ³ ³ 3) Do a (Z)ippy search or search (N)ew files and the descriptions ³ ³ will be captured to the capture file. ³ ³ 4) Download the files. ³ ³ 5) Run ADDPCB. ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Files placed in a hold/misc. directory for missing descriptions. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 1) Download the ALLFILES list from a few boards. ³ ³ 2) Run ADDPCB. ³ ³ 3) Watch how many of the descriptions can be located. ³ ³ 4) If still have files without descriptions, then get another ³ ³ list and run ADDPCB again. ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Files on the board already but needs testing only. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 1) Use your board's file listing. ³ ³ 2) Change field 4 to the same as field 2. This will then not move ³ ³ the files. ³ ³ 3) Change field 3 to the same as field 1 and go into 'Options' and ³ ³ set to KEEP the original description and run ADDPCB. ³ ³ 4) Run ADDPCB. ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Files on the board already but you would rather have the description from FILE_ID.DIZ (if it exist). ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 1) Use your board's file listing. ³ ³ 2) Change field 4 to the same as field 2. This will then not move ³ ³ the files. ³ ³ 3) Change field 3 to the same as field 1 and go into 'Options' and ³ ³ set to OVERWRITE the original description and run ADDPCB. ³ ³ 4) Run ADDPCB. ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Files on the board already but you would like an easy way to convert the description to your likeing. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 1) Use your board's file listing. ³ ³ 2) Change field 4 to the same as field 2. This will then not move ³ ³ the files. ³ ³ 3) Change field 3 to the same as field 1 and go into 'Options' and ³ ³ set to OVERWRITE the original description and run ADDPCB. ³ ³ 4) Change one or more of the Description Modification Options. ³ ³ 5) Run ADDPCB. ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ADDPCB User Documentation Page 4 ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ INSTALLATION ÄÄÄÄÄÄÄÄÄÄÄÄ The installation is very easy. Put the file ADDPCB.EXE in a directory of your choice. Preferably your utility directory or a directory in your path. The configuration file will be created the first time you run the program. STARTING ADDPCB ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ- Type ADDPCB and the name of the configuration file you wish to use. If the configuration file does'nt exist, then one will be created. The name of the configuration file/s can be any name you choose. Examples: ADDPCB ADDPCB.CFG ADDPCB CONF0.CFG ADDPCB CONF1.CFG ADDPCB IMPORT.CN0 ADDPCB IMPORT.CN1 The configuration file is placed in the same directory that contains ADDPCB.EXE regardless of the directory you called the program from. If you do not wish to have the configuration file in the same directory, then you must specify the full path\name of the configuration file on the command line or in a batch file. EXAMPLE: ADDPCB C:\PCB\UTILS\ADDPCB.CFG ADDPCB User Documentation Page 5 ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ COMMAND LINE OPTIONS ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ADDPCB has 3 switches that can be used. These switches are optional. The command format and switch parameters are described below. A quick review of the command switches is available by typing ADDPCB by itself. Automatic mode /A or /a Used for unattended operation. The configuration file you specified must exist and the fields must be correct else the /A option will not function. Put ADDPCB CONFIG.CFG /A in your batch file and it will run without operator intervention. Registering your copy /R or /r Used for registering your copy of ADDPCB. Once it has been registered, you will receive a key number. Type ADDPCB /R and you will be prompted for your name and number. The program will brand your copy of ADDPCB.EXE. If you are registered and upgrading to a later version of ADDPCB, then you must use this switch using the same number. Monochrome mode on a color monitor /M or /m Not that you will ever want to use this feature, but it is there. Examples: ADDPCB IMPORT.CN0 /A ADDPCB IMPORT.CN1 /AM ADDPCB /R ADDPCB ADDPCB.CFG /RM ADDPCB CONF0.CFG ADDPCB CONF1.CFG ADDPCB User Documentation Page 6 ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ OPERATING ADDPCB ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The program is straight foward and should be self expanatory. Although I'm making every attempt to explain the program and its features. If you hav'nt already ran the program, now might be a good time to do so and get a feel for the program. At the bottom of the screen there are four selection items. They are 'Exit', 'Edit Fields', 'Options', and 'Start Process'. Before the 'Start Process' can be selected, all of the 'Fields' must contain valid path/names and the files or directory must exist (except the last one 'External Test' which is optional'). If any of the TO fields (fields 3 and 4) does'nt exist, then you will be be asked if you would the directory or file created for you. CONFIGURATION (FIELDS) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ NOTE: If a field is flashing, that is indicating that the path/name of the file or the directory is not valid or does not exist. DESCRIPTION FILE TO BE SEARCHED: C:\DL\ALLFILES.LST This is the path/name of the description file. It can be a ALLFILES list or a CAPTURE list or a DIRxx listing from your own board. DIRECTORY OF FILES TO BE PROCESSED: C:\DOWNLOAD This may be the directory that is holding your downloaded files or a directory holding misc. files without descriptions or a directory of files you want to test. DESCRIPTION FILE YOU WANT TO UPDATE: C:\PCB\MAIN\UPDIR This is the path/name of the destination file that new descriptions are written to. If the path\name of the file does not exist, then you will be asked if you want the file created for you. DIRECTORY WHERE THE FILES GET MOVED TO: C:\UPDIR This is the directory that the files gets moved into. If you do not wish to have the files moved, then enter the same directory as field 2 If the path\name of the directory does'nt exist then you will be asked if you want the directory created for you. EXTERNAL TEST PROGRAM: C:\PCB\UTIL\TEST.BAT Put in the path/name of the batch file calling your test program. If you don't want to test the files as they are imported, then leave this field blank. After the last field has been entered, then you will be taken back to the main choices. Press the or arrow key to select and press the key. ADDPCB User Documentation Page 7 ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ CONFIGURATION (OPTIONS) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ CAPITALIZE THE FIRST LETTER. Although most descriptions will have the first letter capitalize. There might be times when it is not and this feature will correct it. This feature can also be used if the description is in all upper case and you use the option to convert to all lower case and this option to capitalize the first letter. ALL LETERS UPPER CASE Convert the description imported to all upper case. ALL LETTERS LOWER CASE Convert the description imported to all lower case. UPLOADED BY: Choose (Y)es and you'll be prompted for your name or 'Sysop' then when the description is imported it will contain 'Uploaded by (your name)' on the last line of the description. SET FILE DATE TO TODAY'S DATE: Setting this option to (Y)es will change the file date to today's date and will change the date in the description to today's date. NOTE: These next 3 options work together and only one of them can be set to (Y)es at one time. PROMPT IF DUPLICATE IS DETECTED If this option is set to (Y)es and a duplicate description is found, then you will be asked if you want to keep the one thats already there or to use the new one or to keep both. If a duplicate file is found then you have the choice of keeping the one that's already there or to overwrite with the new one. If you have this option set to (Y)es and are running in the unattended mode, then any duplicate descriptions or files found will be kept and the new file will not be moved and will remain where it was before. DON'T PROMPT - OVERWRITE This option can be used in either the unattended or in the attended mode. If a duplicate description is detected, then the new description will be appended to bottom of the description file specified in field 3 and the description that was there before will be deleted. The new file will overwrite the one that was their before. DON'T PROMPT - KEEP This option can be used in either the unattended or in the attended mode. If a duplicate description is detected, then the original will stay and the new one will not be added. The original file will also stay and the new file will remain where it was before. ADDPCB User Documentation Page 8 ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ EXTERNAL TESTING ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ- If you chose to have ADDPCB test the files, then you must specify the name of your batch file in the field 'EXTERNAL TEST PROGRAM'. Your upload tester MUST be configured to move any failed files to a reject/offline/bad/hold directory. This will insure that ADDPCB will detect any failed files. If ADDPCB sees that a file failed, then all furture processing of that file will end and ADDPCB will move on to the next file. The description will not be added. If a file passed the testing, then the description and file will be processed in. FILE_ID.DIZ SUPPORT ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ- ADDPCB will detect any .ZIP archive containing the FILE_ID.DIZ file and will get the description from the FILE_ID.DIZ file to import. This feature depends on a copy of PKUNZIP.EXE being in the path. ADDPCB User Documentation Page 9 ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Support ÄÄÄÄÄÄ- Comments and suggestions about ADDPCB are welcomed. Please notify me if you discover a bug, so that it can be prompty corrected. OnLine Exchange at (714) 870-4614. <<< Home of ADDPCB I can alse be reached on: RIME - Sysops Conf. Bob Aune Ilink - Sysops Conf. " " Metrolink - PCBHints Conf. " " ADDPCB User Documentation Page 10 ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Registering ADDPCB ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This program is distributed as SHAREWARE. This enables users to eval- uate software for a 30 day trial period. If you find this program useful, please register it. Otherwise, if the user finds this program is not of sufficient merit to warrant purchase through registration then the program must be removed from their computer. This concept enables quality software to be distributed at a reason- able cost. I do greatly appreciate all users that care enough to reg- ister. I try to provide the best possible software for the supporting users. You may register ADDPCB by mailing in the enclosed REGISTER.FRM along with a check or money order in the amount of $10.00. Send registration to: Bob Aune 2404 E. Nutwood Ave. Fullerton, CA. 92631 The registration charge is a one time fee that entitles you to: * All future versions. * Unlimited technical support. * Access to the OnLine Exchange BBS. * Removal of the "Please Register" message. * A personalized number via US Mail and on the support BBS. This program may either be obtained from normal Shareware sources or from the OnLine Exchange BBS (714) 870-4614. ADDPCB User Documentation Page 11 ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Legal Stuff ÄÄÄÄÄÄÄÄÄÄÄ Disclaimer I hereby disclaim all warranties relating to this product, whether express or implied including without limitation any implied warranties of merchantability or fitness for a particular purpose. I cannot and will not be liable for any special, incidental, consequential,indirect or similar damages due to loss of data or any other reason. In no event shall the liability for any damages ever exceed the price paid for the license to use software, regardless of the form and/or extent of the claim. The user of this program bears all risk as to the quality and performance of the software. File Contents ------------- ADDPCB.DOC - The Document that you're reading now. ADDPCB.EXE - The Program. TEST.BAT - Sample BATCH file to call your favorite upload tester. FILE_ID.DIZ - Description of this program. Used by PCBoard for adding the authors version of the description to the board automatically. REGISTER.FRM - Mail-in registration form. This archive has been zipped using PKWARE authenticity verification system. If there are any files in this archive that do not have the verification tag beside them (-AV), it indicates that the archive has been tampered with and is not in the original form. If this is the case, please call the support BBS for a valid copy. Bob Aune The OnLine Exchange (714) 870-4614 2400-14,400 Baud V.32bis/HST