Beijing Paradise BBS Backup

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

/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / SWOP145G.ZIP / SWOP.DOC next >

Wrap

Text File | 1991-12-20 | 15.5 KB | 345 lines

╔════╗ ║ ╩ ║ ╚════╗ ╦ ╦ ╔════╗ ╔════╗ ║ ║ ╦ ║ ║ ║ ║ ║ ╦ ║ ║ ║ ║ ║ ║ ║ ║ ╚════╝ ╚══╩══╝ ╚════╝ ╠════╝ Version 1.05 ║ ║ ╩ CopyRighted 1991 by PC-2-PC COMMUNICATIONS CC ══════════════════════════════════════════════════════════════════════════════ A door for a PCBoard Version 14.5 BBS software. This door allows a SYSOP to provide his users with a facility to SWOP their time available for more bytes, or, to swop their bytes available for more time. ══════════════════════════════════════════════════════════════════════════════ PC-2-PC COMMUNICATIONS is situated in South Africa. BBS tel. no's : Node 1 - (011) 391-3627 (2400 bps) Node 2 - (011) 391-3628 (2400 bps) ╔═══════╗ ║ INDEX ║ ╚═══════╝ Opening words............................... 1 System requirements......................... 1 Installation................................ 2 Syntax and parameters for SWOP.EXE.......... 4 Features.................................... 5 A special word about Base Baud Rate......... 6 What if you do not registered as a user..... 6 List of files with descriptions............. 6 History of the program releases............. 7 ╔═══════════════╗ PAGE 1 ║ OPENING WORDS ║ ╚═══════════════╝ This software, along with its documentation is CopyRight by PC-2-PC COMMUNICATION CC. You may not alter anything inside the program, and/or the documentation. This software is being distributed under the Public Domain concept. This means that you as the user are allowed to use the program for as long as you like. We do not force you to register the software, however, if you find that you like the program, you are encouraged to register yourself as a user with a R40.00 contribution. Registered users do not get any special previledges above those not registered, nor do they get some better changed release of this software if they did register. But take note that we written this software for those guys that use it, and contribute if they like what they see, even though they aint forced to do so. ╔═════════════════════╗ ║ SYSTEM REQUIREMENTS ║ ╚═════════════════════╝ Hardware : IBM Compatible, modem, hard-drive, ect. Software : PCBoard Version 14.5 BBS software Memory : The available RAM required to run this door when out of PCBoard is 100 kB. Networks : On a network, ensure that file-server has some sub-directory, accessible to all nodes. This is where the security-access "SWOPPWRD" file would be referenced to as a parameter. Other : A VERY HARD WORKING SYSOP!!!!! ╔══════════════╗ PAGE 2 ║ INSTALLATION ║ ╚══════════════╝ This section is placed so early in the documentation so that you do not have to read about an half an hour, before you find the installation part. First we have to mention the following: If you really hate reading documents, you could always just run the program direct from the DOS prompt, and it would lead you to install it correctly. Now, here is a proper description of how to install this door. No fancy stuff required with the SWOP door. Just follow the following steps one by one: 1. Ensure that you have somewhere in your Path statement located usually in the AUTOEXEC.BAT file, a path stating the location of your PCBOARD sub-directory, or just simply make sure you do change the directory in the file SWOP(created by yourself) to the PCBOARD sub-directory, before calling SWOP.EXE. 2. Now go to your PCBoard sub-directory, and run PCBSETUP. 3. Select either J Main Board Configuration or K Conferences. Conferences in the case if you plan to install SWOP door inside a specific conference only. 4. Select now under Doors: "Path/Name List File" and select your DOORS.LST file with 'F2'. 5. Go to the last entry and enter 'Alt-I' to add this door, and enter stuff as follow: Filename Password Sec Login USER.SYS DOOR.SYS Path to Batch Files ══════════ ═══════════ ═══ ═════ ════════ ════════ ════════════════════ 1) SWOP 0 N Y N <path for SWOP> Save it now. (Take note of Y under USERS.SYS) 6. Select now under Doors: "Menu Listing" your DOORS menu file and add the SWOP door listing in your menu. PAGE 3 7. Now create the SWOP file at the location you specified in step (5) five. Not SWOP.BAT, as PCBoard expects you to have the batch file commands in a file for himself, without the "BAT" extension. PCBoard will create its own DOOR.BAT file, to eliminate a possibility of share violations if you had a Network installed. Inside the SWOP file enter the following commands ECHO OFF CD <location of SWOP.EXE ex: C:\PCB\DOORS> SWOP <location of "SWOPPWRD" ex: Z:\DOORS\SWOPPWRD> CD <back to PCBoard sub-directory> BOARD That's it folks, the minimum requirements is above to get your door up and running. Here is what our SWOP file looks like on our BBS: @ECHO OFF CD\PCB\DOORS\SWOP SWOP Z:\PCB\DOORS\SWOPPWRD CD\PCB BOARD ╔════════════════════════════════════╗ PAGE 4 ║ SYNTAX AND PARAMETERS FOR SWOP.EXE ║ ╚════════════════════════════════════╝ Syntax: SWOP <full path for SWOPPWRD> <Full path for SWOPPWRD> : This means that we want you to specify the exact path and name of the SWOPPWRD file. (SWOPPWRD gets created by the door) This is very important if operating in a networking environment. Parameters is not case sensitive. REMEMBER: Set the USER.SYS flag inside DOOR.LST to yes!!!!! ╔══════════╗ PAGE 5 ║ FEATURES ║ ╚══════════╝ 1. Support from Com1 up to Com8. 2. Support from 300 baud up to 115,000 Baud. 3. ANSI Emulation, without the need of ANSI.SYS in CONFIG.SYS 4. Auto detection of the com port in use, and baud rate. 5. Detection of Data Carrier Detect. The door will recycle back to PCBoard, in the case of a Carrier Lost, while in the door. 6. Auto adapt to the bell flag the SYSOP has setted, to ensure that if the flag was set to off, the door do not send bell sounds to the local speaker. 7. Auto detection of keyboard time-out period as setted inside PCBoard. Your user will be exited back to PCBoard if he does not press a key within your specified time limit. 8. Filtering of characters. This ensures that most line noise usually over the line is filtered out. 9. Multiple commands accepted if entered at command line, just the same as with PCBoard. 10. Allow the user to change between Graphics and normal mode. 11. Give help information to users that need it. 12. Allow the user to re-display the screen, if the screen was garbled. 13. Will not allow a user with unlimited bytes facility to trade bytes or time. A user with unlimited bytes would otherwise have been able to have unlimited time as well. 14. Will not give access to a user, if the SYSOP has setted the bytes/minute to 0 bytes. An way to stop certain users to use the facility if the SYSOP wishes to do so. 15. Allow the user to trade time in for more bytes to download. 16. Allow the user to trade bytes in for more time on the system. 17. Allow the SYSOP to set a bytes/minute, min time left, and a base baud rate for every security level individually. All this from the local console, without the need to drop to DOS, to run a special utility. 18. Ability to let the bytes/minute change according to the users connect speed. (Bytes/Minute = Bytes/minute * Base Baud rate / Connect speed.) ╔═════════════════════════════════════╗ PAGE 6 ║ A SPECIAL WORD ABOUT BASE BAUD RATE ║ ╚═════════════════════════════════════╝ The base baud rate give you the facility to let the bytes per minute change according to the connect speed of your user. (This is one of the configuration facilities as in item 18 on previous page) { Bytes per minute = Bytes per minute * (Base Baud Rate / connect speed) } Assume the following setting were inside the SWOPPWRD file. Bytes per minute = 10000, Base Baud Rate = 2400 Connect speed | Calculation of new Bytes per minute ==============|=========================================================== 300 baud | Bytes per min = 10000 * (2400 / 300) = 80000 1200 baud | Bytes per min = 10000 * (2400 / 1200) = 20000 2400 baud | Bytes per min = 10000 * (2400 / 2400) = 10000 9600 baud | Bytes per min = 10000 * (2400 / 9600) = 2500 19200 baud | Bytes per min = 10000 * (2400 / 19200) = 1250 The higher the connect speed, the lower the bytes per minute. Only here encase some of wanted it. However, if you think carefully about it. A user could fool you easily in such a case by connecting at 300 baud. Swop 10 minutes to receive 800,000 bytes. Log-off, call in at 19200 baud, and download the 800,000 bytes within a few minutes. It is therefor not recommended to use the Base Baud Rate facility. Like I said, only here encase some of you insist on it. ╔═════════════════════════════════════════════╗ ║ WHAT IF THE YOU DO NOT REGISTERED AS A USER ║ ╚═════════════════════════════════════════════╝ Then nothing. If you do not register as a user, all we can say is, good luck, and we hope you like the door. Many people can not because their budget is not so great. Others can not because they don't have the time to get to the post office. So if you do not register, don't worry. Your copy will still work 100%, their is absolute no crippeling in this door. ╔════════════════════════════════╗ ║ LIST OF FILES AND DESCRIPTIONS ║ ╚════════════════════════════════╝ Only two files were issued along with SWOP145G.ZIP SWOP.DOC - You are reading it right now. SWOP.EXE - The actual door program. ╔═════════╗ PAGE 7 ║ HISTORY ║ ╚═════════╝ 01 December 1991 : "SWOP145A.ZIP" Initial release of the SWOP door. 06 December 1991 : "SWOP145B.ZIP" - Version 1.0 Same as for 01 December 1991, but is called Version 1.0. With this version we removed all crippling that was in previous release. 10 December 1991 : "SWOP145C.ZIP" - Version 1.01 Program was unable to detect that it is the SYSOP on-line, if the SYSOP has entered his name in PCBSETUP with non-capital letters. This meant that in this case, the sysop would not be able to change the security configuration from the local console as he is suppose to do. Fixed this by making the program not to be case sensitive when checking for the SYSOP's name. ooops... 12 December 1991 : "SWOP145D.ZIP" - Version 1.02 Somewhere we did something wrong in vers. 1.01 The program was suddenly unable to transmit characters over the comms port. Sorry.... fixed now. 16 December 1991 : "SWOP145E.ZIP" - Version 1.03 Still the same old problem that the program is unable to transmit characters over the comms port. This was because we tried to get clever with software flow-control (XON/XOFF), and hardware flow-control (CTS/RTS). We now removed the ability to adapt to the hardware/software flow control. We now take the comm port as left by PCBoard, and return it back the way we received it. Seems like this solved our problem. Let us know if anyone with an error-correcting modem experience some problems, although we expect to hear every one is happy with it, the way it is now. 19 December 1991 : "SWOP145F.ZIP" - Version 1.04 The door had a problem that it gets an runtime error, as soon as it was installed for the first time. It was because we attempted to delete a file, that was still open. This is now fixed, thanks to the thorough investigation of Joaqium Inacio from VC BBS at (011) 435-3922. Thank you for your patience George. 20 December 1991 : "SWOP145G.ZIP" - Version 1.05 1. Removed the [NOT REGISTERED] handicap if not registered. We now no longer force you to register. We now ask you politely to register "yourself" as a user, and not to register the "program". So, as from this release the program will allways be as if it is registered allready. 2. All previous programs, registered or not, would only be able to opperate under PCBoard 14.5. As from this release, it is programmed to allready accept the new formats of PCBoard vers 15.0 and higher. 3. Also we done some "fine-tuning", that resulted into the fact that the program code was decreased with at least 3400 bytes. - THE END -