Beijing Paradise BBS Backup

home *** CD-ROM | disk | FTP | other *** search

/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / QRFM41.ZIP / QRFM.DOC < prev next >

Wrap

Text File | 1992-12-03 | 52.4 KB | 992 lines

QRFM Ver 4.1 4 Dec 92 Mountain Retreat Software QRFM (c) Copyright 1991 by John Jamieson All Rights Reserved Intro: QRFM is a BBS File Manager, you should be able to handle all your BBS file management chores from this platform. QRFM is designed especially for the BBS with Limited Hard Disk space and without a Backup Tape Drive. I think a lot of us have Boards that fit this description. QRFM uses a data base to manage online files in the Upload and DownLoad directories and offline files residing on floppies. This system makes it possible to run a BBS with a large complement of offline files. Offline files are easely placed back on line, QRFM tells you what floppy disk it needs in order to return a file to a download directory. Although QRFM was designed with QuickBBS Vers 2.75 and Remote Access Vers 1.10/1.11 in mind. It should be useable with any BBS that creates DoorInfo1.BBS and uses Files.BBS to record file descriptions. QRFM now swaps to EMS if available or Disk if EMS is not available when either shelling to DOS or when shelling to other programs. Because of QRFM's memory needs amd because QRFM shells to programs like ARJ which requires 290k plus memory, it was a problem assuring adaquate memory. With Swaping, QRFM no longer places such heavy demands on memory. Qrfm Features: a) Move files from the Upload area to a DownLoad area, between DownLoad areas and between Download areas and BackUp flopies. b) Edit File Description, Name or Date. The description editor allows the use of 240 character descriptions. c) Check/View/Alter the contents of an Archive, (Shells to your Archive programs then your File Manager) d) Recompress File to different Compression type, (Shells to your Archive programs). e) Check for Virus, (shells to your virus checker). f) Backup Files to Floppy and Catalog those backups. Files are backed up and the backups cataloged, makeing it possible to take files offline and put them back on line easily. Backup file copies are kept in groups in accordance with assigments made when configuring file areas. Each download area can be assigned a backup group or a group of download areas can use the same backup group. g) Delete unwanted files both online and backup copies. h) Search for files by File Name or Key Word. i) Produces a variety of file lists, including .Cross Reference file lists in both .Ans and .Asc format for display with Type 45 menu item. .AllFile listings for a specified user level. .File lists of selected file areas. j) Pick List access to file information. Display includes Backup disk number, name of Uploader, and the number of downloads as well as description, size and date. k) CDROM compatable SrchDoor Features: a) Uses the Qrfm database to perform fast searches. Handy if File Lists have gotten so large that the BBS searches are time consuming. SrchDoor uses the QRFM indexs in New file and File Name searches. b) Searches can be performed on all areas or they can be limited to a collection of areas or one area. Operation Overview: The Setup functions provide the system with the information that it requires to operate. To exit the program Close any window that might be open by pressing the F10 key or by clicking on the [■] in upper left corner of the window. then press Alt-x. You could also exit, selecting eXit on the Exit SubMenu. PickLists are used to select files to be operated on by the File_Ops and Offline_Ops menus. A the way it works is a file is selected from the Pick List, use the Mouse or Arrow keys to make a selection. A High Lighted file is a selected file, then without exiting the PickList window select the File_Ops or Offline_ops menu and select the required operation. The Pick_Lists menu offers 3 Lists the Upload, DownLoad and Not Backed up Lists and in addition the menu has a function to Load New Uploads into the data base. The Load New Uploads Function loads info on files not previously loaded into the data base for use by the UpLoad PickList. File Ops menu is broken into two areas. The first contains functions that operate on a file selected using one of the pick lists. The second group of functions operate on files extracted from the selected file and placed in the QRFM\Temp directory. The extracted contents of an archive can be altered using a file manager, the files can then be recompressed. Use this method to alter the contents of Files, as any changes to a file's, date, size, or name will cause conflicts with the data base, if changes are made to a file outside the QRFM system. Whenever you highlite a file then press enter to shell to your file manager, if the file hasn't already been decompressed to the TEMP directory, the first thing QRFM does is decompress the file. The file is also decompressed when any of the File Ops functions below the line are chosen. The Offline Ops menu provides the tools for maintaining offline files. The Locator menu contains the search functions. The BBS Lists menu can Update the Files.BBS lists, Prepare an AllFiles List and Reference Area Lists. But it's a good idea to set up a maintenance event using the utility QRFMFLST.EXE to accomplish the task. QRFMFLST.EXE will also handle the task of importing of uploads. The AllFiles.Lst file and the cross Reference Area lists are placed in the QRFM directory. When you make File Lists available for download, use a directory that has not been entered in the QRFM configuration. Since file lists are continually changing size it would be a make work project trying to keep the QRFM data base up to date. I have a seperate download directory for file lists and offer a selection of different file lists. General Info: The Files.BBS files in both the Upload and Download file areas are updated only when the BBS_Lists function [Update Files.BBS] is selected or the utility QRFMLST.EXE is used to accomplish the update. Prior to running [Update Files.BBS] Qrfm input is only recorded in the QRFM data base. A Files.BBS must exist in every non CDROM area. Because in order to support CDROM's, if QRFM dosen't find a Files.BBS file in the File Area Directory it will assume that the area is a CDROM area and description changes will be written to a FilesXX.BBS file in the QRFM\Lists directory (the File Area Code will be used in place of XX in FilesXX.BBS). If for any reason the Files.BBS dosen't exist put a dummy Files.BBS in that area so QRFM can replace it with an updated one or move and rename the FilesXX.BBS, after it has been created) from the lists directory to the File Area Directory. If you choose to use QRFM, all changes to the Files.BBS files and files in the associated directories should be accomplished using QRFM and it's utilities. Bypassing QRFM to make changes will leave the data base out of sync. Most functions are handled from the QRFM menus, but in some unusual cases you may have to be creative. Lets say you want to add a readme file to a .ZIP file in one of the download file areas. First highlite the file that will be added to then press enter to decompress it. Then drop to DOS and add the readme file to the decompressed package in the QRFM\TEMP directory. Return to the program and recompress the file. To add files to the system it's best to just place them in the Uploads directory and import them as with Uploads. Descriptions can either be added using the QRFM editor or the Files.BBS could be edited to pickup the new description. If the files were added to a download directory you would have to run the QRFM utility VerifDb to add the file to the QRFM database. This last approach could be slow if VerifDb is working with a large data base. The importing of new files from the uploads directory into the QRFM data base can be done automaticly using the utility QRFMFLST.EXE during a system event or it can be accomplished from the Pick List Menu item [Load New Uploads]. QRFM does not allow duplicate file names even if the files have a different extension or are in a different directory. The uploads directory will take the file but the name must be changed before before the file can be moved to a download directory. QRFM can be used with or without a mouse. If running without a mouse use the arrows keys to select menu items and the Tab key to Select Entry fields or Selections. Main menu items are selected by pressing the Alt key plus the HighLighted letter in the menu item description. See KeyPress info below. Importing my Files.BBS and associated file info, 3,600 files, into the QRFM data base took 4.5 hours on my 386SX, allow plenty of time for this function. An associated Door, SRCHDOOR, Makes use of the QRFM data base to provide improved search capability. SrchDoor does a very fast New Files search or File Name search. In addition it will search all lines in multi line descriptions. QRFM includes a File Cross Reference capability. A usage for instance: Include all files including Pascal source code in a cross list or include all files supporting VGA in a cross reference list. Cross Reference Areas are created with Config menu item (File Areas). Files can be taged for inclusion in up to 5 cross reference areas using the File_Ops menu item (Add to Ref Area). When using the File Manager function, changes can be made to the contents of a file. The File Manager works with files decompressed or moved into the temp dir. If any changes are made to this decompressed package, the Recompress function must be used to replace the origional copy of the file. QRFM uses a database to manage Quickbbs/RA files. The location of files on backup disks cannot be recontructed. For this reason it is recommended that .DAT and .CFG files be backed up at least after every session involving the backup of BBS down loadable files, or the deletion of a file involving a floppy. Setup: a. Create a QRFM directory, a LISTS Subdirectory and a TEMP Subdirectory and place QRFM.EXE and the utilities you intend to use in the QRFM directory. C:\─┐ │ └─QRFM────────────┬─QRFM.EXE ├─SRCHDOOR.EXE or SRCHDOR2.EXE ├─QRFMSRCH.EXE ├─QRFMFLST.EXE ├─CNTDN.EXE ├─UPBY.EXE ├─VERIFDB.EXE ├─REBLDIDX.EXE ├─QRFM.KEY │ ├─TEMP (SubDir) └─LISTS (SubDir)──── *.HDR When you run QRFM for the first time the following files are created in the QRFM directory. │ ├─QRFM.CFG ├─QRFMAREA.DAT ├─QRFMDESC.DAT ├─QRFMFILE.DAT ├─QRFMAREA.IDX ├─QRFMDATE.IDX ├─QRFMNBAK.IDX └─UPLFILE.IDX The rest of the setup is handled from the Config menu. ┌────────────────────────────────────────────────────────────────────┐ │Exit Pick_Lists File_Ops Offline_Ops Locator BBS_Lists Config │ └───────────────────────────────────────────────────────────────┬────┘ │ ┌──────────┴───────────┐ │ Directories │ │ File Areas │ │ Compression Methods │ │ Other Externals │ │ Import Files.BBSs │ │ Backup Drive │ ├──────────────────────┤ │ Import all Files.BBSs│ │ Import a files.BBSs │ └──────────────────────┘ b. The BBS Upload and DnLoad directories should contain the Files.BBS and the files listed in the Files.BBS. Any other files in the BBS Upload and DnLoad directories that you don't want to appear in the data base should be removed. Prior to running Import Files.BBS. Files not listed in the Files.BBS will be included in the data base with a dummy description. Any files that get past you can be deleted later. c. Change to the QRFM dir and Run QRFM. Allow QRFM to build the Config files. Then select Setup and then complete the Setup items. The BBS as it exists at present should be reflected in these entries. 1. Directories: Enter the complete path names for your BBS Program directory and your DownLoad Directory. ╔═[■]═════════════════ System Directory Config ════════════════╗ ║ ║ ║ ║ ║ BBS Directory c:\Ra ║ ║ ║ ║ Upload Directory D:\newfiles ║ ║ ║ ║ [ Ok ] [Cancel] ║ ║ ║ ╚══════════════════════════════════════════════════════════════╝ 2. File Areas: Enter the complete path names for all of the BBS File Download areas and File Cross Reference areas. File Cross Reference Areas are explained in General Info above. All areas in use must be entered at this time. The Areas ConFig window operates as follows. The window opens in the [Add Area] configuration use the mouse or Tab key to select the Area key field. Enter a two character Area Key for a download area. This key will be used by the system in all future record keeping. Use the Mouse,Alt+ HighLighted Letter or Tab key to move to the other entry fields and complete them. DON'T use the enter key when entering Data it will switch you to [Pick Area]. When all the fields are complete, Select [Save]. The selection boxes have these functions. [Add Area] formats entry fields for a new area. [Add XRef Area] formats fields for a new cross reference area. [Pick Area] will allow you to select an area from those assigned, in order to make changes. [Save] saves the current entry [Delete] deletes an unused area. [Done] or [Cancel] Exits the window, a click on the [■] in upper left corner, or pressing F10 will also exit the window. ╔═[■]═══════════════ Areas Config ════════════════════╗ ║ 1A ░ ║ ║ 1B ░ Area Key 1A ║ ║ 1C ░ ║ ║ 1D ░ Access Level 5 ║ ║ 1E ░ ║ ║ 1F ░ Description Menu Systems ║ ║ 1G ░ ║ ║ 1H ░ Area Path H:\Menu ║ ║ 1I ░ ║ ║ 1J ░ BackUp Group 00 to 99 02 ║ ║ 2A ░ ║ ║ 2B ░ [ Add Area ] [ Done ] ║ ║ 2C ░ ║ ║ 3A ░ [ Add Xref Area ] [Cancel] ║ ║ 3D ░ ║ ║ 3E ░ [Pick Area] [Save ] [Delete] ║ ║ 3G ░ ║ ╚═════════════════════════════════════════════════════╝ 3. Compression Methods: The compression methods you deal with should be entered here with the corresponding extraction and compression commands. If the programs called here are not in your path, use the full path names. If you use ARJ you will need much memory, QRFM running ARJ seems to need about 500k. The following example supports the inclusion of subdirectory information in files. The Alternate Extraction Command allows you to decompress without using path info. I found it necessary to add this Alternate Extraction command because I was finding some uploads that were compressed with path info in error. The Alternate Extraction Command allows me to drop that path info when decompressing by using Arj e. ╔═[■]════════════════════ Compression Methods ════════════════════╗ ║ ║ ║ Ext. Extraction Cmnd Compression Cmnd Alt Extract Cmnd ║ ║ ║ ║ ARJ Arj x -y Arj a -jt -y -r Arj e ║ ║ ZIP PkUnZip -d PkZip -rp PkUnzip ║ ║ PAK Pak e Pak a /I ║ ║ SDN Pak e Pak a /I ║ ║ ║ ║ ║ ║ [ Ok ] [ Cancel] ║ ║ ║ ╚═════════════════════════════════════════════════════════════════╝ 4. Other External: Give the system the command that executes your Directory manager and Virus checker. As with compression Methods If the programs called here are not in your path, use the full path names. The directory manager and Virus Scan programs shown in the example below are Shareware programs selected for the example because of their availability. They are found on BBS's as DR.* And SCANV*.*. First give your favorite File Manager and Virus checker a try. A couple of other file managers I tried worked fine and can be substituted for DR. DF.EXE, Directory Freedom on my BBS as DF450.ZIP or DB.EXE from Director Vers 4.5 on my BBS as DIRECTOR.ZIP. ╔═[■]═══════════════ External Calls Config ════════════════════╗ ║ ║ ║ ║ ║ Dir Manager DR ║ ║ ║ ║ ║ ║ Virus Check B:\Scan\Scan /D *.* /NOMEM ║ ║ ║ ║ ║ ║ [ Ok ] [ Cancel] ║ ║ ║ ╚══════════════════════════════════════════════════════════════╝ 5. Select the drive that you wannt QRFM to use for floppy backups. 6. Import Files.BBS: when the rest of the setup is complete you are ready for this function. All the Files.BBS files except the one in your Upload directory are read in to the Data Base along with File sizes and file dates. Orphan files are also imported, and a list of any files that are called out in the Files.BBS but not found in the Directory, is produced and placed in the download directory. This function is intended to be used only once. It can be repeated if for some reason files have been added to the download directory without using QRFM. If repeated this function only picks up files not already in the Data Base. The reading of the Upload directory Files.BBS is a seperate function and is found in the Pick_Lists Menu. This function is not required if the BBS dosen't have files yet. Already mentioned above but I will mention it again, importing my Files.BBS and associated file info, 3,600 files, into the QRFM data base took 4.5 hours on my 386SX, allow plenty of time for this function. If you want you can import directories one at a time using the Import a Files.BBS function. Operation: a. After the configuration has been established including the Import of Download areas, Files.BBS, into the QRFM database, the system is ready for use. Any files that are in the upload directory should be imported at this time. Use the Pick_List menu item [Load New Uploads], it will import all files that haven't already been imported, into the QRFM data base. A file does not have to be on the Files.BBS list, Orphan files are also imported into the data base. You can use this feature when adding files to the board. Just place them in the Upload directory and import them, then use the QRFM description edit function to add a description. Descriptions read from the Upload Directory Files.BBS can be up to 240 characters on the same line as the File name and starting in column 14. When imported into the QRFM data base descriptions are placed in lines 46 characters long. Only 7 lines can be displayed by QRFM and only 240 character descriptions can be be edited. Keep descriptions under 240 characters. b. Pick_Lists are used to select a file for processing by the the functions in the File_Ops and OffLine_Ops menus. A file must be high-lighted in a Pick_List before a file can be processed. Pull up Pick_Lists by selecting one from the Pick_List menu with mouse, function Key, or Alt key and menu item first letter. Close a Pick_List with the F10 key or click on the upper left corner with the mouse. Key presses available while traversing the Pick_Lists: Home HiLite Bar moves to first item End HiLite Bar moves to last item PageUp HiLite Bar moves up a page PageDn HiLite Bar moves down a page Up Arrow HiLite Bar moves up a line Dn Arrow HiLite Bar moves down a line Enter If a file is HiLited the file is uncompressed and your file manager is called to view it's contents If a file area is not displayed the HiLited file area will be displayed. Left Arrow If a file area is displayed it will be closed so so that another area can be opened. Any Character The file HiLite bar will jump to the next or first File whos name starts with that character. Space Bar Mark a collection of files for a group move. The space bar can also unmark a marked file. Tab When in window that has a number of buttons and fields the Tab key can be used to the next button or field. The mouse can be use to select files, Menu items and buttons. the Right mouse button when clicked on a file name functions as the space bar and will mark that file for a group move. c. File_Ops functions are all pretty much self explanatory. A couple of things that arn't, when working with files you must first bring up one of the three Pick Lists. With the UpLoad or DnLoad Pick list displayed all the File_Ops are active. Select a file by clicking on it with the left mouse button or using the Arrow keys to move to and high-lite the file. Once a file name has been high-lighted use the mouse or Alt-f to select the File_Ops menu. When moving files an optional tag and move is supported. If the Move menu item is selected and any files are taged they will be moved instead of the HiLited file. Files are taged by pressing the right mouse button or the space bar. If during the functions (Recompress, File Manager or Virus Scan) a file is encountered that dosen't have a Extension, that can be found in the Setup, the following steps are taken: If the file is a .EXE you will be asked if you want to try and decompress it. If you answer no or if the file has any other extension that isn't found it will be copied to the Qrfm Temp subdirectory. And the selected function will be completed. The Lower Description Case function will change the description from UpperCase to LowerCase with the exception of the first character in each word. d. OffLine_Ops are active when the DnLoad Pick list is being displayed. In addition the OffLine_Opp menu items [Backup to Floppy] and [Mark Backup N/R] are active when the NotBacked picklist is displayed. The menu item [Mark Backup N/R] will mark an item as not requiring backup, an item so marked will not appear on the Not Backed pick list. If QRFM is told to backup a floppy you will be asked to place a floppy in the A: drive. If room is available on an existing backup disk, in the required backup group, that disk disk will be requested otherwise a blank formated disk will be requested. Once backed up a file can be taken offline and put back on line as required. QRFM keeps track of offline status, floppy disk numbers, and the space available on floppys. The maximum number of files that QRFM can catalog on a floppy has been set at 21. e. The Locator menu provides quick access to info in the data base. The Pick_Lists can not be displayed when using Locator menu functions. f. The BBS_Lists menu has functions for updateing the BBS file listings. The File lists are are not maintained during File_Ops functions, and must be updated using the BBS_Lists functions or using the QRFM utility QRFMFLst (see info on utilities below). The AllFiles.Lst, BakUpDsk.Lst and Reference Area lists are placed in the QRFM\LISTS subdirectory. The Function (Get XferDoor DnLoad Counts) will only function if XferDoor is used for downloads. It incorporates downloads made using XferDoor into the QRFM Data Base. See the paragraph on XferDoor below. Reference area lists are created in .ANS and .ASC format for display by the BBS. g. The QRFM menu system ┌─────────────────────────────────────────────────────────────────────┐ │ Exit Pick_Lists File_Ops Offline_Ops Locator BBS_Lists Config │ └────────┬───────────────┬────────────┬───────┬─────────┬─────────────┘ │ │ │ │ └─────────┐ ┌────────┴─────────────┐ │ │ ┌────┴─────────────────┐ │ │ UpLoad File List F2 │ │ │ │ Filename Search │ │ │ DnLoad File Lists F6 │ │ │ │ Keyword Search │ │ │ NotBacked Up List │ │ │ │ Backup Disk Contents │ │ ├──────────────────────┤ │ │ └──────────────────────┘ │ │ Load new Uploads │ │ │ │ └──────────────────────┘ │ │ │ ┌────────────────────────┴┐ ┌────────┴───────────┐ │ │ Move F5 │ │ Backup to Floppy F7│ │ │ Edit Description │ │ Delete Backup Copy │ │ │ Name Change │ │ Take Offline │ │ │ Date Change │ │ Put Back Online │ │ │ Kill File │ │ Mark Backup N/R │ │ │ Add to Ref List │ └────────────────────┘ │ │ Cut from Ref List │ ┌────────────────────────┴───┐ │ Lower Description Case │ │ UpLoad Files.BBS Update │ │ UpLoaded By Name Edit │ │ DnLoad Files.BBS Update │ ├─────────────────────────┤ │ Write AllFiles List │ │ Recompress F4 │ │ Reference Area Lists │ │ Search for Virus │ │ Backup Disk File List │ │ File Manager │ └────────────────────────────┘ │ Virus Chk/File Mgr F3 │ │ Alt eXtract │ └─────────────────────────┘ h. Example PickList with File File DTP256.ARJ selected from the File Area 1G. Exit Pick_Lists File_Ops Offline_Ops Locator BBS_Lists Config ╔═[■]══════════════════════════ DnLoad Selector ═══════════════════════════════╗ ║ Area Graphics ║ ║ ═╪══════════════════════════════════════════════════════════════════════ ║ ║ 1A ░ DANFLIK2.ZIP ────────Area Info───────────────────────────────── ║ ║ 1B ░ DANFLIK3.ZIP ░ Path: D:\_Graph ║ ║ 1C ░ DAZE41.ZIP ░ Space Avail=219316224 ║ ║ 1D ░ DAZZLE.ZIP ░ Area Access Level: 5 ║ ║ 1E ░ DAZZLE12.ZIP ░ ────────File Info───────────────────────────────── ║ ║ 1F ░ DBWRENDR.ZIP ░ #:49 Size:274918 Date:10/29/1991 ║ ║ 1G══░ DIGPRNT.ZIP ░ XRef Areas: A Dnloads: 4 ║ ║ 1H ░ DOSEYE.ZIP ░ Backup Group:06 ║ ║ 1I ░ DRAFTC.ZIP ░ Uploaded By: Paul Jones ║ ║ 1J ░ DTP16.ZIP ░ ────────File Description────────────────────────── ║ ║ 1K ░══ DTP256.ARJ ═══░ DeskTop Paint 256. VGA Drivers for ATI, ║ ║ 2A ░ DUMP0891.ARJ ░ Headland & Paradise cards. A full colour ║ ║ 2B ░ E2VGA5.ZIP ░ bitmapped paint program uses the extended ║ ║ 2C ░ EASYCASE.ZIP ░ resolution of super VGA. Full colour ║ ║ 2D ░ EDRAW320.ZIP ░ manipulation and drawing, output in PCX, GIF, ║ ║ 3A ░ EEDRAW.ARJ ░ IFF/LBM, TIFF formats. ║ ║ 3B ░ EGA2VGA3.ZIP ░ ║ ║ 3C ░ EGAGRAPH.ZIP ░ ║ ║ 3D ░ EGALASER.ZIP ░ ║ ╚══════════════════════════════════════════════════════════════════════════════╝ F2 Ups F3 Chk F4 Comp F5 Move F6 Dns F7 Bak F8 Info F9 DOS F10 Close i. The status line offers a one key press short cut to some of the more often used functions. Recovery from a Hard Disk Crash: Backup the QRFM .Cfg and .Dat files on a regular basis in preparation for an eventual hard disk crash. As a minimum the .Dat files should be backed up each day in which download area files have been backed to floppy. If the QRFM backup dosen't reflect the condition of the backups on floppy, there is no way for QRFM to recover the location of those files. I guess I could write a utility to verify that the data, on the backup flopies, is in the database. I have over 600 flopies that verifying would be a bit much. If a crash wipes out the QRFM directory/files restore them from backup and run the utility ReBldIdx.EXE to generate the .Idx index files, if they wern't included in the backup. If the QRFM directories were lost be sure to re-create the QRFM sub directories. Then restore any of the DownLoad/UpLoad directory structure that was wiped out. Files.BBS are not needed QRFM will create them. QRFM won't create missing directories, you must create them. (a possible future QRFM revision). Missing files or files not recorded in the QRFM backup, are not a problem. After the system again matches the QRFM configuration data, run the utility VerifDb.Exe from the QRFM directory. VerifDb will check each file entry in the QRFM data base against the actual files in the download directories and it will update the files on line status. No need to place files that were lost in the crash back on line prior to running VerifDB, all files backed up using QRFM and not found on line will be statused as OffLine. QRFM recorded files that were lost and had not been backed up will be deleted from the QRFM data base and are reported in a file named VerifDb.Log that will be placed in the QRFM directory. The QRFM backup may be a bit out of date so the download directories will be checked for files that arn't in the QRFM data base. Files found in the download directories that are not recorded in the QRFM backup, will be added to the QRFM data base with out a description and will be reported in VerifDb.Log. The QRFM edit function can be used to describe the file. Systens that have a CDROM: When importing files during QRFM setup if CDROM files.BBS's are to be imported place files.BBS in the QRFM Lists directory under the name FilesXX.BBS, one for each CDROM directory. Substitute the two character QRFM file area designator for XX in the file name. If QRFM dosn't find a Files.BBS in the File Area it will look in the Lists directory. Description changes will be written to the FilesXX.BBS. Utilities and related programs: The following programs are not required in order to use QRFM, they provide added features if you want or need them. 1. SrchDoor and Srchdor2 a. The difference between these two programs is that SrchDoor uses Exitinfo.BBS and will give a user a list of new files since the users last call. SrchDor2 uses DorInfo1.Def and does everything else that SrchDoor does except for that one new files function. a. SrchDoor does fast file name and new file searches are valuable when the BBS searches are being slowed down by a large file collection. SrchDoor makes use of the QRFM database to provide fast and complete NewFile and FileName searches. SrchDoor will also do description word searches. Another use for SrchDoor is to restrict searches to particular directories. SrchDoor looks in the default directory for DorInfo1.Def, and uses the environment variable QRFM=C:\QRFM to locate the QRFM files. SrchDoor will only display areas that fall within the user security level. b. SrchDoor will run in stand alone local mode and as a door in on-line door or in local mode. To run as a door SrchDoor must find ExitInfo.BBS or DorInfo1.Def if you are running SrchDor2. c. Two seperate Search menus can be called, a QuickBBS type 7 door is recomended. The command line parameter "S" will cause SrchDoor to use it's File Search Menu and the parameter "N" will bring up the New Files Menu. Command line parameters can also be included to spell out the file areas that are to be searched and a parameter can be used to force SrchDoor to Monochrome on the BBS monitor. An example of how to call the door and samples of the menus follow. Useing a QuickBBS type 7 menu Place the Full Path Name followed by command line parameters in the Menu Optional Data Field. Example command lines for File Name and Key Word searching to search all areas to search selected areas C:\QRFM\SrchDoor.EXE S C:\QRFM\SrchDoor.EXE S TP TC TA Example command lines for New Files searching to search all areas to search selected areas C:\QRFM\SrchDoor.EXE N C:\QRFM\SrchDoor.EXE N TP TC TA The two character parameters in the examples to the right are area codes identifying file areas that a search is to be limited to. SrchDoor can be forced to MonoChrome on the BBS monitor by the use of a M parameter. Example: C:\QRFM\SrchDoor.EXE M S If used M must be the first parameter. ╔════════════════════════════════════════════════════════════════════════╗ ║ Search for a File ║ ╠════════════════════════════════════════════════════════════════════════╣ ║ 1 File Name Search ║ ║ 2 Description Key Word Search ║ ║ Q Exit New File Search ║ ╠════════════════════════════════════════════════════════════════════════╣ ║ QRFM SrchDoor - Mt. Retreat Software - Support BBS (408)335-4595 ║ ╚════════════════════════════════════════════════════════════════════════╝ Input : Item 1 in the following screen is not available in SrchDor2 ╔════════════════════════════════════════════════════════════════════════╗ ║ New File Search ║ ╠════════════════════════════════════════════════════════════════════════╣ ║ 1 New Files Since Last Date Called ║ ║ 2 Files Added in the Past Week ║ ║ 3 Files Added in the Past Month ║ ║ 4 New Files as of mm-dd-yy ║ ║ 5 New Files as of X Days ago ║ ║ Q Exit New File Search ║ ╠════════════════════════════════════════════════════════════════════════╣ ║ QRFM SrchDoor - Mt. Retreat Software - Support BBS (408)335-4595 ║ ╚════════════════════════════════════════════════════════════════════════╝ Input : d. SrchDoor.EXE is included in the QRFM package. If a Fossil version is required it can be downloaded or Freq'd from Mountain Retreat BBS. FileName QRFM_FOS.ARJ. e. Trouble shooting the SrchDoor installation: The Status bar can be an aid in trouble shooting the door installation. Check for a comment in the lower left corner of the status bar. 2. QRFMSrch QRFMSrch is a stand alone Search utility. It more or less duplicates the features of SrchDoor. It only needs the QRFM data base to function, it dosen't need access to the BBS and it's directories. If not running QRFMSrch from the QRFM system directory , it is necessary to add the environment variable SET QRFM=C:\QRFM, set it to whatever directory QRFM is in. 3. QRFMFLst QRFMFLst is a utility that can be run from a batch file. It will accomplish the QRFM BBS List functions and then some. Command line parameters are used to tell QRFMFLst the functions that are to be accomplished. If not running QRFMFLst from the QRFM system directory, it is necessary to add the environment variable SET QRFM=C:\QRFM, set it to whatever directory QRFM is in. If you use XferDoor then the -F option will obtain DownLoad Counts and the name of the User that uploads a file from files created by XferDoor. If you don't use XferDoor then the -O option will accomplish the same tasks as the -F option, obtaining Names and Download counts from the UpLoads and DnLoads logs. This -O option puts a copy of the last DnLoads.Log line read into a Textfile called LastDn.Log in the QRFM directory. If that file is not found the complete DnLoads log will be processed, so don't delete it unless you also delete the DnLoads.Log. If you are switching from XferDoor to another Transfer Door you will want to create LastDn.Log or start with a new DnLoads Log so that Downloads already counted don't get counted again. This -O option could be time consuming if the UpLoads and DnLoads Logs are allowed to get very long. QRFMFLst -O will accomplish the QRFM menu items a. Load new Uploads b. Get DnLoad counts from DnLoads Log c. UpLoad Files.BBS Update e. DnLoad Files.BBS Update ** ATTENTION, Use this option if you DON'T USE XferDoor to handle file transfers and want to use the DnLoads.Log to obtain download counts. Use the -F option if you use XferDoor. QRFMFLst -F will accomplish the QRFM menu items a. Load new Uploads b. Get Xferdoor DnLoad counts if available c. UpLoad Files.BBS Update e. DnLoad Files.BBS Update ** ATTENTION, Use this option if you USE XferDoor to handle file transfers QRFMFLst -R will accomplish the QRFM menu item Reference Area Lists, updating all Reference Area lists. Reference area lists are created in .ANS and .ASC format for display by the BBS. QRFMFLst -L Level will Generate a Allfiles List QRFMFLst -L 50 would Generate a Allfiles List and include only areas with a security level less than 50. QRFMFLst -S Adult.Lst D G1 Will Generate a list of the files in file areas D and G1 and place it in the lists subdirectory under the name Adult.Lst. QRFMFLst -D Character Will Generate a files list for each area with a name that is generated as follows. Character+File Area key+.DIR. You probably will have no use for this one it was for a special purpose. The lists generated by the -S and -L switches can include a header of your design. Create a list header and place it in a File with the extension .HDR and same name as the file it is to be used with. Place the file in the lists subdirectory and it will be included when the file list is generated. Command line parameters can be combined, but LIMIT the Length of the parameter string to 100 characters. Example: QRFMFLst -F -R -L 50 -S Adult.Lst D G1 -S Prog.Lst 1 2 3 I had some problems with very long command lines and as yet don't know what QRFMFLst command line limits are. My longest command line at this time is 70 characters. If length becomes a problem just don't combine too many options. 4. XferDoor XferDoor when used in conjunction with QRFM provides added features in both QRFM and XferDoor. Qrfm will be given the name of a File UpLoader and in addition DnLoad counts are passed to QRFM. XferDoor will use the QRFM database to determine if a file is already on the BBS. Existing files, includeing offline files can then be rejected. XFERDR72.ARJ is the latest normal release at this time. It Supports both QuickBBS Vers 2.75 and RA Vers 1.10/1.11. XferDr72.ARJ can be downloaded from Mountain Retreat BBS at (408)335-4595 or Freq the magic name XferDoor from 1:216/506. XferDoor requires the QRFM environment variable be set. (SET QRFM=C:\QRFM), set it to whatever directory QRFM is in. 5. CntDown CntDown will read DnLoads.Log file and record the download count in the QRFM Data Base. CntDown can be used only once on a DnLoads.Log. If you run this more than once on the same DnLoads.Log your download count would be doubled. This utility was intended to used only once, with the program QRFMFLst being used for maintaining download counts after CntDown establishes a baseline. This program wants to be run from your QRFM directory. 6. UpBy UpBy reads the UpLoads.Log file and records the name of the user that uploaded each file into the QRFM Data Base. As with CntDown, this utility was intended to used only once, to established a baseline. Like CntDn this program must be run from the QRFM directory. 7. ReBldIdx This utility can be used as part of a backup system, it makes the backup of .IDX files un-necessary as they can be regenerated with this utility. 8. VerifDb VerifDb is required only in the event the QRFM data base and directories/files become out of sync due to a hard disk crash, additions/deletions of files outside of QRFM (a NoNo) or whatever. See Recovery from a Hard Disk Crash above for info on it's use. History: Version 2 fixed a bug that caused problems in Index files when the index file size reached 32k. A function was added to the OffLine_Ops Menu, Mark Backup N/R. This function will mark files not requiring backup, keeping them off of the NotBacked Up PickList. Reference area lists are created in .ANS and .ASC format for use with Type 45 or Type 5 menu types. Version 3.0 adds file taging for group moves and a jump to feature. With the jump to feature, if a pick list of files is displayed pressing a character will jump to the first file whos name starts with that character. The utility VerifyDB.Exe was added, it was created mainly for use in the event of Hard Disk problems. Version 3.0a corrects a few minor glitches discovered after the 3.0 release. Version 3.0b adds the File functions, Lower Description Case and UpLoaded By Name Edit. It also corrects problems in the utilities VerifDB and ReBldIdx. They were flawed and the files they created did not totally match the actual condition of the BBS files. Version 3.1 corrects a problem with a disappearing highlite bar in the NotBacked Up Pick List. It also eliminates a bug that prevented a download area's associated backup area from being changed to a new non existing area. Made a change to the Load new Uploads function, on compleation of this function the user is now presented with the Upload Files Pick List. A Config menu option for selecting A or B drives for floppy backups was added. Docs cleaned up a bit. Version 3.1a corrects a glitch in the new backup drive selection function. It also adds ReCompress and BackUp to the selections on the status line. Corrected an alignment problem in the positioning of extended description lines displayed by QRFMSrch and SrchDoor. Version 3.1b corrects a problem that prevented QRFM from creating a new config file. Also added message notifying user if memory at startup is inadequate. Version 3.2 SrchDoor will now work on Multinode systems. Also fixed a problem with SrchDoor repeating a record when doing a word search if that word was repeated in the record. QRFM and QRFMFLst will obtain the uploaders name from the UpLoads log if XferDoor is not providing the info. QRFMFLst will obtain download counts from the DnLoads log if XferDoor isn't providing them. Version 3.3 Beta. Support for CDROM directories added. A message stateing that QRFM is working will now be displayed during time consuming processes. Areas can now be imported 1 at a time (Config Menu). Version 3.4 minor changes to beta version. Version 3.5 SrchDoor revised by adding HotKey feature and an additional New Files menu item. Version 3.6 Set 535k as minimum memory requirement. Version 3.6a bugfix in QRFM and QRFMFLST Import Upload routines. Version 3.7 When shelling to DOS or other programs, QRFM as of this change will swap to EMS if available, if EMS is not available QRFM will swap to disk. Version 3.8 BugFix Fixed bug that caused hang at startup Version 3.9 fixes 3 problems. a. QRFM could not handle CD-ROMs that included a Files.BBS in the CD-ROM directories. This revision fixes that CD-ROM problem. b. QRFM could not handle the decompression and compression of files that included subdirectory information. Changes in this revision fix the decompression/compression problem. c. The Import a Files.BBS function would not import just one Files.BBS. QRFM will now import one Files.BBS at a time. Version 4.0 cleans up problems introduced by Version 3.9. This fix required that the comment field in the Compression Methods Dialog be eliminated, the space was required for the addition of an Alternate Extraction method. Version 4.1 Added Srchdor2, it uses DorInfo1.Def instead of ExitInfo.BBS as SrchDoor for systems not able to produce ExitInfo.BBS. Disclaimer agreement Users of QRFM and it's utilities must except the following disclaimer agreement: QRFM and it's utilities are provided AS IS. The Author makes no Warranty of any kind, expressed or implied. In addition THE AUTHOR ASSUMES NO LIABILITY FOR DAMAGES WHICH MAY RESULT WHICH MAY RESULT FROM THE USE OF QRFM or it's utilities. QRDB is ShareWare, a $15 registration fee is required. For an additional $10 I'll send you a copy of the latest version with with a 65 character message of your choice replacing the following line in the QRFM SrchDoor menu. ╠════════════════════════════════════════════════════════════════════════╣ ║ QRFM SrchDoor - Mt. Retreat Software - Support BBS (408)335-4595 ║ ╚════════════════════════════════════════════════════════════════════════╝ If you decide to continue useing QRFM after a 90 day trial period you are expected to register. Please send your registration fee to: John Jamieson Mountain Retreat Software 555 Buckeye St. Felton Ca, 95018 For support contact: Fidonet 1:216/506 Internet John.Jamieson@f506.n216.z1.FIDONET.ORG BBS phone (408)335-4595 Voice (408)335-4672