home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.wwiv.com
/
ftp.wwiv.com.zip
/
ftp.wwiv.com
/
pub
/
DOOR
/
CST58.ZIP
/
CYBER.DOC
< prev
next >
Wrap
Text File
|
1995-02-18
|
34KB
|
826 lines
CyberSpace Transporter
(C) Copyright 1993-1995 Frances Decatur
All rights reserved
Version 5.8
Feb 14, 1995
This documentation and associated programs are the property of
Frances Decatur.
What's NEW
====================================================================
Online registration with your Credit Card via modem at:
The Circuit Board 717-676-9339 (Main support BBS)
Midnight Connection 718-357-0429 (Registration Site)
v5.8
CST will remember the time a user is in the door, if adjtime.cfg
is created by the sysop. (see adjtime.cfg)
v5.x
Enhanced local screen while a script file is running.
Added a new Script commands!
Some systems have been having problems getting to the Command:
prompt on Autonet. The "*" command makes this easier!
* Expect text and send a CR every 2 seconds
*password:
CST will wait until it recieves "password:"
It will send a CR every 2 seconds until it sees
the string your expecting.
This is useful for ADP's Autonet Login and
some Unix system login's.
^ Expect text and wait 15 seconds then skip
^menu?
CST will wait 15 seconds for "menu?". If it
sees "menu?" it will send a CR. If not it will
skip and return to the next script command.
Problems & Technical Support??
====================================================================
Reading the docs because your having problems?
In order to serve you better and faster I will need the following:
CONFIG.SYS, AUTOEXEC.BAT, CYBER.CFG, CYBER.BAT (or the batch file
you use to load the Transporter), a DOOR.SYS or DORINFOx.DEF (which
ever you use) generated by your BBS, an explnation of the problem
to include:
Exactly what does it do or not do!
What is on your screen!
What message does CST display!
What modems do you use?
What Com ports?
Address and IRQ for each port!
Any other info you may find important.
When you have this all together, Zip-ARJ-Whatever it into 1 file
and crash mail to 1:268/348 or attach them to email (upload) on
The Circuit Board 717-676-9339
Most problems can be handled in this manner.
Voice support is available to registered and non-registered users
only through the BBS #. Logon and page the sysop. I will usually
be available 8am - 10:30am and 7pm - 9pm.
I'LL DO MY BEST TO GET YOU RUNNING! At the time of this writing 99%
of all problems reported have been resolved. The 1% didn't bother to
follow up, may be up and running, or may have fallen through the
cracks?
If your getting an ERROR "62" check your *.cfg files. One of them
is too short, and therefore wrong. In some cases the DOOR.SYS has
been found to be too short.
If your using the X00 fossil driver, you map ports as follows:
X00 E 0=add,irq 1=add,irq 2=add,irq etc,etc
where..
0=COM 1 \
1=COM 2 \
2=COM 3 > if they exist
etc /
etc /
add=Hex address of the port (ie:3F8,2E8,etc)
irq=Dec IRQ of the port (ie:3,4,5,7,whatever)
1.0 What is CyberSpace Transporter?
====================================================================
CyberSpace Transporter is a door that allows your users to call
out to other systems on a second modem and phone line. Most of
your callers may be long distance to BBS's that are local to you.
So now you can actually save your users some REAL MONEY. And
maybe make some for yourself.
1.1 What is Shareware?
====================================================================
The shareware concept is great for both programmer and the end-
user. The programmers can distribute their product without
getting involved in expensive marketing or advertising. The end-
user benefits by receiving a full-featured program, usually
better than the commercial competition, and support available
directly from the author. But it only works if the end-user
participates in the shareware concept.
Shareware is not free. After using the CyberSpace Transporter
for a 30 day trial period, you must pay for continued use of
the program. I have worked hard to produce a good program,
and the price is very fair. Especially considering that many of
your users could save more than the price of registration...
EVERY MONTH!!
CyberSpace Transporter will only allow 10 minute calls until
it's registered! Along with some annoying delays!
1.2 Support
====================================================================
If your having problems setting up and running CyberSpace
Transporter, support is available!
(see the beginning of this document)
* The Circuit Board Feedback 717-676-9339
* Internet cst@cktbd.de.com
Compuserve 72510,2363
* FIDOnet Sysop@1:268/348
* Midnight Connection 718-357-0429 6 Lines 14400
* Mail read daily.
# Latest version will always be available here. Freq CST.ZIP
Voice support is available ONLY when there is no other way.
1.3 Disclaimer
====================================================================
CyberSpace Transporter and all support files (REGISTERED OR
UNREGISTERED) are provided on an "AS-IS" basis with no
warranty. Frances Decatur cannot accept responsiblity for loss
of data, profit, or any damages which are incurred by the use
of this program or any support files.
1.5 Modem Info
====================================================================
CyberSpace Transporter requires that all highspeed modems be
set for RTS/CTS handshaking.
Your modem should be set to reflect the TRUE state of carrier
(not forced true) and dropping DTR must hang up the modem!
!!-------------------------------------------------------------!!
NOTE: If CST reports the "MODEM is in use", and it
is not. Then this is not been set! Sending AT&C1
to the modem and saving it will solve this problem.
This command is the only command CST cannot send to
modem itself, as if a carrier is persent it WILL
NOT use that port. Using the command AT&F ANYWHERE
even in other programs will reset this. If you MUST
use AT&F in any program that uses the modem then
use AT&F&C1&D2.
If CST does not hang up the modem, then AT&D2 should
be sent to the modem. This could be done in the dial
string. IE: AT&D2DT or AT&D2DP
!!-------------------------------------------------------------!!
If you setup your system with a highspeed modem and a 2400 modem,
your DOOR.SYS must have line 2 as "actual connect rate" and line 5
as locked port speed. If your BBS does not write DOOR.SYS in this
way, 300 & 1200 baud callers (if any) may have data loss
problems.
DOOR.SYS is the only drop file that will report both the callers
connect rate and the actual port speed. This is why DOOR.SYS
is used.
CST will also support DORINFOx.DEF dropfiles. Because dorinfo.def
files do not support both callers connect rate and modem to
computer rate, results may be unpredictible. Problems may arise
if you use a high speed modem and a 2400 baud modem. If your
modems both support rts/cts handshaking CST should function just
fine.
1.6 MultiLine BBS's
====================================================================
CST can be setup to share modems with other BBS nodes.
CST will first check to see if a carrier is present (if the node
is in use). If it is, the user of the Transporter will be informed
the modem is in use and the program will terminate. If not, the
Transporter will execute the command specified in the CYBER.CFG
file to close a window. When it is through it will execute the
command specified to open the window.
This has been tested under Desqview. In other operating systems
you would need to find utilities to shutdown and re-start the BBS
program that is also using the modem CST will dial out on.
!!-------------------------------------------------------------!!
NOTE:
If a user dials out and the modem resets and hangs up,
VERIFY the BBS Node that is using the modem has been
shutdown. In most cases if CST dials out and a BBS node
is still running on that modem, the BBS software will
reset and hang up the modem!
!!-------------------------------------------------------------!!
Desqview utilities:
I have tested the Transporter using the following...
DVSI's KILL.COM to close the window.
KILL <# of the window>
DVUTIL to open the window
DVUTIL -o <pif keys>
Both of these utilities are avalable on The Circuit Board as
well as many other BBS's
DVSI and DVUTIL are NOT part of CyberSpace Transporter! They
are seprate utilities by different authors. Other utilities
may be available these are just the ones I have used to test
this feature.
If your running a mailer or for some reason want to prevent
CST from closing a window see 1.7 Closing the transporter.
1.7 Closing the Transporter
====================================================================
Creating a file called NOT.NOW in the cyber directory will close
the Transporter. A user can enter the door and go to the menu.
But when he chooses a system to call, will be informed the
transporter is closed.
It does not matter what is in the file as long as it exists.
A simple way to create one would be:
dir >>c:\cyber\not.now
This can be used to close the transporter for any reason, such as a
mailer tossing, etc. If your sharing your voice phone line you may
want to set this up as an event during peak voice call hours. CST
does NOT answer the phone if it rings.
2.0 Setting up
====================================================================
The first thing you need to do is create a directory where
CyberSpace Transporter will live. [ie: c:\bbs\cyber]
Copy CYBER.EXE and CYBER.DOC to the directory you just created.
Create a batch file to load CST.
Example:
c:
cd\bbs\cyber
cyber cyber.cfg
c:
cd\bbs
!!-------------------------------------------------------------!!
NOTE:
If you don't usually load a FOSSIL then you can load and
unload it here.
!!-------------------------------------------------------------!!
2.1 Configuration CYBER.CFG
====================================================================
For ease of installation CYBERCFG.EXE has been included. It will
Help you make a CYBER.CFG file correctly. (I hope so anyway)
Just run CYBERCFG in the cyber directory. Advanced options can
be installed with a text editor.
CYBER.CFG is a simple text file and can be created with any
text editor.
CYBER.CFG:
40 <-security level change for trial function
The Real Cool BBS <-Your BBS name
2 <-COM port to dial out on
CONNECT <-CONNECT STRING string (dial out modem)
2400 <-max speed of outgoing modem
d:\vbbs\door.sys <-full path to DOOR.SYS or DORINFOx.DEF
ATM1DT <-dial string
Y <-Hangup during transport (Y/N)
WARNING ->** 255 <-min security to enter any phone #
N <-use opn/cls hooks for Desqview(Y/N)
kill 3 <-close window command
dvutil -o v2 <-open window command
AT&D2 <-additional string sent b4 dial str
5 <-seconds to delay after above is sent
NOTE:
The additional string will be sent to the modem before
the dial command and system number. This can be used
to send init strings, or anything common to all systems.
The delay must be long enough for the modem to finish
executing the string before the regular dial string is sent.
Say you send "AT&D2DT18005551212,,,,9;" to the modem using
the additional string. The delay MUST be long enough for
the modem to dial and process all the delays (,) before the
regular string is sent. Otherwise the modem will never
process the regular dial command.
WARNING ->** This entry will allow a user to enter any phone number
at all!! Including long distance and international numbers.
To restrict this by security level create a text file named
seclevel.any
In this file list the 1st 3 numbers a user with that sec
level can dial. One per line.
example for security level of 20:
20.any:
676
839
894
In this example any user with a security level of 20 will
be able to enter any phone number beginning with 676, 839,
or 894. If the first 3 numbers of the number he wants to
dial are not any of these 3, CST will return to the main
menu.
SYSTEM.CFG holds the names, numbers, and security level of
each system you make available to your users. A max of 255
systems can be specified.
SYSTEM.CFG:
Brinkman's Hollow <- 1st system name
6893123 <- phone #
20 <- access type
Pocono <- 2nd system name
8394055 <- phone #
20 <- access type
etc
etc
etc
Accesss Types
-------------
number Access by Security Level
------
Place a number here and CST will compare it to the users
secutity level
@ Access by Password
-
"@password" the user will be prompted to enter an access code.
this code is whatever follows the @
example:
Cool BBS
555-1212
@Cyber
In this case when a user attempts to call the Cool BBS, he will be
prompted to enter an access code. If the used does not enter
"Cyber" (case sensitive) then he will be informed he does not
have access to that system.
* Access by list of names
-
Cyberspace Transporter will look in the cyber directory for
a file named <System # as appears in menu> If this file has the
users name (case sensitive to name in door.sys) it will allow him
to dial that system.
example:
system.cfg -
un cool bbs
555-2121
20
real cool bbs
555-1212
*
2.dat -
Joe User
Jim Decatur
John Doe
In this case Joe User, Jim Decatur, and John Doe are the only
users that will be able to access real cool BBS.
% Access via Script File
-
usage: %name
"name" being the name of the files with out extention. CST will
look in the cyber directory for "name".scr and "name".dat
.dat this file should list the names of users who have access
to this system. One per line. It is case sensitive (to the
user name in DOOR.SYS)
The word ALL on any line will open the system to all.
.scr this is the script file. CST will dial the number and upon
connection look to this file for instruction. Nothing will
be passed from the BBS to the user (except # commands) until
this script has finished. This is a text file and one command
per line.
Script file commands:
! Expect text
!password:
CST will wait until it recieves "password:"
* Expect text and send a CR every 2 seconds
*password:
CST will wait until it recieves "password:"
It will send a CR every 2 seconds until it sees
the string your expecting.
This is useful for ADP's Autonet Login and
some Unix system login's.
^ Expect text and wait 15 seconds then skip
^menu?
CST will wait 15 seconds for "menu?". If it
sees "menu?" it will send a CR. If not it will
skip and return to the next script command.
@ send
@abcd
CST will send "abcd" plus a carriage return to
the transporter modem only.
# send user
#Please Wait
CST will send "Please Wait" plus a carriage return
to the USER only.
$ send ascii #
$10
CST will send the ascii character = to the ascii code
10 to the bbs.
see an ascii code chart.
% delay
%10
will delay 10 seconds and send "." to the user
every 5 seconds.
The following examples have been included in CST55.ZIP:
CIS.SCR for connecting to Compuserve via CIS network
DELPHI.SCR for connecting to Delphi via SprintNet
Edit the username and passwords for your application.
& Access Script file then dial #
-
This is almost the same as a regular script file. Difference being
this will execute the script file first, then when it has completed,
dial the number in systems.cfg.
This is useful for accessing Bell Alantic Ultra Call Forwarding
services, and the reason it has been included. It may also be
useful for sending specific information about a BBS before the
number is dialed via a script file.
!!-------------------------------------------------------------!!
NOTE:
The file WERKS.SCR (included) shows an example of
using Bell Alantic Ultra Call Forwarding to access
a BBS system.
!!-------------------------------------------------------------!!
A file called RESET.ME will be droped in the cyber directory when
this option is used. I have my cyber.bat check for this file and
open a new DV window to run a utility to reset the Call Forwarding
number back to my bbs. This is a very small file, and if you find
you have no use for it you can have your cyber.bat delete it or just
leave it there.
Access assistance for networking
--------------------------------
If the mailer a sysop uses for FIDO, QWK, or other types of
networks is capable of using log-on scripts, it is possible that CST
will be able to assist in lowering their costs!
After the copyright screen CST will look for the file "NETWORK.DAT",
if it exists in the cyber directory CST will check to see if the
users name is in the file. If so, it will send the INTRO.ANS/ASC
screen and bypass the menu screen and dial the system found in
NETWORK.DAT.
After the call is completed it will display the EXIT.ANS/ASC and exit
the door.
!!-------------------------------------------------------------!!
NOTE:
This is also useful if you use CST to access only 1
system, such as an Internet provider. You could also
setup CST in 2 different directories, 1 for normal use
and 1 to provide access to a specific system.
!!-------------------------------------------------------------!!
format:
User Name (case sensitive to name in door.sys)
System # from menu to dial
Username
system #
etc
etc
!!-------------------------------------------------------------!!
NOTE:
You can also use the word ALL!
!!-------------------------------------------------------------!!
Restrict Individual Users
-------------------------
You may also restrict individual users from any system by
creating a file <System # as appears on menu.rst> in the
cyber directory.
example:
system.cfg -
Circuit Board
676-9339
20
1.rst -
Joe User
John Doe
In this case any user with a secutity level 20 or higher can
call Circuit Board. If John Doe or Joe User try they will be
informed that that system is restricted.
Adjusting users time by Security Level
--------------------------------------
You may find CST to become so popular that users will dial into
your BBS and just use the Transporter! If this bothers you, then
you can restrict the time they can use in this door.
Create a text file called ADJTIME.CFG in the cyber directory. If
this file exists it will adjust the users time as indicated in
that file.
format:
sec level
max time
example adjtime.cfg:
255
60
for all users with secutity level of 255 there time will be adjusted
to 60 minutes or whatever time they have left. (whichever is less)
To track the users time for the rest of the day CST will create
ADJTIME.DAT in the directory it is in. This file MUST be deleted
as a system event every night!!
Introduction and Exit Screens
-----------------------------
If you wish to have introduction and exit screens displayed to the
users just create:
INTRO.ASC .asc = ascii screens
INTRO.ANS
EXIT.ASC .ans = ANSI screens
EXIT.ANS
Custom Menus
------------
CyberSpace Transporter has it's own internal menu's. You can
create your own ACSII and ANSI menus and CST will use them
if they exist. If CST cannot find any menu it will use it's
internal menu.
Create a menu using your ANSI editor or text editor. Name it:
M####.ANS or M####.ASC
Where #### is the security level of the user. use ".ANS" for
ANSI menus and ".ASC" for ASCII menus.
example:
m1.ans <-- will display to user with a security level
of 1 on your BBS and if he is using ansi
m25000.asc <-- will display to user with a security level
of 25000 on your BBS and if he is NOT
using ANSI
The system numbers you list in your custom menu should reflect
the position of the system as it is in SYSTEM.CFG. (or in the
internal menu)
Also the commands Q to quit and E to enter any phone number
should be placed in your menu.
If any menu is not found in the cyber directory, CST will
use it's own internal menu's.
7E1 Suppport
------------
If the system you are connecting to is at 7E1 (7 bit word - even
parity - 1 stop bit) then you will need to add "7E1" (without
the quotes) to the beginning of the number in SYSTEM.CFG.
!!-------------------------------------------------------------!!
NOTE:
This may be the case for many Unix based systems, some
Internet providers, and some networks.
!!-------------------------------------------------------------!!
example system.cfg:
Real Cool Unix Machine <-- System Name
7E1555-1212 <-- number preceeded by 7E1
10 <-- security level
If you also have special modem commands in the phone number string,
the 7E1 MUST be the first 3 characters.
The user should not have to set his terminal to 7E1, as they will
be converted to 8N1.
Trial Accounts
--------------
You may charge for or require something from a user to access
the Transporter on your BBS. In this case you may want to be able
to offer a free trial.
CST will read TRIAL.DAT for the users name and date. If the date
has not passed then the users security level will be adjusted to
the security level specified in the first line of CYBER.CFG. This
adjustment is only in effect in CyberSpace Transporter and will not
change the users security level in your bbs userfiles.
example trial.dat
Jim Decatur
10-10-1994
Joe User
01-01-1994
In the above examples Jim Decatur will have his security level
raised to the value of the first line of your CYBER.CFG until
10-10-94. On that date he will have his usual security level
while in CST. Joe User will have his sl raised until 01-01-94
NOTE THE FORMAT of the date in trial.dat MM-DD-YYYY
2.3 Do I really need to get another phone line?
====================================================================
NO!
The Transporter shares my voice line on The Circuit board.
When the Transporter attempts to dial out if the modem reports
NO CARRIER the user will be informed the phone line is in
use and the program will terminate. No different than someone
picking up an extention in your home.
If your BBS is very busy you may want to look into a dedicated
phone line or restricting the door to certian hours. CST is
easy to close as an event. Just create a file called NOT.NOW
in the cyber directory (contents not important) [see above]
2.4 Local Screen
====================================================================
During a transport the local screen will display exactly what
the user see's. The local screen is live! If you press a key while
the user is online with another BBS, whatever you press will
be echo'ed as if the user press the same key on his/her end.
!!-------------------------------------------------------------!!
NOTE:
CST is NOT a terminal program! It will NOT emulate
ANSI, VT100 or anything while being used locally!
!!-------------------------------------------------------------!!
If/when the user downloads a file from the other BBS the screen
will display the download while it is in progress. This will
appear as a never ending screen of garbage. Because most downloads
are of binary files, they will contain "CTRL-G" (BELL)
characters. To preserve your sanity all "CTRL-G" characters are
not printed to the local screen.
Any time Sysop may press the F1 key. This will terminate
CyberSpace Transporter and put the user back in your BBS.
During transport the Sysop may press the F10 key to toggle on/off
the status line display. You may want to turn it off after reading
the information displayed as it may tend to slow things down.
2.5 Users Time Left
====================================================================
CyberSpace Transporter will keep track of the users time left
and terminate when his/her time runs out.
If you have enabled the Hangup feature this will happen during
a transport. The user will see a warning 2 minutes before
his time expires.
!!-------------------------------------------------------------!!
NOTE:
If users are paying you per hour, I cannot see any
reason why you would ever want to hang up on them!!
!!-------------------------------------------------------------!!
If you have not enabled the Hangup feature. Time left will only
be enforced at the Transporter Menu screen. If a user runs
out of time during a transport the program will not terminate
until s/he returns from a transport.
3.0 Registration Information
====================================================================
If you find this program useful after using it for NO
LONGER than 30 days. Please send $45.00 to:
Frances Decatur
RR 1 Box 59-Q
Greentown, PA 18426
Please use ORDER.FRM included in this package.
!!-------------------------------------------------------------!!
Online registration with your Credit Card via modem at:
The Circuit Board 717-676-9339 (Main support BBS)
Midnite Connection 718-357-0429
!!-------------------------------------------------------------!!
Any one of you users could save more than the $45.00 in
a single month. If you think this is too much, ask your
users to adopt it!
I will then send you a key to activate this and all future
versions of CyberSpace Transporter via FILE ATTACHED EMAIL
on The Circuit Board, FIDO CrashMail, Compuserve Email, or
call your BBS if there is no other way.
If you want it mailed please include an extra $2.50
Please indicate 5.25 or 3.5 floppy
If you do not register CyberSpace Transporter after using it
for 30 days, destroy your copy or pass it on to someone that
will!!
This offer can be withdrawn at any time! So do it now! Before
I wake up and charge what it's really worth.