home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / BBS / DOORS / CAMP10.ZIP / INSTALL.DOC < prev    next >
Encoding:
Text File  |  1991-05-29  |  15.0 KB  |  384 lines

  1.  
  2.  
  3.  
  4.                                  Install.doc
  5.                                 for use with
  6.                            Camptown Races ver 1.0
  7.                                 by Kent Ogle
  8.  
  9.  
  10.  
  11. The BULK of this file is directly from BBS Onliner Interface.
  12. Since I am using the BOI, I thought it would be best for the author of
  13. this very useful tool to explain the biggest part of it's many features.
  14. If you have designs to write doors, I suggest you seriously consider
  15. Mr. Mead's BOI. It is mainly out of respect to him, (and by his permission)
  16. that I include this file, to illustrate its versatility, not out of my
  17. own laziness in the area of documentation.
  18.  
  19.  
  20.  
  21. QUICK INSTALLATION:
  22.       Some have complained about my documentation writing for previous
  23. versions of this door, so I am adding this quick start section. There
  24. are 5 easy steps to take before you finish installation.
  25.  
  26.       1. Make sure all files listed in camptown.doc are in the same
  27.          subdirectory.
  28.  
  29.       2. Know what type of BBS software you are running.
  30.  
  31.       3. Be certain which comport you are running on.
  32.  
  33.       4. Edit camptown.ctl with any ascii file editor to reflect
  34.          the data for you and your BBS.
  35.  
  36.       5. Read the balance of this document to determine your command-
  37.          line parameters.
  38.  
  39.  
  40.  
  41. This document is effective 12/10/90   {/// BOI \\\}
  42. BBSNOTES
  43.  
  44.  
  45.                  BBS Onliner Interface  version 1.20
  46.                   Copyright (C) 1990 Andrew J. Mead
  47.                          All Rights Reserved.
  48.  
  49.                   Contact:
  50.                        Andrew J. Mead
  51.                        POB 1155
  52.                        Chapel Hill, NC 27514-1155.
  53.                                    or
  54.                        #98 @9968 WWIVnet
  55.                        1:151/223 FidoNet
  56.  
  57.                    Sections (in order of appearance)
  58.  
  59.      General info                -  what this file is
  60.  
  61.      Command Line Directives     -  what options to use
  62.                                     /n Name switch
  63.                                     /q Quiet mode switch
  64.                                     /z Time Limit switch
  65.                                     /i IRQ/PortAddress Customization switch
  66.                                     /l Force Local Mode switch
  67.                                     /c Communication Port Override switch
  68.                                     /b Locked Baud Rate RTS/CTS switch
  69.                                     /k Carrier Detect Override switch
  70.  
  71.      SysOp Control               -  who's playing this game anyway
  72.                                     Current User Line
  73.                                     F-10 SysOp Abort Key
  74.                                     F-9 Line Noise Disconnect Key
  75.  
  76.      Specific BBS Installation
  77.  
  78.      2 A.M. BBS Notes            -  /2  Jumper.Dat installation
  79.      Auntie BBS Notes            -  /7  Auntie.Sys installation
  80.      Force, GAP Notes            -  /S  Door.Sys (long) installation
  81.      Forum Notes                 -  /F  UserInfo.Txt installation
  82.      Genesis Notes               -  /G  CallInfo.BBS installation
  83.      GT, DoorWay Notes           -  /D  Door.Sys (short) installation
  84.      ModuleX Notes               -  /M  Number.Txt installation
  85.      Opus-CBCS 1.13 Notes        -  /3  LastUser.BBS installation
  86.      Opus-CBCS 1.14 Notes        -  /O  LastUsXX.Dat installation
  87.      PCBoard 12.x Notes          -  /1  PCBoard.Sys installation
  88.      PCBoard 14.x Notes          -  /P  PCBoard.Sys installation
  89.      Phoenix Notes               -  /H  Info.BBS installation
  90.      RyBBS Notes                 -  /5  CurrUser.BBS installation
  91.      Sapphire Notes              -  /8  Sapphire.Dat installation
  92.      Search Light Notes          -  /9  Search Light installation
  93.      Spitfire Notes              -  /6  SFDoors.Dat installation
  94.      WildCat Notes               -  /W  CallInfo.BBS installation
  95.      WWIV Notes                  -  /4  Chain.Txt installation
  96.  
  97.      DoorInfo Notes              -  /R# DorInfo#.Def Installation:
  98.  
  99.                                     EIS-PC, FoReM, OLEcom, QuickBBS,
  100.                                     RBBS, Remote Access, TAG, TP-Board
  101.  
  102.  
  103.                            -  General Info  -
  104.  
  105.    This file includes specific notes and examples for most BBS systems
  106.    that this game runs under.  A few basic recomendations:
  107.  
  108.  
  109.                       -  Command Line Directives  -
  110.  
  111.  
  112.    /n this switch is only necessary for use with the /9 SearchLight switch
  113.       or other BBS systems that run the game with command line directives
  114.       instead of using drop files.  It also can be used if you run the
  115.       game locally from DOS.
  116.  
  117.    /q will keep the game from beeping on the host computer.  This enables
  118.       the SysOp to get a good nights sleep.
  119.  
  120.  
  121.    /z sets a maximum time limit.  Normally the game will allow the player
  122.       as much time as he has left to play.  This allows the SysOp to
  123.       encourage players not to fall asleep during games.
  124.  
  125.       The game will execute an inactivity time-out at approximately 2
  126.       minutes.  It will beep at the halfway point and then again when
  127.       it returns control to the BBS.
  128.  
  129.    The game will auto-detect local play, so you can safely play the same
  130.    door locally that the remote users play.
  131.  
  132.    /i allows for customization of your serial communications.  If you are
  133.       using a PS/2 on Com3 or above, or if you are using any non-standard
  134.       IRQ/port address set-up, this option will allow you to get the game
  135.       playing.  This option will not interfere with the game auto-detecting
  136.       local play.  This option (or the /c or /l options) should not be used
  137.       unless absolutely necessary.
  138.  
  139.    NOTE : If you think the game is being forced into local play, check the
  140.    following.  If a remote user is playing the game, the bottom line of the
  141.    host computer will say 'Current User : User's Name or Alias here'.  If
  142.    the line is there, then the game is not locked into local mode.  In local
  143.    mode, the game never displays the 'Current User' line.
  144.  
  145.    /b - Locked BAUD Rate : These programs use RTS handshaking.  If you are
  146.    using a modem with the baud rate locked, then you will want to use this
  147.    switch.  '/B' implements RTS/CTS handshaking, and prevents the game from
  148.    overrunning the modems internal buffer.
  149.  
  150.    /k turns of the games carrier detect routines.  This option is a 'last
  151.        resort' option.  If your modem does not properly maintain a Carrier
  152.        Detect' signal, the game will automatically abort.  This option
  153.        supresses this activity.  If the user does drop carrier, the game
  154.        will still do an inactivity timeout after 2 minutes.  If you are
  155.        forced to use this option, you probably are having hardware problems
  156.        with the modem or RS-232 connector (bad pin or broken wire).
  157.  
  158.  
  159.                            -  SysOp Control  -
  160.  
  161.    Current User Line - The bottom line (line 25) on the BBSs monitor will
  162.        display the name of the player currently logged on.  This will not
  163.        display if the game is being played locally.
  164.  
  165.    F-10 - SysOp abort.  Pressing this key on the host keyboard will abort
  166.        the game in progress, and return control to the batch file, or BBS.
  167.        The user will be notified that the SysOp has terminated the session.
  168.  
  169.    F-9 - Line Noise.  Pressing this key on the host keyboard will simulate
  170.        line noise, then hang up the phone.  It will appear to the user as
  171.        if the connection was trashed.
  172.  
  173.  
  174.                           -  2 A.M. BBS Notes  -
  175.  
  176.    - The /2 option reads a 'Jumper.Dat' file.  For actual installation,
  177.      follow the WWIV example.
  178.  
  179.  
  180.                           -  Auntie BBS Notes  -
  181.  
  182.    - This option is currently in the BETA stage.
  183.    - The /7 option reads a 'Auntie.Sys' file.  You will need to include the
  184.      /c or /i directive with this set-up.  Auntie.Sys does not tell which
  185.      communications port is being used.
  186.    For actual installation,
  187.      follow the WWIV example.  If you have documentation on this file, or
  188.      possibly other files that Auntie BBS creates, please let me know.
  189.  
  190.  
  191.                           -  Force, Gap Notes  -
  192.  
  193.    - The /S option reads a 'Door.Sys' file.  This is the new proposed
  194.      standard for doors.  This format is currently used by Force and GAP.
  195.      For actual installation, follow the WWIV example.
  196.  
  197.  
  198.                              -  Forum Notes  -
  199.  
  200.    - The /F option reads a 'UserInfo.Txt' file.  For actual installation,
  201.      follow the WWIV example.
  202.  
  203.  
  204.                             -  Genesis Notes  -
  205.  
  206.    - The /G option does not currently work.  I do not have sufficient
  207.      information on Genesis' CallInfo.BBS.  It seems to match WildCat's
  208.      upto line 28.  Line 29 should contain communication port information.
  209.      If it does, use the /W directive instead.  I would really appreciate
  210.      some more complete documentation on Genesis.
  211.  
  212.  
  213.                           -  GT, DoorWay Notes  -
  214.  
  215.    - The /D option reads a 'Door.Sys' file.  This is the same Door.Sys that
  216.      is used by Marshall Dudley's DoorWay to Unlimited Doors Program.
  217.      For actual installation, follow the WWIV example.
  218.  
  219.  
  220.                             -  ModuleX Notes  -
  221.  
  222.    - The /M option reads a 'Number.Txt' file.  For actual installation,
  223.      follow the WWIV example.
  224.  
  225.  
  226.                          -  OPUS-CBCS 1.13 Notes  -
  227.  
  228.    - This option does not currently work.
  229.    - The /3 option reads a 'LastUser.BBS' file.  For actual installation,
  230.      follow the WWIV example.  If you have documentation on this file,
  231.      please let me (Andrew J. Mead, address below) know.
  232.  
  233.  
  234.                          -  OPUS-CBCS 1.14 Notes  -
  235.  
  236.    - The /OXX option reads a 'LastUsXX.Dat' file.  The 'XX' is the OPUS
  237.      task number; if it is absent the program will attempt to read a file
  238.      called 'LastUser.Dat'.  an example with a task number (hexadecimal)
  239.      of 'e' would be
  240.  
  241.      Camptown /o0e:c:\opus\   ...
  242.  
  243.      the c:\opus\ tells it to look for 'LastUs0E.Dat' in the C:\OPUS\
  244.      directory.  The '...' is the other command line options (check the
  245.      WWIV example for a more thorough example).
  246.  
  247.  
  248.                           -  PCBoard 12.x Notes  -
  249.  
  250.    - This option is currently in the BETA stage..
  251.    - The /1 option reads a 'PCBoard.Sys' file.  For actual installation,
  252.      follow the WWIV example.  If you have documentation on this file,
  253.      please send it to me.
  254.  
  255.  
  256.                           -  PCBoard 14.x Notes  -
  257.  
  258.    - The /P option reads a 'PCBoard.Sys' file.  For actual installation,
  259.      follow the WWIV example.
  260.  
  261.  
  262.                             -  Phoenix Notes  -
  263.  
  264.    - The /H option reads a 'Info.BBS' file.  For actual installation,
  265.      follow the WWIV example.
  266.  
  267.  
  268.                              -  RyBBS Notes  -
  269.  
  270.    - The /5 option reads a 'CurrUser.BBS' file.  For actual installation,
  271.      follow the WWIV example.
  272.  
  273.  
  274.                             -  Sapphire Notes  -
  275.  
  276.    - This option does not currently work.
  277.    - The /8 option reads a 'Sapphire.Dat' file.  For actual installation,
  278.      follow the WWIV example.  If you have documentation on this file, or
  279.      possibly other files that Sapphire BBS creates, please let me know.
  280.  
  281.  
  282.                           -  Search Light Notes  -
  283.  
  284.    - The /9 option is the reverse of the rest of these BBS switches. Since
  285.      the program is being run directly by SLBBS instead of from a batch file,
  286.      the current directory is the same as the BBS's directory.  /9 will tell
  287.      the game to get the path from the command line.
  288.  
  289.                       c:\slbbs\games\stars\starsbbs /9
  290.  
  291.      This will tell the game to get 'c:\slbbs\games\stars\' from memory.
  292.      You will need to pass more information to make the game run.  I have
  293.      added a /n switch to read the users name.  You should use the %U switch
  294.      so that SearchLight passes the complete name like Andy_Mead.  It
  295.      should look something like /n:%U or /n%U.  The next switch you should
  296.      use is the /z directive to get the user's time remaining.  I believe
  297.      the SL switch is %M, so you should have /z:%M or optionally you can
  298.      set a specific time limit (i.e. /z:20).  The final piece of information
  299.      need is communication port.  My games use /c and SL uses %P.  Therefore
  300.      /c:%P should fit the bill.  A final example (check elsewhere for
  301.      description of /q ) would be
  302.  
  303.            c:\slbbs\games\mad\madness /9 /n:%U /c:%P /z:%M /q
  304.  
  305.      The spaces between switches is mandatory!
  306.  
  307.  
  308.                            -  Spitfire Notes  -
  309.  
  310.    - The /6 option reads a 'SFDoors.Dat' file.  For actual installation,
  311.      follow the WWIV example.
  312.  
  313.  
  314.  
  315.                             -  WWIV Notes  -
  316.  
  317.    - sample WWIV installation
  318.      WWIV,chain.txt directory  - C:\WWIV
  319.      batch file                - camp.bat
  320.      stars.bat directory       - C:\WWIV\GAMES
  321.      starsbbs.exe directory    - C:\WWIV\GAMES\CAMP
  322.  
  323.      camp.bat listing
  324.        echo off
  325.        cd c:\wwiv\games\camp
  326.        camptown /4:c:\wwiv\ /q /z:20
  327.        cd c:\wwiv
  328.  
  329.      chainedit setting
  330.        file - c:\wwiv\games\camp.bat
  331.        dos interrupts - off, this game handles it's own communications
  332.        shrink - doesn't matter - recommend NO
  333.        ansi - required
  334.        allow 300 bps users - recommend NO
  335.  
  336.    - If you are NOT using WWIV then substitute your BBSs switch for '/4'.
  337.  
  338.    - In WWIV mode, the current user line will also display user's
  339.      number and real name.
  340.  
  341.  
  342.                           -  DoorInfo Notes  -
  343.  
  344.    - EIS-PC, FoReM, Professional OLEcom, QuickBBS, RBBS, Remote Access,
  345.      TAG, and TP-Board.
  346.  
  347.    - If you use RBBS (or another DorInfo generating BBS), you will need
  348.      to let the program know what node the program is on.  If you use
  349.      /R by itself, the program will look for a file called DoorInfo.Def.
  350.      /R1 will look for DorInfo1.Def, /R2 will look for DorInfo2.Def, etc...
  351.  
  352.      A sample command line for node 1 would be:
  353.  
  354.      camptown /r1:c:\rbbs\ /z:35 /q
  355.  
  356.      where the program looks for DorInfo1.Def in c:\rbbs.
  357.  
  358. {/// I suggest copying the drop file to the camptown subdirectory, and
  359.       then deleting it at the end of the game. I have had mixed reports
  360.       with setting the search path in the command line, although I know
  361.       of several boards being able to utilize it, it CAN BE a difficult
  362.       process to implement. If you have trouble getting Camptown up
  363.       and running, try this.  K Ogle \\\}
  364.  
  365.  
  366.  
  367.  
  368.                          BBS Onliner Interface
  369.         Copyright (C) 1990 Andrew J. Mead - All Rights Reserved.
  370.               The Mad Programmer - Brown & Mead Consulting
  371.                   POB 1155 Chapel Hill, NC 27514-1155
  372.  
  373.  
  374.                             Camptown Races
  375.                  Copyright (C) 1991 by Kent D. Ogle
  376.                             909 West 1st
  377.                          Webb City, Mo 64870
  378.            Support Board : The PC-Depot, Scott Stuart, sysop
  379.                           fidonet 1:286/777
  380.                   (417)624-3815  HST Dual Standard
  381.                           (please register!)
  382.  
  383.  
  384.