PCBoard 15.1 Custom Allfiles List Builder Command Version 2.0 Documentation Earl Bonser, SysOp The GIFfer BBS 12088 Anderson Rd. Suite #170 Tampa, Fl. 33625 Fido (1:377/50) (813) 969-2761 969-2956 969-1829 969-1089 960-7267 960-7348 961-8292 961-8412 I hate lengthly doc's as much as anyone, so this will be kept as short and to the point as possible. The CFList program is is a PCBoard PPE command that allows your users to create their own Allfiles list to download instead of downloading your entire Allfiles list. They have a varitey of criteria that they can use to select the files that they want included in the list. Their options are: - Specific file directories - New file scans (since last scan or specified date) - Keyword searches (like Zippy scan) - Cross conference scans (honoring registration rules) - Display/don't display files as they are matched - Any combination of the above This PPE uses optimized external routines to speed up the search process. A scan for new files on my BBS (about 110,000 files) takes about 20 seconds and does not require any pesky configuration files that take constant updates. It also recoginzes mail only conferences (no files in the conference) and will not waste it's time with them. If you change your file configuration for any conference in PCBoard this PPE will automatically detect it since it is obtaining the PCBoard file list specification directly from PCBoard. Installation is really complex [;) - Just do the following: 1 - Move all of the files into a single hard drive directory. If you are running a multi node system and/or a Lan, this must be a directory that all of the nodes can access. You can create a new directory just for the CFList PPE or move the files into any existing directory. The following files should be included: CFLIST.PPE the PCBoard command module CFLISTK.EXE a CFList sub command module CFLISTN.EXE a CFList sub command module CFLISTT.088 a 8086 specific CFList submodule CFLISTT.286 a 80286 specific CFList submodule CFLISTT.386 a 80386 specific CFList submodule CFLISTT.486 a 80486 specific CFList submodule CFLIST.DOC this file HISTORY.CFL a list of the changes for each release REGISTER.CFL the registration document 2 - Rename one of the CFLISTT.nnn programs to CFLISTT.EXE. The one you choose should match the type of processor you will be using for the best performance. If you have a mixture of processors, select the lowest one. If you pick one that is a higher number than your slowest processor unpredictable results will occur. If you are running under OS/2, you must pick either the 386 or 486 version or protection errors will occur. 3 - If you would like a header put on the list to advertise your BBS just place it in a file named CFLIST.HDR in the same directory that you put the PPE in. This file can contain as many lines as you want but should be limited to 79 characters per line to keep it in the same format as the PCBoard DIR list files. I just use a copy of the file used to add comments to ZIP and ARJ files in the PCBTEST.BAT file on my BBS. 4 - If you are running a multi node system, ensure that each node specifies a unique directory for it's temporary work files in PCBSetup B (File Locations), A (System Files & Directories) "Location of Temporary Work Files". 5 - Select a directory that will be used for callers to download the list file from. CFList will place the files list in this directory after it is built and remove if after the caller downloads it. It MUST be a directory that is included as a Download Path in PCBSetup for each conference and should NOT be an indexed directory. It's also best to make it one of the first directories in the Download Paths list in case one of the names generated for the temporary collage file ends up duplicating the name of a file already posted on your BBS. 6 - Add the CFLIST PPE to your PCBoard CMD.LST file. Go into PCBSetup, B (File Locations), B (Configuration Files), move the highlight bar to "Name/Loc of Default CMD.LST File" and press F2. The following screen will be displayed. Enter a command specification line for the CFList PPE similar to this: Command Security PPE/MNU File -or- Keystroke Replacement ======= ======== ========================================== CL 21 D:\PCB\PPE\CFLIST.PPE D:\TEMP These usage of the fields on this screen are: * Command: It is not required that the command name be CL, but it is highly recommended. * Security: You can specify any security level you want. This is the MINIMUM security level required for a caller to be able to use this command. You may want to set it at a level only you or a few selected callers can use while testing it. * PPE/MNU File -or- Keystroke Replacement: The location and name of the CFLIST.PPE and the location/name of the DLPATH.LST identified download directory that the collage files will be placed in for the user to download. The ZIPped file will be deleted after the user downloads it. This must be a fully qualified path name (include drive letter). If you have a "hidden" directory like most of us sneeky snakes, it's ideal for this. 7 - Add the following line to your $$LOGOFF.BAT file(s). IF EXIST d:\temp\CFL%PCBNODE%.ZIP delete d:\temp\CFL%PCBNODE%.ZIP This will clean up any list files that may be left in your download directory under some circumstances. If the caller select the (G)oodbye option when downloading the list file, the PPE is never reentered and the list file is not deleted. This will ensure that it is removed when the caller disconnects. 8 - If you are running a single node, it may be necessary for you to add the following line to the start of your BOARD.BAT file. PCBoard does not automatically build this environment variable in some setups on single node systems (even if you are using a multinode version like /2, /5, /10, etc.). If you have set the "Running in a multitask environment" switch in PCBSetup to "N", you MUST either change it to "Y" or add the following line to the begenning of your BOARD.BAT file. SET PCBNODE=1 The list file that is created for the user is generated with the PCBoard node number in it. The format of the list file name is: CFLIST.nnn ^^^--------> The BBS node number. The number of characters vary depending on the node number (ie: node 1 is 1 character, node 24 is 2, etc.). The ZIP file that is created for download is generated with the PCBoard node number in it also. The format of the ZIP file name is: CFLnnn.ZIP ^^^--------> The BBS node number. The number of characters vary depending on the node number (ie: node 1 is 1 character, node 12 is 2, etc.). As you can see, it is possible for the generated name to duplicate the name of a file already posted on your BBS. This, however, is very unlikley. We recommend that the directory you specify for the ZIP file to be placed in for downloading be the first in your DLPATH.LST just in case it does happen to duplicate an existing file name. Last, but not least, be sure that you have PKZIP.EXE somewhere in a PATHed directory. DISCLAIMER CFList by Earl Bonser is released to the general public as Shareware. CFList is provided AS IS without any warranty, expressed or implied. This includes without limitation the fitfulness to a particular purpose or application and any warranties of merchantability. While I tried to be as thorough as possible while debugging CFList I shall not be liable for any damages, whether direct, indirect, special, or consequential arising from a failure of CFList to operate in a manner desired by the user. I shall not be liable for any damage to data or property which may by caused directly or indirectly by use of CFList. The only thing that I can gurantee is that it will use some space on your hard drive when you install it. In no event will I be liable to you for any damages, including any lost profits, lost savings or other incidental or consequential damages arising out of your use, ability or inability to use the program, or for any claim by any other party. CREDITS PCBoard is a registered trademark of Clark Development Company, Inc.