home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / comm / star14.zip / STAR14.DOC < prev    next >
Text File  |  1989-06-20  |  15KB  |  382 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                                 S T A R P O R T
  14.                                   Version 1.4
  15.  
  16.                               (c) Copyright 1989
  17.                                 by Ted Freeman
  18.  
  19.                                MicroNet PCBoard
  20.                              Starlink Port # 9165
  21.                              Node 1: 405-528-3175
  22.                              Node 2: 405-528-8610
  23.  
  24.                          All Rights Reserved Worldwide
  25.  
  26.                      -------------------------------------
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.                              ┌─────────┐
  39.                        ┌─────┴───┐     │               (tm)
  40.                      ──│         │o    │──────────────────
  41.                        │   ┌─────┴╨──┐ │  Association of
  42.                        │   │         │─┘  Shareware
  43.                        └───│    o    │    Professionals
  44.                      ──────│    ║    │────────────────────
  45.                            └────╨────┘    MEMBER
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.                                    ASP INFO
  54.                                    --------
  55.  
  56.         The author, Ted Freeman, is a Member of The Association of Shareware
  57.         Professionals (ASP). ASP has established stringent standards for its
  58.         members and wants to make sure the Shareware principle works for you.
  59.         If you are unable to resolve a shareware-related problem with an ASP
  60.         member by contacting the member directly, ASP may be able to help.
  61.         The ASP Ombudsman can help you resolve a dispute or problem with an
  62.         ASP member, but does not provide technical support for members'
  63.         products. Please write to the ASP Ombudsman at:
  64.              Address: P.O. Box 5786         Compuserve: ASP Ombudsman
  65.                       Bellevue, WA 98006.               70475,1071
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.                                WHAT IS STARPORT?
  73.                                -----------------
  74.  
  75. Starport is a utility program designed to make navigating Starlink (R) as easy 
  76. and as painless as possible. If you are currently using script files with your 
  77. communications program, you will appreciate Starport's superior features. 
  78. Starport is much, much faster than script files. Data entry of new outdial 
  79. port numbers and BBS numbers is very simple via Starport's Maintenance 
  80. Facility. Outdial cities and BBSes are selected via menu so even the most 
  81. inexperienced user will have no trouble operating Starport.
  82.  
  83. Starport is designed to run from a communications program, such as Datastorm's 
  84. Procomm Plus. You may use either the Hotkey option or as an external protocol. 
  85. I prefer to use the external protocol method because the Hotkey option prompts 
  86. you to "Hit any key to continue..." when Starport terminates, whereas the 
  87. external method does not. Starport was not designed to be a terminal program. 
  88. It's sole purpose is to log-on to Starlink and get you to the City/BBS of your 
  89. choice. Your communications program then takes over once again. Starport is 
  90. known to work correctly with  Boyan, GT Powercom, Qmodem, Procomm Plus and
  91. Telix. It should work with most terminals that support either external 
  92. protocols or shelling to another program via Hotkeys.
  93.  
  94.  
  95.                                 STARPORT FILES
  96.                                 --------------
  97.  
  98. STAR14.EXE   - The main executable file.
  99. STARLINK.MNU - Starlink's Menu Service listing (ASCII format).
  100. STARPORT.ASP - Procomm Plus script file for logging on to Starlink.
  101. STARPORT.CFG - Config. utility runs automatically if not present (or wrong).
  102. STARPORT.DAT - Starport's database. Holds all outdials and BBS numbers.
  103. STARPORT.DOC - This documentation file.
  104. STARPORT.MNU - Menu file. MUST be present in the current directory!
  105. STAR.BAT     - Batch file for starting Starport.
  106.  
  107. NOTE: All files except STARPORT.DOC must be in the directory StarPort runs from.
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.                               INSTALLING STARPORT
  120.                               -------------------
  121.  
  122. STARPORT.CFG - The lines marked with * MUST be populated in this file.
  123.              * Line 1 = COM port to use. (COM1: or COM2:)
  124.              * Line 2 = Baud rate to use. (1200, 2400, etc.)
  125.              * Line 3 = Your Starlink USERNAME.
  126.              * Line 4 = Your Starlink PASSWORD.
  127.              * Line 5 = X - Use Control-X & Control-R (enables XON/XOFF)
  128.                         V - Use Control-V (opens the bandwidth)
  129.                         I - Use Control-I (for faster network response)
  130.                        IV - Use both Control-I and Control-V (not recommended)
  131.                         N - Do not use control codes.
  132.                Line 6 = Your GALAXY handle (may be left blank).
  133.                Line 7 = Your GALAXY password (may be left blank).
  134.                Line 8 = Your Registration number (if registered).
  135. Note: The configuration utility runs automatically if this file is missing
  136.       or incorrect. STARPORT.CFG is an ASCII file and may be edited with
  137.       your word processor.
  138.  
  139. STAR.BAT     - This example is for Procomm Plus but the procedure should be
  140.                similar for other communications programs.
  141.  
  142.  
  143.                                  Hotkey option
  144.                                  -------------
  145.                Using either Procomm's setup program or ALT-S from within 
  146.                Procomm, select FILE/PATH OPTIONS. Now select either F or G
  147.                (User hotkey option) and type STAR and hit ENTER. Now
  148.                hit ESC and S to save it. That's it!
  149.  
  150.                            External protocol option
  151.                            ------------------------
  152.                Again, using either the setup program or ALT-S, select PROTOCOL
  153.                OPTIONS. I suggest using a download protocol letter so type
  154.                either B, D, or F and enter STAR. Now hit ENTER then ESC
  155.                and finally S to save.
  156.  
  157. STARPORT.ASP - Now type ALT-D for the dialing directory and select the entry
  158.                for Starlink (you do have one don't you?). Type R to revise the
  159.                entry. Hit ENTER until you come to the SCRIPT entry. Type in
  160.                STARPORT. Your parameters should be set to E-7-1 for log-on
  161.                to Starlink. STARPORT.ASP will switch you to N-8-1 later so you
  162.                do not have to do it 'on-the-fly'.
  163. NOTE: If you are not using Procomm Plus, you will have to convert STARPORT.ASP
  164.       to your program's script language.
  165.  
  166.                           Starport is now installed!
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.                                 STARPORT ONLINE
  175.                                 ---------------
  176.  
  177. Start your communications program and dial into Starlink as you normally 
  178. would. When the screen clears and the log-on script terminates, you then 
  179. invoke Starport. Registered users may mark up to 20 BBSes for dialing.
  180. Unregistered users are limited to two. The BBS lists may be sorted in 3
  181. different ways: Alphabetically, by Port number or by City.
  182.  
  183. When you are through marking, hit the END key to highlight 'BEGIN DIALING'
  184. and hit ENTER. StarPort will dial each BBS in turn until a connection is made
  185. or you abort the dialing sequence. You are reminded that Starlink charges
  186. you a minimum of 80 seconds for each connection to an Outdial. To make
  187. maximum use of each connection, you should select multiple BBSes for an
  188. Outdial. If you select just one BBS and it is busy, you are still charged
  189. 80 seconds even though the connection may have lasted only 10-20 seconds.
  190.  
  191. The important keys here are:
  192. ESC - Terminate StarPort and return to your communications program.
  193. F1  - If the BBS is busy, you may abort the dialing sequence with F1, which 
  194.       will bring you back to StarPort's menu.
  195.  
  196.  
  197.  
  198.  
  199.                          STARPORT MAINTENANCE FACILITY
  200.                          -----------------------------
  201.  
  202. To invoke the Starport Maintenance Facility, run STARPORT without any command
  203. line parameters. This portion of Starport looks just like the online portion 
  204. except for two additional options.
  205.  
  206. To enter new BBS numbers, simply highlight 'ADD A NEW BBS' and follow the 
  207. prompts. If you make a mistake entering the information, simply highlight the
  208. BBS in question and re-enter the data. The BBS menu is sorted automatically 
  209. after each entry.
  210.  
  211. You may make changes to STARPORT.CFG by selecting 'CONFIGURATION'. Any info
  212. already in the file will be displayed. Standard editing keys are available
  213. in each field. If info in a field does not need to be changed, just hit
  214. ENTER for that entry.
  215.  
  216.  
  217.  
  218.  
  219.  
  220.                                REVISION HISTORY
  221.                                ----------------
  222.  
  223. 1.0  - Initial release.
  224.  
  225. 1.0b - Rewrite of 1.0. Got rid of the Outdial Menu. Now only have the one
  226.        BBS menu to deal with.
  227.  
  228. 1.1  - Added ability to use Control codes which are used to improve network
  229.        response time and file transfers. StarPort now sends 'BPS 1200' when
  230.        logged on at 1200 BAUD. Added ability to abort back to StarPort's menu
  231.        when a BBS is busy (F1). Added option to tag up to 10 numbers for
  232.        dialing.
  233.  
  234. 1.2  - StarPort can now handle the Starlink Menu Service. Whenever a new
  235.        service is added to the Menu, just load STARLINK.MNU into your word
  236.        processor and add it to the list. If you are connecting to Galaxy,
  237.        StarPort will terminate automatically when it receives the "HOST IS
  238.        ON LINE" prompt.
  239.  
  240. 1.3  - Added the Configuration utility which runs automatically if the
  241.        STARPORT.CFG is missing or incorrect. If you need to make changes
  242.        use the 'CONFIGURATION' option provided in the Maintenance Facility.
  243.  
  244.        Added complete log-on capability for Galaxy. If you have entered
  245.        your Galaxy handle and password in STARPORT.CFG, StarPort will log
  246.        on and terminate at Galaxy's Top Menu. If you leave the Handle and
  247.        Password fields blank, StarPort terminates at the 'HOST IS ONLINE'
  248.        message.
  249.  
  250.        StarPort now terminates automatically when it receives the Connect
  251.        message from Starlink.
  252.  
  253.        Added Sort option. While online you may sort the BBS list by Port
  254.        number, City or Alphabetically.
  255.  
  256.        Expanded the BBS menu to include the Port number and City.
  257.  
  258.        Registered users may now mark up to 20 BBS numbers to dial and
  259.        non-registered users may mark 2 numbers.
  260.  
  261. 1.4  - Finally got this sucker to work with Qmodem!! Added some additional
  262.        network error trapping, such as the 'Host not available' message
  263.        when calling into Galaxy. StarPort now returns you to the BBS menu.
  264.  
  265.  
  266.  
  267.  
  268.  
  269.                                  DISTRIBUTION
  270.                                  ------------
  271.  
  272.         STARPORT is COPYRIGHTED by Ted Freeman, with all rights reserved.
  273.         This program is being distributed via the SHAREWARE concept and as
  274.         such, may be copied freely with the following restrictions:
  275.  
  276.                 * The program must be supplied in it's original
  277.                   unmodified form, including documentation.
  278.  
  279.                 * STARPORT may not be distributed as part of any
  280.                   commercial application or service without the
  281.                   express, written consent of the author.
  282.  
  283.                 * Vendors of Shareware/Public Domain software may
  284.                   not distribute this program without the express,
  285.                   written consent of the author, unless said Vendor
  286.                   has been approved by the Association of Shareware
  287.                   Professionals (ASP).
  288.  
  289.  
  290.                                  REGISTRATION
  291.                                  ------------
  292.  
  293.         STARPORT represents many hours of programming and the author
  294.         deserves just compensation for his time, efforts and expertise.
  295.         If you find this program to be of some value and you continue
  296.         to use it on your system, you must return the registration form
  297.         provided along with the registration fee. The registered version
  298.         of StarPort will allow you to tag up to 20 BBS numbers EVEN IF
  299.         THEY ARE IN DIFFERENT CITIES! Registration entitles you to free
  300.         upgrades via modem from MicroNet's StarPort Conference for a period
  301.         of one year. Additional upgrades/support are available at $5.00 per
  302.         year. Payments should be made in the form of a check or money order
  303.         (do NOT send cash!). Foreign orders must be in U.S. funds drawn on
  304.         a U.S. bank.
  305.  
  306.         Suggestions and/or comments may be sent to the address below or
  307.         via electronic mail: 
  308.  
  309.                                   Ted Freeman
  310.                      MicroNet PCBoard   Compuserve   GEnie
  311.                      (405) 528-3175     71446,206    THFBOX
  312.                      (405) 528-8610
  313.  
  314.                             ----------------------
  315.  
  316. Starport was created in part with ProWindows *PLUS* - The Professional Software
  317. Development System. For more information on the ProWindows family of products,
  318. write to: Daniel P. Stasinski
  319.           Systems Management Consultant
  320.           30 North Street
  321.           Willits, CA 95490
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.               S T A R P O R T   R E G I S T R A T I O N   F O R M 
  330.  
  331.  
  332.         TO:  Ted Freeman                                Date___/___/___ 
  333.              P.O. Box 83401  
  334.              Oklahoma City, OK 73148
  335.  
  336.  
  337.             (Please use capitalization and punctuation where necessary.)
  338.  
  339.  
  340.       FROM:  Name: _____________________________________________________
  341.  
  342.              Address: __________________________________________________ 
  343.  
  344.              City: ______________________ State: __________ ZIP: _______ 
  345.  
  346.              Phone - Day: (   ) __________     Evening: (   ) __________
  347.  
  348.  
  349.  
  350.       SOFTWARE                          VERSION                  PRICE 
  351.       --------                          -------                  -----
  352.  
  353.       StarPort .......................... 1.4 ................. $19.75
  354.  
  355.       (OK residents add 6% tax)                                  _____
  356.  
  357.       (Foreign orders add $10.00 for shipping)                   _____
  358.  
  359.       Total                                                    $______ 
  360.  
  361.  
  362.                                 F E E D B A C K 
  363.                                 ---------------
  364.  
  365.       I acquired STARPORT from: 
  366.                 [  ] - A Friend         [  ] - Computer Club
  367.                 [  ] - BBS              [  ] - Compuserve
  368.                 [  ] - GEnie            [  ] - Galaxy
  369.                 [  ] - BIX              [  ] - Other
  370.  
  371.       COMMENTS: _____________________________________________________ 
  372.       _______________________________________________________________ 
  373.       _______________________________________________________________ 
  374.       _______________________________________________________________ 
  375.       _______________________________________________________________ 
  376.       _______________________________________________________________ 
  377.       _______________________________________________________________ 
  378.       _______________________________________________________________ 
  379.  
  380.  
  381. 
  382.