home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Media Share 9
/
MEDIASHARE_09.ISO
/
pcboard
/
swop145i.zip
/
SWOP.DOC
< prev
next >
Wrap
Text File
|
1992-06-23
|
17KB
|
356 lines
╔════╗
║ ╩
║
╚════╗ ╦ ╦ ╔════╗ ╔════╗
║ ║ ╦ ║ ║ ║ ║ ║
╦ ║ ║ ║ ║ ║ ║ ║ ║
╚════╝ ╚══╩══╝ ╚════╝ ╠════╝ Version 1.07
║
║
╩
CopyRighted 1992 by
PC-2-PC COMMUNICATIONS CC
══════════════════════════════════════════════════════════════════════════════
A door for a PCBoard Version 14.5a 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)
(FAX) : (011) 391-2349
╔═══════╗
║ 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 require any registration's at
all. The software is not crippled in any way. Should you wish to
have the latest copy of this door, you may call our BBS in RSA at
(011) 391-3627. It is in the SYSOP's conference on the BBS.
╔═════════════════════╗
║ SYSTEM REQUIREMENTS ║
╚═════════════════════╝
Hardware : IBM Compatible, modem, hard-drive, ect.
Software : PCBoard Version 14.5a BBS software
Memory : The available RAM required to run this door is 110 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 Shell Path to Batch Files
══════════ ════════ ═══ ═════ ════════ ════════ ═════ ════════════════════
1) SWOP 0 N Y N Y <path for SWOP>
Save it now. (Take note of Y under USERS.SYS)
The Y under Shell may be N or S, only affect the PCB opperation.
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 ex: C:\PCB>
EXIT <if you shelled else BOARD if you did not shell>
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
Z:\PCB\DOORS\SWOP\SWOP Z:\PCB\DOORS\SWOP\SWOPPWRD
EXIT <== Make "BOARD" if Shell is set to "N".
╔════════════════════════════════════╗ PAGE 4
║ SYNTAX AND PARAMETERS FOR SWOP.EXE ║
╚════════════════════════════════════╝
Syntax: SWOP <full path for SWOPPWRD> <\S>
<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.
<\S> : If \S is specified, the door returns with an message
"Returning back to BBS.....".
If \S is NOT specified, no message is given on return.
Any or all parameters may be left out, no "must" for any parameter.
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 Com4.
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. Correct updating of callers log, to see what the user did
while he was inside the SWOP door.
13. Allow the user to re-display the screen, if the screen was
garbled.
14. 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.
15. 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.
16. Allow the user to trade time in for more bytes to download.
17. Allow the user to trade bytes in for more time on the system.
18. 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 only, without the need to drop
to DOS, to run a special editor
19. 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.
╔════════════════════════════════╗
║ LIST OF FILES AND DESCRIPTIONS ║
╚════════════════════════════════╝
Only two files were issued along with SWOP145I.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.
19 January 1992 : "SWOP145H.ZIP" - Version 1.06
1. We added the Bytes/Minute information on the
Main Menu screen. Seems like the users don't
like to read our "fancy" help screen ..grin..
2. Removed the "Returning to BBS ..." notice,
after the user is done with the door. (Default)
3. Added a parameter "/S" for incase you want the
message "Returning to BBS..." to be displayed
to your users when they are done with the door.
4. Added a feature to provide information inside
the callers log, of what the user done while
he/she used the swop door.
30 June 1992 : "SWOP145I.ZIP" - Version 1.07
1. The door forgot to look at a users expiry date.
This meant that if a subscribers, subs period
has expired, the door kept on working on it
subscription security level, instead of the
expired security level. --fixed--
2. The door allways gave a user one extra minute
if a user entered, and exited from the door.
Problem now solved.
- THE END -