synchro.net

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

/ synchro.net / synchro.net.tar / synchro.net / modem.madness / SMMPROT / BS200.ZIP / BISEARCH.DOC < prev next >

Wrap

Text File | 1992-04-02 | 12.9 KB | 326 lines

======================= BISEARCH ======================== The original Searchlight to BiModem Interface Copyright(C) 1992 BiBass Software, by Kevin Bass ALL RIGHTS RESERVED. Created with Searchlight Programmer's Library Portions Copyright(C) 1991 Searchlight Software - WHAT IS BISEARCH BISEARCH makes BiModem and Searchlight almost a 100% compatible. What do I mean by almost? Searchlight does not allow passwords to be decrypted. Therefore, BISEARCH can not write previously protected files and their correct passwords to BiModem's password file. However, any files uploaded with passwords with BiModem via BISEARCH will be added correctly to BiModem's password file. - BISEARCH FEATURES Before I list some of BISEARCH's features, let me familiarize you with BiModem. BiModem allows simultaneous bidirectional file transfers. Imagine the time savings if you could upload with Zmodem(tm) and Ymodem-G efficiencies while downloading at the same efficiency simultaneously. If that excites you, how about the ability to chat while the transfer is going on? How about adding file request while transferring other files? How about killing single requests on either the send or receive side? All this at the same time! BiModem allows you to create a large list of upload and download requests before you sign on a bulletin board system. File level password protection is available. When someone uploads a file to a BBS they also can supply a password so that subsequent callers can only access the file if they know the correct password. They also can supply descriptions for files they upload. These are just a few of BiModem's features. Read the documentation that comes with BiModem for more features. Now here are a few of BISEARCH's features: * Updates users stats. Correctly updates the user's upload/download kilobytes and count even if they upload and download at the same time. * File directory protection. Users are only allowed to transfer files to and from directories they have access to. * Download/upload ratio checking. If a user's download/upload ratio has been exceeded, they will only be allowed to upload files, even if they have requested downloads. Page 1 BISEARCH - Copyright(C) 1992 BiBass Software. ALL RIGHTS RESERVED. * Adds uploaded file(s) to file database. The user will be asked what directory they would like to upload to before the transfer starts. Uploads will only be allowed to directories they have access to. After the BiModem transfer is complete, BISEARCH will add the file, password (if provided), description (if provided), file size, date uploaded, and the owner of the file to the directories database. If your system places a default password on files, BiSearch will recognize this. Default passwords override any passwords the user provides with their file. * Prompts for descriptions. The user will be prompted for descriptions if they are not provided. * New file listing. BISEARCH will allow the user to check for new files uploaded since their last log on. This way they can tag files they want to download using BiModem's BIHOT program. * Time out and time limit checking. BISEARCH will detect if a user has been sitting idle for too long. The idle time is read from your BBS configuration file (CONFIG.SL2). It also continually checks to see if the user's time limit has been reached. Users are warned when they have 5 minutes or less remaining. The user's time left is passed to BiModem before the transfers take place. * Updates FILES.LOG. BISEARCH will update your file activity log with transfers done with BISEARCH. Even if the user uploads and downloads at the same time! * Checks for duplicate files. Users will not be allowed to upload files that already exist. * Checks for aborted transfers. If a transfer is aborted, the user's upload/download stats are not updated for that file. They are only charged for successful transfers. Yes, they are not credited for incomplete transfers! * Multi-tasker aware. BISEARCH will write to the virtual screen if a supported multi-tasker is detected. It will give up time slices while waiting for user input. * Searchlight style menus. BISEARCH was designed to look internal to Searchlight Software. AND MUCH MORE! - BISEARCH ARCHIVE FILE CONTENTS The BISEARCH package consists of six disk files. Make sure you have them: (x's donate version number) BSxxx.EXE - The executable file. BISEARCH.DOC - Basic instruction manual for BISEARCH. BISEARCH.KEY - KEY file needed to run BISEARCH. BISEARCH.HLP - Help file for BISEARCH. BIMODEM.CFG - Sample BiModem configuration program. REGISTER.FRM - Registration form for BIBASS SOFTWARE programs. DISTRIB.TXT - Listing of Distribution BBS's for BiBass Software. Page 2 BISEARCH - Copyright(C) 1992 BiBass Software. ALL RIGHTS RESERVED. - COPYRIGHT AND LICENSE INFORMATION BISEARCH and its documentation are Copyright(C) 1992 BiBass Software, all rights reserved worldwide. They may not be circulated in any incomplete or modified form, nor sold for profit, without written permission of the author. The use of BISEARCH is subject to the following terms: PERSONAL USE. Individuals who use BISEARCH must register their copy if they find the program useful. A registration form is provided for your convenience. If you want to be sure of obtaining the LATEST version of BISEARCH, you can download the archive file BSxxx.ZIP from one of the distribution sites listed in the file "DISTRIB.TXT". If you have any questions or comments about BISEARCH, please write. Address all correspondence to the author: Kevin Bass Route 3 Box 368A-1 Quinlan, Texas 75474 USA or contact me at my BBS: KEV'S KORNER (903) 883-4753 Fido: 1:19/107 SLNet: 250:302/233 DISCLAIMER: You undertake to use BISEARCH at your own risk. The author assumes no liability for damages of any kind resulting from the use of BISEARCH. - REQUIREMENTS * MS-DOS 3.1 or higher. * Searchlight 2.0 or higher. * BiModem 1.24 or higher. - SETTING UP BISEARCH 1. Place a copy of BIMODEM.CFG in each nodes home directory. 2. Place BIMODEM.COM, BICONFIG.COM, and BSxxx.EXE in DOSes PATH. BIMODEM.COM and BICONFIG.COM can be found in the latest copy of BiModem (BIMOD124.ZIP). Place BISEARCH.KEY and BISEARCH.HLP in same directory as BSxxx.EXE. 3. BISEARCH configures most of BIMODEM.CFG every time it is run. However, you will need to make a few changes if you meet any of the following criteria (NOTE: Make sure you are in your nodes home directory and run BICONFIG to make these changes. Do this for each node that will be running BISEARCH): Page 3 BISEARCH - Copyright(C) 1992 BiBass Software. ALL RIGHTS RESERVED. * If you encounter a lot of NAKS during transfers and *ARE NOT* running under a multi-tasking software such as DESQview or DoubleDos, select the "GENERAL OPTIONS" area and edit the fields "Replace Timer Interrupt (Y/N)" and "Replace Keyboard Interrupt (Y/N)" so that they say "Y". * If you have a V.32 compatible modem, select the "TERMINAL OPTIONS" area and edit the field "Modem Type" so that it says "F" for Full Duplex. If you have a Dual Standard modem edit it so that it says "D" for Dual Standard. It currently is set at "H" for Half Duplex. HST's can only transfer in both ways at 2400 baud or less. A V.32 or Dual Standard can transfer in both ways at any baud rate. If you have a MNP or have locked your comport, set the "CTS/RTS hardware flow control (Y/N)" field to "Y". If you want to base carrier loss on a drop of the carrier detect line from the modem, set the "Signal Loss of carrier on Carrier Detect (Y/N)" field to "Y". If you want to base carrier loss on a drop of the data set ready line, set the "Signal Loss of carrier on Data Set Ready (Y/N)" field to "Y". 4. Since Searchlight Passwords can't be decrypted, you will need to create a file called "BISEARCH.PWD" in each nodes home directory, listing files that are password protected on your BBS and their password. This file can contain up to 500 entries. Any files uploaded after BISEARCH is installed will be added to BISEARCH.PWD if a password is provided with the file. The syntax for this file is the following: FilePath,Password(C/R L/F) EXAMPLE: BS200.ZIP,NICE PROGRAM JOEBLOW.ZIP,MISSING 5. Make an ABORT subdirectory off each one of the directories you allow files to be uploaded to. This is where BiModem will put aborted transfers. 6. Edit your AUTOEXEC.BAT so it contains the SLBBS environment string. EXAMPLE: SET SLBBS=C:\BBS - DOORS.DEF CONFIGURATION - 1;0;1;<access level>;BiSearch - BiModem interface;.;BSxxx - MENU COMMAND SETUP - 1. Command Name ................ BiSearch * 2. Command Key ................. 3. Description ................. BiModem Transfer Area * 4. Minimum Access Level ........ * 5. Maximum Access Level ........ * 6. Required Attributes ......... * 8. Preference Attributes ....... Page 4 BISEARCH - Copyright(C) 1992 BiBass Software. ALL RIGHTS RESERVED. * 9. Help Levels ................. 10. Door Command ................ BSxxx 11. Directory Path .............. [leave blank] 12. Communication Support ....... Standard 13. Abort Method ................ Terminate 14. Write Protection ............ No 15. Parameter File .............. None 16. Pause After Door ............ No * Your decision ** NOTE: Important ** If you run more then one node, you will need to run BISEARCH from a batch file. However, you will need to set the SLBBS environment string for that node first. EXAMPLE: SET SLBBS=C:\BBS2 BSxxx.EXE - BISEARCH HELP FILE BiSearch comes with a default help file (BISEARCH.HLP). You may edit this file to say anything you want. BiSearch will recognize Searchlight color codes and the '%%FILENAME' directive, so you may use these. The file can be as long as you want. - HOW DO I REGISTER MY COPY OF BISEARCH? If you use BISEARCH longer than 30 days, you need to register your copy. Please fill out the registration form (REGISTER.FRM) and send to me along with your payment. Please contact me via modem when you have sent the payment off so I can be expecting it. Upon receiving your registration fee I will create a registered KEY file for you to download from my BBS. If you are FIDOnet or SLnet compatible, I will NETmail your key to you. It will contain your registration number and BBS Name. - ACKNOWLEDGMENTS * Turbo Pascal is a trademark of Borland International, Inc. * Searchlight is a trademark of Searchlight Software by Frank LaRosa. * IBM is a trademark of International Business Machine Corporation. * MS-DOS is a trademark of MicroSoft Corporation. * BiModem is a trademark of Erick Labs. Page 5 BISEARCH - Copyright(C) 1992 BiBass Software. ALL RIGHTS RESERVED.