AutoAdd V1.10 Copyright (C) 1995 David Blagburn All rights reserved What is AutoAdd? Well, AutoAdd is a bridge between Allfix and PCBoard. Allfix allows automatic additions of new file areas but has no way to let PCBoard (and consequently, your users) about the new file area. This is where AutoAdd comes in. AutoAdd will: * Detect auto-added areas * Add the new areas to the DIR.LST and DLPATH.LST of a specified PCBoard conference * Optionally copy the new DIR file to a specified directory * Update Allfix (when registered) so that it will reconize the new addition to PCBoard, eliminating the need to run FCOMP * Update Allfix (when registered) with the description pulled from FILEBONE.NA or FILEBONE.NO, eliminating the need to run FIXUTIL Describe * Optionally (when registered) append the new file path to an alternate file (instead of DLPATH.LST) for use with MAKEIDX * Exit with a errorlevel of 1 (when registered) if any file areas were added. Good for the above option *********** NOTICE: REQUIRES ALLFIX 4.32 G5 OR LATER ************ SETUP ----- Put AUTOADD.EXE just about anywhere you want to, as long as you can call it from a batch file. I put it in my PCB directory. Autoadd requires certain switches and flags in Allfix to be setup up in a compatible manner. If you can not or are unwilling to make these changes, then AutoAdd is not for you. Asetup switches that must be set: In Asetup | Group Manager All groups (that you expect to have areas added to) must have Unique set to Yes. If not, MAJOR problems! AutoAdd is designed to be run from a batch file, but can be run anytime. The call is: AUTOADD /A: /C: /N:# /D: /F: /L: /I: (The above should all be on one line. It was split for readability) where: /A: is the path to your Allfix directory. This is the only required parameter. Ex. /L:D:\ALLFIX\ /C: is the path you entered in PCBSetup | Files Locations | System Files & Directories | Name/Loc of Conference Data. If you used relative addressing, you must enter a full path. The /N parameter is required if you use this option. If both the /N and /C parameters are used, AutoAdd will fully update Allfix, so you will not have to run FCOMP. Ex. /C:D:\PCB\MAIN\CNAMES /N:0 (updating of Allfix is a registered feature) /N:# is the number of the conference in which the DIR.LST and DLPATH.LST will be updated. 0 = Main board, 1 = Conference 1, etc. If you do not want DIR.LST or DLPATH.LST to be updated, leave this option off or set it to -1. Ex. /C:D:\PCB\MAIN\CNAMES /N:0 /D: is where you would like the new DIR file to be created. AutoAdd will create a file in this directory with the auto-added file area's tag as a filename, put the standard PCB header in (Filename, Date, Size, Description with "==" underscores), and then copy the FILES.BBS created by Allfix into the newly created file (You do have Use FDB set to Yes in Asetup, don't you?). If the /C and /N options are used, Allfix will refect this path. If this option is not used, the new DIR will still be created, only in the same location as FILES.BBS. Ex. /D:D:\PCB\GEN\LISTS\ (updating of Allfix is a registered feature) /F: is the path to where you have a copy of FILEBONE.NA stored. Using this option will automatically enter the file area description in DIR.LST and update the Comment field in Allfix. If you use this option, you will not have to run FixUtil Describe. If the file area tag is not found in FILEBONE.NA, AutoAdd will search FILEBONE.NO (if it exists in the same path as specified for FILEBONE.NA). Ex. /F:D:\FIDOSTUF\ /L: is the path where you would like AutoAdd to write it's log (AUTOADD.LOG). If no path is specificed or is invalid, AutoAdd will place the log in the same directory AUTOADD.EXE is located in. Ex. /L:D:\PCB\LOGS\ /I: is an alternate file to write the auto-added to. This is for those of you that use .IDX files in your DLPATH.LST. If you use this option, the DLPATH.LST for the selected conference will not be updated. Instead, the specified file will have the new path appended to it, making it ready for a new run of MAKEIDX. The specified file must already exist. If it is missing, DLPATH.LST will be used. Do not use this option if you want DLPATH.LST updated. Ex. /I:D:\PCB\GEN\INDEX1.PTH (this is a registered feature) AUTOADD.CFG ----------- AUTOADD.CFG servers two purposes. It is used in conjunction with you key file and (once you get you key file) to add a great deal of flexibility to the /N, /F, and /I options. The first two lines contain the name you used to register AutoAdd (case sensitive) and your reg code, in that order. The remaining lines are either comments or overrides for the options you setup on the command line. Comment lines. There can be an unlimited number of comment lines (well, as long as you have disk space). Each comment line must have a semicolon (;) as the first character on the line. They are also limited to 250 characters per line (include the semicolon). Override lines. Override lines allow you the ability to specify the PCBoard conference (option /N), FILEBONE.NA type file (option /F), and the index.pth file (option /I) for a group or groups (a group of groups???). There are four fields per line as defined below. Each field is seperated by one or more spaces. There is a limit of 250 characters per line (including spaces). Fields may not contain spaces (it had to be said). Field 1 - This is the PCBoard conference to update for the groups in field 2. This field can contain only numbers (positive only) and must be in the range of 0 to 65667. Only one PCB conference can be specified per line. Field 2 - This is the group or groups that this line applies to. The range of groups is 0 to 255. One or more groups may be entered. There is a limit of 79 characters in this field. More than one group: To specify more than one group, seperate the groups with a semicolon (;). I.e., to specify groups 2 and 5, you would enter: 2;5 A range of groups: To specify a range of groups, enter the low and high group numbers seperated by a dash (-). I.e, to specify a range starting at group 8 and ending at group 15, you would enter: 8-15 Doing both: It is possible to use a combination of both the above methods. If you desired to specify groups 2, 5, and 8 thru 15, you would enter: 2;5;8-15 Field 3 - This field overrides the /L option. It contains the path and filename of the FILEBONE.NA type file to use for the specified group(s). This file must be in the same format as FILEBONE.NA. If you do not want to use a specific file, enter "NONE" (without quotes) and FILEBONE.NA will be searched. Field 4 - This field overrides the /I option. It contain the path and filename of the index.pth file to use for the specified group(s). If you do not want to use an index.pth file, enter "NONE". To use the default, (the one entered using /I option), leave blank. USING AUTOADD ------------- You should run AutoAdd once with all command line options that you want to use to setup the AUTOADD.DAT file. Once setup, AutoAdd will read AUTOADD.DAT for all it's info, eliminating the need to use command line options the next time AutoAdd is run. To change an option, simply specify the new option on the command line. AutoAdd will use the one you specify instead of the one stored in AUTOADD.DAT and will update AUTOADD.DAT with your new specification(s) upon exit. AutoAdd will exit with an errorlevel of 1 if any file areas were auto-added. This is ideal for using the /I option and running MAKEIDX to update IDX files. (this is a registered feature) THE BATCH FILE -------------- The way I call Autoadd: (snipped from my MAINT.001 batch file) REM CHECK FOR TIC'S. RUN ALLFIX IF ANY IF NOT EXIST D:\PCB\FIDO\INBOUND *.TIC GOTO PASSAF D: CD \ALLFIX ALLFIX File Announce -NoCrc REM RUN AUTOADD D:\PCB\AUTOADD IF NOT ERRORLEVEL 1 GOTO PASSAF MAKEIDX D:\PCB\GEN\INDEX1.PTH D:\PCB\GEN\INDEX1.IDX :PASSAFF Works for me! Of course, I had already run AutoAdd with the required options on the command line once to setup AUTOADD.DAT. Didn't you? REGISTRATION ------------ Registration is $5.00 (US). Registration will enable the updating of Allfix, the /I: option and the exit errorlevel. See AUTOADD.REG for further information. CONTACTING THE AUTHOR --------------------- I can be reached at: The Spy's Nest 1-904-458-0982/1-904-457-9111 (V.34/VFC) FIDO 1:3612/386 (or 1:3612/386.1) I also hang out in ALLFIX_HELP, PCBOARD, and PCBNET echos. WARRANTY & DISCLAIMER --------------------- There are no warranties, express or implied, for unregistered copies of AutoAdd. The author will NOT be held liable for any direct, indirect, incidental, or consequential damage resulting from the use of this program. Your use of this program constitutes your AGREEMENT to this disclaimer and your release of the author from any form of liability. Registered copies of AutoAdd are warranted to perform as described in this documentation. In the event AutoAdd does not perform as described, then the author will elect to either rectify the problem or refund the amount of the registration paid, provided notification is received within 30 days of registration. All brand and product names are Copyrighted (C) material, Trademarks (tm) or Registered (R) Trademarks of their respective holders: Allfix (C) Harald Harmes PCBoard (R) Clark Developement Co.