Boldly Go Collection

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

/ Boldly Go Collection / version40.iso / TS / 25D / TFM122.ZIP / TURBOFM.DOC < prev next >

Wrap

Text File | 1992-08-09 | 21.8 KB | 453 lines

TTTTTTTT UU UU RRRRRRR BBBBBBB OOOOO FFFFFF MM MM TT UU UU RR RR BB BB OO OO FF MMM MMM TT UU UU RR RR BB BB OO OO FF MM M M MM TT UU UU RRRRRRR BBBBBBB OO OO FFFF MM MM MM TT UU UU RR RR BB BB OO OO FF MM MM TT UU UU RR RR BB BB OO OO FF MM MM TT UUUUU RR RR BBBBBBB OOOOO FF MM MM T U R B O F I L E M A N A G E R V 1.21 F O R T A G B B S Copyright(C) 1992 - Royale Software, All rights reserved. Written by: Mike Normand for TAG 2.6 and Higher Table of Contents: ------------------ Chapter Description - Page - --------------------------------------------------------------------- Packing List .................................................. 1 About Turbo File Manager ...................................... 1 Credits ....................................................... 1 Warranty ...................................................... 2 License Agreement and Copyright ............................... 2 System Requirements ........................................... 2 Support Information ........................................... 2 Setup Instructions ............................................ 3 Using TurboFM ................................................. 4 The Move Command .............................................. 5 The Offline Command ........................................... 6 The Remove Command ............................................ 6 The Delete Command ............................................ 6 The Erase Command ............................................. 6 Log Functions ................................................. 6 Multi-Node Concerns ........................................... 7 Registration Information ...................................... 8 BBS Support Site .............................................. 8 Turbo File Manager - Page 1 - Packing List: ------------- The following files should be included in this archive. ---------------------------------------------------------------------- TURBOFM .DOC 22349 08-08-92 TurboFM Main Documentation TURBOFM .EXE 32488 08-08-92 TurboFM Main Program SETUP121.EXE 5609 08-08-92 TurboFM Configuration Program REGISTER.TXT 1323 08-08-92 Registration Information ERROR .LST 913 08-08-92 Program Error Codes 100-121 .DOC 1356 08-08-92 Conversion from 1.0(a) to 1.21 WHATSNEW.121 938 08-08-92 Changes from the previous version ---------------------------------------------------------------------- About Turbo File Manager: ------------------------- The Turbo File Manager Program was designed to make the life of a sysop/co-sysop easier. Every aspect of the program has been geared towards making an active file system an easy task to manage. This documentation is an explanation of this program alone. If you do not know how to use the TAG files system or the TAG menu system then you will need to read the TAG manual regarding those features before installing this program. Like so many other utilities, TurboFM evolved to fill a definate need of the Tag BBS sysop. After hearing other sysops request a simple and more effective way of moving files around while logged on to the bbs, the first beta of TurboFM was developed....from there many modifications have been made to the program which have helped it to become one of the best ways to manage your BBS files section area. What this program does is make the files system in TAG much easier to manage. It adds needed commands to the Tag File system that allow you to Move, Delete, Offline, Remove and Erase files using wildcards. Best of all TurboFM is a FAST program. It was one of the biggest concerns to make a program that not only worked well, but one that didn't need input from the user at every step of the way. Many other programs do the same type of things as TurboFM, but unfortunately you were not able to use them while logged onto the BBS and none of them worked from a Remote location while logged onto the system. Worse yet, some of the programs were outdated with the new editions and new features of the BBS software. TurboFM is compatible with all of the new features of Tag 2.6c, such as placing the *.dir files in the Gfiles directory (MultiNode Dir too), and as the sysop you can restrict access to some of the functions of the program. In other words, you could give your co-sysops access to move files but not the access to delete them. But best of all, this program works exactly like the TAG system that you are already familiar with, and you don't have to exit the BBS in order for it to run. Credits: -------- Before going any further, thanks go out to all the people that help with the programming of the TAG BBS software. They have given us a wonderful program to use. The *BETA* testers of TurboFM should also deserve to be thanked for all of thier help and suggestions. Turbo File Manager - Page 2 - Warranty -------- No warranty is expressed or implied. Use this software at your own risk. The author of TurboFM can not be held responsible for the use or misuse of this software. Please read the documentation carefully before setting up this program on your BBS. License Agreement and Copyright ------------------------------- You may freely evaluate this program during the evaluation period as set by the programmer in each release version. The current version will function until Sep. 16, 1992. If you have not registered the program by this date the program will discontinue working. This program may be freely distributed so long as all the original files are left unmodified, no files have been added or removed from the original archive, and no fee is charged. TurboFM is not, and never has been, Public Domain, it is copyrighted 1992, by Royale Software and Mike Normand. System Requirements ------------------- Basically if you have TAG working on your system then TurboFM will work. TurboFM reads the STATUS.DAT file from the directory that it is dropped to when execute the program from a batch file. If the Status.Dat file cannot be found in this directory then the program will not work. This software has been tested to run fine using various versions of DOS and using hardware from a 286 to a 486. If you are having problems with the program and you feel that it is not your own error then please contact me so that I may make any necessary changes. Support Information ------------------- If you need to contact the author regarding any problems or questions with this program, then he may be reached at Castle Royale BBS in Allen Park, MI. Phone 313-382-3996 or Node 1:120/359 on the FidoNet system. A Royale Software Support Echo is available for those who are interested in knowing the latest news and information regarding any of Royale Software's newest TAG BBS utilities. The Echo Tag name is ROYALE_SOFTWARE. If this Echo is not available in your area then it may be picked up from Castle Royale 24 hours a day, providing that prior arrangements have been made. For your convenience, this information will be repeated at the end of this file. Turbo File Manager - Page 3 - Setup Information ----------------- TurboFM is a very easy program to setup on your BBS system. You will need to make a directory off of the Main BBS directory and name it TURBOFM. Place the TurboFM.EXE directory (ex C:\BBS\TURBOFM). Then place the SETUPxxx.exe program in the directory that contains the Status.Dat file. Now run the SETUPxxx.EXE program and the TURBOFM.CFG for this Node will be created for you along with 5 Batch files. The created files are set up to run TurboFM in a directory named TURBOFM located off of the main BBS directory, if you chose to run the program from any other directory you will have to edit the Batch files so that they choose the correct directory. (Multi Node BBS User see the Multi Node section at the end of this text) Now that all of the DOS based setup has been done you will need to load up TAG and make the actual commands on the File System Menu which will start the program. Go into the Tag Menu Editor for the Files area and make five new menu commands. You will then need to edit the commands so that they contain the correct information for each of the five functions of the program. You can set the access levels and flags as you see fit, but the Pkey and Pdata must be entered correctly. Here is an example to follow: Command number : 41 1. Long desc. : TurboFM Move Command 2. Short desc. : (/TM)Turbo Move 3. Key : /TM 4. General SL : 150 5. AR flag : S 6. Program Key : H 7. Program Data : "$?!OPTION-M" F. Flags : SL access, GSL and AR, Normal, No Linking Just repeat this format for the other 4 commands, using the different options (-E,-O,-R,-D). Make sure that you have the $?! part of the command in the correct order. Tag does not like that command segment to be out of order. With this done, TurboFM is setup! NOTE: It is not necessary to use all five of the commands of the program. TurboFM was made specifically so that you, as sysop of the BBS, could determine which commands you wanted to use, and also determine what access to give the commands. Turbo File Manager - Page 4 - Using TurboFM ------------- Using TurboFM is very simple. Once you have the commands setup on your system you simply need to type the key that starts that command. Once you have used the program a couple of times it becomes second nature. This is because every effort was made to keep the same feel that you are already used to. Typing the command /TM (Turbo Move) will produce a statement from Tag that tells you that 'Wildcards accepted' and then it will prompt you for the name of a file. You must then enter the name of a file that is in the directory area that you are currently in. This is no different than the regular Tag program, meaning that if you want to move files from area 3 to area 7 you must be in area 3 and the file that you want to move must be located in area 3. The filename that you type in at the prompt is then passed to the program when it loads. For example, if you want to move all the files that match TAG?????.ZIP you could just enter TAG*.ZIP and the program would then know that it was working with those files. If you type in the name of a file that does not appear in the area that you are in you will be returned to the menu prompt. You can use any combination of asterick (*) or question mark (?) wild card characters to activate the program, even things like *.* are acceptable. Now that you have an idea of how to setup and operate the program, lets examine how the various commands of the program operate in a little more detail. Turbo File Manager - Page 5 - The Move Command ---------------- The TurboFM Move command is the fastest way to move files from one area of the BBS to another area. It uses some advanced logic so that it is able to move the files using the least amount of work, and since wild cards are accepted, it is not necessary to reply to a prompt for each single file move. Upon invoking the Move command you will be shown the list of files that match the filename that you entered. If the files shown are the ones that you want to move then you only need to tell the program what area to move them to and it will do the rest for you. Should you forget the area number that you want to move the files into you can use the ? command and get a listing of all the file areas. (SYSOP NOTE: Users on the system are only shown the file areas that they have access to....so TurboFM works just like TAG in that it uses dynamic numbering, and it allows you to preserve the access of restricted areas). Once you enter the area to move the files to, TurboFM takes over and moves all the selected files into that area. You are not required to reconfirm that you want to move the files again and again, the program just moves them. Please note that it moves all the files that are selected. So if you only want to move a few files make sure that you give the progam the correct file name so that it will only select the ones that you actually want moved. If the move request that you are making required TurboFM to move files from one drive to another (ie C: to D:) then the program will use the filesize from the Tag *.dir file to determine if the selected files will fit on the Target drive. If the files will fit they are moved automatically, however if there is a size problem you will be warned and asked if you want to proceed with the move. The reason behind asking if you wish to proceed comes from the fact that many sysops have thier files offline, but the Tag *.dir files still show the files as if they were actual size. In order to make the program work faster, it reads the file sizes from the Tag file listings rather than from the actual disk drives. Also along those same lines, if the file sizes of the selected files as read from the *.dir file total up to 0 blocks, then those files are assumed to be offline and no effort is made to move the file, only the directory listing is moved to the new area. As an added feature of the program, whenever you move files, the Target area is then sorted into Name/Ascending order. In future versions of the program sorting may be optional, and it may also include the ability to select the method of the sort. For safety sake, (memory wise that is) TurboFM does not attempt to sort an area that has more than 2000 files. If you happen to have one single *.dir file that has more than 2000 files, I would seriously recommend that you split it up into smaller and more manageable sizes. Turbo File Manager - Page 6 - The Offline Command ------------------- This command allows you to mark the selected files as OFFLINE. This is done by setting the blocks file size to zero. Again the wild card characters may be used to select multiple files. This is a nice feature of the program, because most utils that are currently available only allow you to Offline all the files in one dir file. This program will allow you to be more selective. The Remove Command ------------------ This command takes the selected files and removes thier listings from the *.dir file. The files on the Hard Drives are not touched and will remain intact. You are asked to confirm this action before it is performed. The Delete Command ------------------ This command is the exact opposite of the previous command. This one allows you to delete the selected files from the Hard Drive, while leaving the directory information intact. This is useful if you are planning to make files offline. However, the block size of the files is left at its current value, so if you prefer to leave the file sizes intact you will be able to do so. You are asked to confirm this action before it is performed. The Erase Command ----------------- This command is nothing more than the previous two commands combined. The selected files are deleted from the Hard Drive and thier directory info is also removed. As usual, you are requested to confirm this action before it is performed. Log Functions ------------- It is possible to log all of the actions of the program. In order to turn this option on you only need to add a /L onto the end of the command line that is loading the TurboFM program. By making the Log file optional it is possible to log file moves, but to opt not to log file deletions, or vice-versa. The included batch files all have the log file option turned on, so if you do not want the program to log its work then you will have to edit the batch files to remove the /L switch. In registered versions of the program you can choose the path and file name of the log file that you wish to use for the program. Simply enter the path and filename of the log file in the TurboFM.cfg file on the third line of that file. If the file that you choose does not exist then it will be made for you. Unregistered versions log file will be the sysop.log regardless of the information contained in the TurboFM.cfg file. Turbo File Manager - Page 7 - Multi-Node Concerns ------------------- With the release of Tag 2.6c and 2.6c1 there is now a multi-node version of this software, and with that come some interesting programming situations. Since the majority of the BBS systems are still running a single node, it was felt that it would be better to release this program now, rather than waiting until I had the multinode version finished. This program is aware of *.dir files that are located in the Multi-Node directory, so it will work on a multi-node system, but no work has been done to make this a 'Share Aware' program and therefore it is recommended that you only use this program while there are no other users online. Provisions are being made to have a fully multi-node compatible version of this program available soon. Everyone should be reminded that it took the Tag Team about a year to make Tag multi line, so dont get too frustrated if a month or two is needed to make the program work the way it should under a multi user system. Single line BBS systems can use this program 100%! To run the program on a Multi-User system you need to have one TURBOFM.CFG file for every node that you have. Each config file must exist in the same directory as the Status.Dat file for that node. (I am not sure if you have to have batch files for each node at this point, but they are only about 55 bytes each so if you duplicate them it wouldn't be a bad idea) TurboFM works the same way as Tag in that it will search for the User.lst and the Fboards.dat files in the Gfiles directory, and if they cannot be found in that area then they will be looked for in the Multi Node dir. If they still cannot be found then the program will abort. Care must be taken not to use the program while users are on line due to the fact that there are many things that can be done to conflict between the nodes. TurboFM only READS the Status.Dat file, User.Lst, and Fboards.Dat files. They are not written to in any way, so the likely hood of something bad happening to them is remote. However, the *.dir files are heavily manipulated and unforseen things can happen if two people try to access the same file at the same time. Suffice to say that you have been warned....a fully compatible Share Aware version is in the works...just be carefull with this one until that one is completely finished. Again...Single Node systems may use the Program 100% Turbo File Manager - Page 8 - Registration Information ------------------------ Registration for this program is only $10.00. When you are ready to register this program then you will need to send a check or money order to the author for that amount. Include with it the name of your BBS system, exactly as it appears in the Status.Dat file. Also include either your mailing address, or a Fido Net Node number to which an updated config file can be sent. If you provide a Fido Net Node number, the author will pay for the phone call to send you the new config file. Send your check or money order payable to Mike Normand to: Mike Normand P.O. Box 164 Allen Park, MI 48101 BBS Support Site ---------------- Thats all there is to say regarding this utility program. If you have any bugs to report, or if you have any suggestions for the program then you can contact the support BBS. Castle Royale Allen Park, MI - (313) 382-3996 US Robotics 16.8 Dual Standard Modem 2400 - 16800 bps - 24 Hrs / 7 Days FidoNet Address - 1:120/359 If you are interested in picking up the Royale_Software support echo then send a Net Mail message and it will be turned on for you. Enjoy the program!