home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / DOOR / CYBER13.ZIP / CYBER13.DOC < prev    next >
Text File  |  1993-11-01  |  18KB  |  418 lines
  1.                               
  2.                               
  3.                               
  4.                               
  5.                               CyberSpace Transporter
  6.  
  7.                                    Version 1.3 
  8.  
  9.                                  November 1, 1993
  10.  
  11.  
  12.           Copyright (c) 1993 All rights reserved. This documentation and
  13.           associated programs are the property of James Decatur. This 
  14.           program may be distributed only in its original form, 
  15.           including all documentation and support files.
  16.  
  17.  
  18.        Table of Contents
  19.        ====================================================================
  20.  
  21.                1.0 What is a CyberSpace Transporter         
  22.                1.1 What is Shareware?         
  23.                1.2 Support for CyberSpace Transporter    
  24.                1.3 Files Included         
  25.                1.4 Disclaimer           
  26.                1.5 Modem Info
  27.                1.6 MultiLine BBS's
  28.  
  29.                2.0 Setup                
  30.                2.1 Configuration Editor       
  31.                2.2 Batch files         
  32.                2.3 Do I really need a 2nd phone line?   
  33.                2.4 Local screen
  34.                2.5 Users Time Left
  35.  
  36.                3.0 Registration Information
  37.                3.1 Future
  38.  
  39.                4.0 History
  40.  
  41.  
  42.        1.0 What is CyberSpace Transporter?
  43.        ====================================================================
  44.           CyberSpace Transporter is a door that allows your users to call
  45.           out to other systems on a second modem and phone line. Most of
  46.           your callers may be long distance to BBS's that are local to you.
  47.           So now you can actually save your users some REAL MONEY. And 
  48.           maybe make some for yourself.
  49.                                       
  50.        1.1 What is Shareware?
  51.        ====================================================================
  52.           The shareware concept is great for both programmer and the end-
  53.           user. The programmers can distribute their product without
  54.           getting involved in expensive marketing or advertising. The end-
  55.           user benefits by receiving a full-featured program, usually
  56.           better than the commercial competition, and support available
  57.           directly from the author. But it only works if the end-user
  58.           participates in the shareware concept.
  59.  
  60.           Shareware is not free. After using the CyberSpace Transporter
  61.           for a 30 day trial period, you must pay for continued use of 
  62.           the program. I have worked hard to produce a good program, 
  63.           and the price is very fair. Especially considering that many of
  64.           your users could save more than the price of registration...
  65.           EVERY MONTH!! 
  66.           
  67.           CyberSpace Transporter will only allow 10 minute calls until
  68.           it's registered! Along with some annoying delays!
  69.  
  70.        1.2 Support            
  71.        ====================================================================
  72.           If your having problems setting up and running CyberSpace 
  73.           Transporter, support is available! 
  74.  
  75.       #*  The Circuit Board   SYSOP           717-676-9339   E.Coast Dist.
  76.        #  LZ/Niteline         Jon Mankowski   510-273-7830   W.Coast Dist.
  77.                               Jim Decatur
  78.        *  Internet            jimd%cktbd@ka2qhd.de.com
  79.        *  VirtualNet          1@1717005
  80.           BASICnet            1@7170
  81.           Compuserve          72510,2363
  82.           Delphi              JDECATUR
  83.  
  84.        *  Mail read daily.
  85.        #  Latest version will always be available here. Long before it
  86.           is released.
  87.  
  88.        1.3 Files Included            
  89.        ====================================================================
  90.  
  91.           CYBER    EXE       main program
  92.           CLOSED   EXE       used when the transporter is closed
  93.           CYBERCFG EXE       configuration editor
  94.           CYBER    BAT       example to load the door
  95.           CYBER    CLS       example to close the door
  96.           CLOSE    BAT      
  97.           CYBER    OPN       example to open the door
  98.           OPEN     BAT      
  99.           CYBER13  DOC       this file
  100.           MODEM    EXE       sends a string to a modem from DOS
  101.  
  102.        1.4 Disclaimer            
  103.        ====================================================================
  104.  
  105.           CyberSpace Transporter and all support files are provided on 
  106.           an "AS-IS" basis with no warranty. Jim Decatur cannot accept 
  107.           responsible for loss of data, profit, or any damages which
  108.           are incurred by the use of this program or any support files.
  109.  
  110.        1.5 Modem Info   
  111.        ====================================================================
  112.  
  113.           CyberSpace Transporter requires that all highspeed modems be
  114.           set for RTS/CTS handshaking.
  115.  
  116.           If you setup your system with a highspeed modem and a 2400 modem,
  117.           your DOOR.SYS must have line 2 as "actual connect rate" and line 5
  118.           as locked port speed. If your BBS does not write DOOR.SYS in this
  119.           way, 300 & 1200 baud callers (if any) will have data loss 
  120.           problems.
  121.  
  122.           VBBS does not write DOOR.SYS this way. VBBSDRP.EXE will combine
  123.           DOOR.SYS and CHAIN.TXT into a DOOR.SYS that reflects the callers
  124.           true connect rate on line 2. Due to the non-existance of 300-1200
  125.           baud callers, this utility is not included. It is available on
  126.           The Circuit Board or LZ/Niteline.
  127.  
  128.           If your BBS does not write DOOR.SYS in this way, I may be able 
  129.           to create a utility for it.
  130.  
  131.        1.6 MultiLine BBS's   
  132.        ====================================================================
  133.        
  134.           If you run a multi-Line BBS you should set your BBS modem to
  135.           COM1 and the Transporter Modem to COM2. Also set your second 
  136.           node to COM2. CyberSpace Transporter will check to see if COM2 
  137.           is in use by the other node before it opens the port for dialout. 
  138.           
  139.           If someone is on your second node the Transporter will terminate 
  140.           and let the user know the modem is in use.
  141.  
  142.           If no one us using the second node the Transporter will snatch
  143.           the port and use it. When the user exits the Transporter the 
  144.           second Node will be hung. Not to worry... The Transporter will
  145.           drop a file called BOOT.ME in the directory that CYBER.EXE was
  146.           run from. You will need to configure your LOGOFF.BAT to test
  147.           for this file. If it exists have your batch file delete it and
  148.           reboot the computer. This should be put as the last thing your
  149.           LOGOFF.BAT file does. If your BBS does not support a LOGOFF.BAT
  150.           file, look for some way to do this before your BBS resets.
  151.           (possibally a board.bat file -- check your BBS docs)
  152.  
  153.           EXAMPLE: 
  154.           c:
  155.           cd\cyber
  156.           if exist boot.me goto boot   <--- check for boot.me file
  157.           exit                         <--- if no boot.me exit
  158.            
  159.           :boot
  160.           c:
  161.           cd\cyber
  162.           del boot.me        <--- delete the boot.me file
  163.           autoboot /cld /nil <--- Uses AUTOBOOT.EXE to reboot computer.
  164.           
  165.           
  166.           In order to support COM 1-4 The Transporter will re-write the 
  167.           port address for COM1 and COM2 to the COM ports you have 
  168.           selected with CYBERCFG.EXE. If these are COM 3 or 4, COM 1 and 
  169.           2 will become COM 3 and 4!
  170.  
  171.           This WILL cause nasty problems for anything that was orginally
  172.           on COM 1 and 2. Including mice, modems, other nodes, etc..
  173.           Please follow the above instructions for multi-line BBS's!
  174.  
  175.           In any case DO NOT use COM 1&3 or 2&4 together, this will 
  176.           case an IRQ conflict.
  177.  
  178.  
  179.        2.0 Setting up            
  180.        ====================================================================
  181.  
  182.           The first thing you need to do is create a directory where 
  183.           CyberSpace Transporter will live. [ie: c:\bbs\cyber]
  184.           Copy CYBER.EXE, CLOSED.EXE, CYBERCFG.EXE, and CYBER.DOC to the
  185.           directory you just created.
  186.  
  187.        2.1 Configuration Editor  
  188.        ====================================================================
  189.  
  190.           CYBERCFG.EXE will create CYBER.CFG and SYSTEMS.CFG for you.
  191.           Change directory to the cyber directory and enter CYBERCFG.EXE
  192.           at the command line.
  193.  
  194.           If CYBER.CFG does not exist you will be prompted for the
  195.           following:
  196.  
  197.       1.  How many systems do you want to connect with?
  198.  
  199.           You can enter a number from 1 to 10. This will reflect the number
  200.           of systems your user's will be allowed to connect to. The actual 
  201.           system names and phone numbers will be entered later.
  202.  
  203.       2.  Location of log file?
  204.  
  205.           Enter the LOCATION AND NAME of the file you want to keep the 
  206.           log entries in. [ie: c:\cyber\log.txt] If the file does not
  207.           exist, it will be created. If it already exists, it will be
  208.           appended to. This allows a sysop to write Cyber information to
  209.           his/her normal log file.
  210.  
  211.       3.  Location of DOOR.SYS file?
  212.  
  213.           Indicate the LOCATION where your BBS writes it's DOOR.SYS
  214.           file. Usually this is in the main BBS directory.
  215.           [ie: c:\bbs] 
  216.  
  217.       4.  Communications port on BBS modem?
  218.  
  219.           The port your BBS modem uses. [1-4]
  220.           ** see 1.5 even if you don't run a multiline BBS **
  221.  
  222.       5.  Communications port of outgoing modem?
  223.  
  224.           The port the modem that CyberSpace Transporter will use
  225.           to dial out. [1-4]
  226.           ** see 1.5 even if you don't run a multiline BBS **
  227.  
  228.       6.  Initialization string for outgoing modem?
  229.  
  230.           This must include commands for the following:
  231.  
  232.                CD must indicate the true state of Carrier Detect.
  233.                Dropping DTR MUST hang the modem up.
  234.                The modem must give verbal extended responses
  235.                [ie: CONNECT,BUSY,NO DIALTONE,etc]
  236.  
  237.           Consult your modem manual for help with thses commands.
  238.           
  239.           NOTE: In order to support MultiLine BBS's the Transporter
  240.                 may never get to this point. You will need to set the
  241.                 init string and save it to your modems memory.
  242.                 If you don't have a command to save the init string 
  243.                 you can use MODEM.EXE (included)
  244.                   
  245.                 MODEM.EXE should be run in your autoexec.bat when
  246.                 your computer boot's up
  247.  
  248.                 MODEM.EXE command line:
  249.  
  250.                 MODEM <port> <string>
  251.                 port = 1 - 4
  252.                 string = any string you want to send (ie:ATX4&C1&D2H0)
  253.                                                 
  254.       7.  Maximum baud rate of outgoing modem?
  255.  
  256.           Valid entries are 300,1200,2400,4800,9600,19200.
  257.           NOTE: High Speed modems MUST have CTS/RTS handshaking set.
  258.                 If your 2400 baud modem supports CTS/RTS - set it.
  259.  
  260.       8.  System Name
  261.           System Number
  262.  
  263.           Enter the BBS Name(s) and number(s) . 
  264.           
  265.  
  266.           When your through entering the systems you will be presented
  267.           with a list of your entries. Press "X" to exit and save 
  268.           CYBER.CFG and SYSTEMS.CFG.
  269.  
  270.           When you run CYBERCFG.EXE from this point on, you will be 
  271.           presented with this list. You can make any changes from here.
  272.  
  273.        2.2 Batch Files  
  274.        ====================================================================
  275.  
  276.           CYBER.BAT
  277.  
  278.           An example of the batch file used to load CYBER.EXE from
  279.           your BBS.
  280.  
  281.           OPEN.BAT
  282.           CLOSED.BAT
  283.  
  284.           Examples that will copy CYBER.OPN and CYBER.CLS to CYBER.BAT.
  285.           This will allow you to open and close the Transporter. These 
  286.           files will cause CLOSED.EXE to be loaded instead of CYBER.EXE.
  287.           CLOSED.EXE will inform your user that the Transporter is closed 
  288.           and request he/she try again later.
  289.  
  290.           Basically CYBER.OPN and CYBER.CLS are the same file. 
  291.           
  292.           OPEN.BAT will copy CYBER.OPN to CYBER.BAT. When the BBS calls
  293.           CYBER.BAT the Transporter program is run.
  294.  
  295.           CLOSE.BAT will copy CYBER.CLS to CYBER.BAT. When the BBS calls
  296.           CYBER.BAT, CLOSED.EXE is run instead on the Transporter.
  297.  
  298.           This has been included for Sysop's that use their VOICE line for
  299.           the Transporter to dial out on. The directories referred to in 
  300.           the BAT files will have to be changed to reflect your system's 
  301.           directories!
  302.           
  303.        
  304.        2.3 Do I really need a second phone line?
  305.        ====================================================================
  306.        
  307.           NO! 
  308.           
  309.           OPEN and CLOSE will allow you to close the Transporter in  
  310.           the event you have a really important phone call to make.
  311.  
  312.           If you forget to close the Transporter, it will pickup
  313.           the phone, get no dialtone, inform the user the line is 
  314.           in use and terminate the program. It is possible that 
  315.           your modem will mistake voice as a dialtone. In this case 
  316.           you will be treated to a musical number and the user will 
  317.           be informed his/her selection did not answer.
  318.  
  319.        2.4 Local Screen
  320.        ====================================================================
  321.  
  322.           During a transport the local screen will display exactly what
  323.           the user see's. The local screen is live! If you press a key while
  324.           the user is online with another BBS, whatever you press will
  325.           be echo'ed as if the user press the same key on his/her end.
  326.  
  327.           If/when the user downloads a file from the other BBS the screen
  328.           will display the download while it is in progress. This will
  329.           appear as a never ending screen of garbage. Because most downloads
  330.           are of binary files, they will contain "CTRL-G" (BELL) 
  331.           characters. To preserve your sanity all "CTRL-G" characters are
  332.           not printed to the local screen.
  333.  
  334.           During a transport the Sysop may press "ALT-Q". This will
  335.           terminate CyberSpace Transporter and put the user back in your
  336.           BBS. 
  337.  
  338.        2.5 Users Time Left
  339.        ====================================================================
  340.        
  341.           CyberSpace Transporter will keep track of the users time left 
  342.           and terminate when his/her time runs out. Time left will only
  343.           be enforced at the Transporter Menu screen. If a user runs
  344.           out of time during a transport the program will not terminate
  345.           until he returns from transport.
  346.  
  347.           Many SYSOP's get buggy when users drop carrier while on their
  348.           systems. Plus I think it's rude to just hang up on a system.
  349.  
  350.  
  351.        3.0 Registration Information
  352.        ====================================================================
  353.  
  354.           If you find this program useful after using it for NO
  355.           LONGER than 30 days. Please send $35.00 to:
  356.  
  357.           Jim Decatur
  358.           RR 1 Box 59-Q
  359.           Greentown, PA 18426
  360.  
  361.           I will then send you a REGISTERED copy of the LATEST release of
  362.           CyberSpace Transporter. 
  363.           
  364.           Please indicate 5.25 or 3.5 floppy
  365.  
  366.           If you do not register CyberSpase Transporter after using it
  367.           for 30 days, destroy your copy or pass it on to someone that
  368.           will!! 
  369.  
  370.           This offer can be withdrawn at any time! So do it now! Before
  371.           I wake up and charge what it's really worth.
  372.  
  373.  
  374.        3.1 Future of CyberSpace Transporter
  375.        ====================================================================
  376.  
  377.           The following additions are planned for future version's of
  378.           CyberSpace Transporter as well as any fixes to any bugs that
  379.           may pop-up.
  380.  
  381.           Additional Systems - to allow more than 10 systems.
  382.           
  383.           Accounting Utility - to inform the user just how much $$
  384.                                he/she is saving.
  385.  
  386.        4.0 History
  387.        ====================================================================
  388.  
  389.           CyberSpace Transporter v1.0 released 10/14/93
  390.  
  391.           Changed "Q" to "ALT-Q" to log a user off whil online with
  392.           another BBS. 
  393.  
  394.           Fixed problem where Transporter would hang (rarely) after
  395.           connecting to a remote system.
  396.  
  397.           Changed connect routine - after dialing it will wait 60 seconds 
  398.           for a response from the modem, if one is not recieved by then it
  399.           will inform the user and log it to the log file. I have had some 
  400.           problems with cheap (mine) internal modems not responding, this 
  401.           should (at least) prevent the program from hanging.
  402.  
  403.           In order to support COM 3 & 4 the Transporter changes the base
  404.           address of COM 1 & 2. It will now reset these address's back to
  405.           what it found when it was first run. 
  406.           (Always leave things the way you find them!)
  407.           
  408.           Fixed bug in the way DOOR.SYS was read. This caused time to
  409.           be expired when the door was run on a WildCat system.
  410.  
  411.           Fixed DOC's to include the best way to setup for MultiLine
  412.           systems.
  413.  
  414.           Added routine to check if modem is in use by another node.
  415.           
  416.           Fixed problem with second node hanging after the Transporter
  417.           is run (see MultiLine BBS'S)
  418.