home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / DOOR / BOX100.ZIP / BOXCARS.DOC < prev    next >
Text File  |  1996-12-26  |  10KB  |  262 lines
  1.  
  2.       +--------------------------------------------------------+
  3.       |      Boxcars, (C) Copyright 1991-97, Scott Jibben      |
  4.       |                      Version 1.00                      |
  5.       +--------------------------------------------------------+
  6.  
  7.  
  8. This is a list of the files that should accompany this software
  9. package:
  10.  
  11. LOCAL.BAT    - Batch file to run Boxcars locally.
  12. NODES.CFG    - Example BBS nodes configuration file.
  13. BOXCARS.CFG  - Example Boxcars Configuration File.
  14. FILE_ID.DIZ  - BBS Description File.
  15. CATALOG.DOC  - Information on Jibben Software Products.
  16. CC-ORDER.DOC - Information to register by credit card.
  17. FIDOFREQ.DOC - Listing of Fidonet FREQ'able files and info.
  18. INTERNET.DOC - Listing of internet access points.
  19. ORDERFRM.DOC - The order form.
  20. BOXCARS.DOC  - Boxcars Documentation.
  21. VENDOR.DOC   - Information for disk vendors and SHAREWARE distribution.
  22. WHATSNEW.DOC - The Version History of Boxcars.
  23. BOXCARS.EXE  - Boxcars executable.
  24. RES01.RES    - Boxcars Resource File.
  25. AVEXTRA.TXT  - Information regarding PKZIP AV codes.
  26.  
  27.  
  28. This software should not include any other files other than the ones
  29. listed above.  It was also compressed using the PKZIP AV.
  30.  
  31.  
  32. Please contact The Warehouse BBS for TECHNICAL SUPPORT at:
  33. (612) 767-2966 - USR Couriers, V.34 (6 phone lines)
  34.  
  35.  
  36.                        The concept of Shareware
  37.  
  38. Boxcars is being released as a Shareware product.  Shareware is a
  39. marketing concept, in which you get to try out a software package for a
  40. period of time.  If you find that the software is useful to you (you
  41. are still using it), you are obligated to send in a registration fee
  42. for that software to the author.
  43.  
  44. Boxcars' trial period is unlimited.  If it is useful, please promptly
  45. send in the requested registration fee.  If it is not useful, you are
  46. expected to delete it and stop using it.
  47.  
  48. The shareware version of Boxcars is functional.  However, the game will
  49. always display registration notices and the game stats on exit with
  50. delays.
  51.  
  52. Here's what you get when you register (Please use ORDERFRM.DOC or
  53. CC-ORDER.DOC to order this software):
  54.  
  55. 1.  Support.  You can call and leave e-mail to me on the BBS listed in
  56.     the Technical Support section of this document or CompuServe and
  57.     get a response from me.  I will more than likely answer all
  58.     questions, but the registered individuals will definitely get top
  59.     priority.  You will also receive unlimited telephone support for
  60.     the program.  Registered users will get a phone number that they
  61.     will be able to use to receive support between the hours of 6:00 pm
  62.     - 9:00 pm (Central Standard Time) Monday-Saturday.
  63.  
  64. 2.  You will receive a disk with the most recent version of Boxcars
  65.     (unless email/fidonet deliveries are requested).  The software will
  66.     also have all of the registration incentives removed.  The name and
  67.     serial number of your BBS will also be displayed in the main menu
  68.     when the software is run.
  69.  
  70. 3.  Special access to new products.  You will be allowed access to
  71.     beta test any software package that I'm in the process of creating.
  72.     The beta software will be available only on the Warehouse BBS.
  73.     Also you must make arrangements with Jibben Software to get access
  74.     to the new software.  (see Technical Support section of this
  75.     document for details).
  76.  
  77. 4.  You will be able to download and upgrade your registered version
  78.     with the shareware releases of the software.
  79.  
  80.  
  81.                Requirements for Boxcars
  82.  
  83. Boxcars should have at least 350KB of free memory to run.
  84.  
  85.  
  86.            Installation Instructions using NODES.CFG
  87.  
  88. Supported BBS Systems
  89. ---------------------
  90. Boxcars will support any BBS that creates a DOOR.SYS file when chaining
  91. to a door.  Also, Wildcat 2.x (CALLINFO.BBS) and PC Board - 12.x
  92. through 14.x (PCBOARD.SYS) are supported.  Systems using standard
  93. DORINFOx.DEF file (Remote Access) are supported.
  94.  
  95.  
  96. Setting up Boxcars with NODES.CFG
  97. ---------------------------------
  98. First of all, you will have to edit the NODES.CFG file.  There are
  99. detailed instructions and information in this file to assist you in
  100. this process.  NODES.CFG is a simple text file that works very similar
  101. to an INI file.
  102.  
  103. Once you have the NODES.CFG updated to match your system.  You will
  104. need to create a batch file to run the game.  This is a very simple
  105. batch file.  Here is an example:
  106.  
  107. C:
  108. CD\DOORS\BOXCARS
  109. BOXCARS 1
  110. CD\
  111.  
  112. The important line to note is 'BOXCARS 1'.  The '1' tells the game
  113. which node you are running.  Ideally, you will pass in the node number
  114. from an environment variable.  Below is an example of using an
  115. environment variable with the Wildcat! BBS software:
  116.  
  117. C:
  118. CD\DOORS\BOXCARS
  119. BOXCARS %wcnodeid%
  120. CD\
  121.  
  122. Local Mode
  123. ----------
  124. The door can be tested in local mode simply by using the '/local'
  125. option or use a DOOR.SYS file that has a comm port of zero (COM0:).
  126. The following file is included: LOCAL.BAT
  127.  
  128. This file will assist you in testing the door in local mode.
  129.  
  130.  
  131. Miscellaneous Setup Issues
  132. --------------------------
  133. Boxcars supports multi-node access!  So, you can safely allow more than
  134. one node to access the door at one time.  However, you will be
  135. responsible for keeping each DOOR.SYS or related door file separate
  136. from other players files.
  137.  
  138.  
  139.                               Maintenance
  140.  
  141. There are no maintenance programs that need to be run.  The game
  142. manages it all by itself.
  143.  
  144.  
  145.                  Configuration
  146.  
  147. Boxcars has been written to be easily configured.  Included with this
  148. distribution software is a file named BOXCARS.CFG.  It is very similar
  149. to a Microsoft Windows *.INI file.  It contains a sample configuration
  150. for the game.  It also contains the documentation for the settings and
  151. what the options mean.  Please refer to this file to see how to
  152. configure your copy of Boxcars.
  153.  
  154.  
  155.             Boxcars Technical Info
  156.  
  157. Files
  158. -----
  159. Boxcars takes advantage of technology created by Jibben Software
  160. called 'Resource Files'.  This technology allows a software package to
  161. contain all of it's ANSI and DOC files in a single *.RES file.
  162.  
  163. The only files that Boxcars requires are:
  164. BOXCARS.CFG  - Boxcars Configuration File.
  165. BOXCARS.EXE  - Boxcars Executable.
  166. RES01.RES    - Boxcars Resource File.
  167. STATS.BIN    - Boxcars Statistics File, optional in registered game.
  168.  
  169.  
  170. All other distribution files may be removed to conserve disk space.
  171.  
  172.  
  173. Multi-Node Issues
  174. -----------------
  175. In order for Boxcars to allow multi-node access it creates temporary
  176. semaphore files.  These files always have the extension of *.SEM.
  177. Normally these files will be removed when the player who created them
  178. exits the door.  If you are certain that no one is in the game and
  179. *.SEM files exist, you may safely delete them.  The software will also
  180. delete them if they are over 30 minutes old.
  181.  
  182. Also, a side effect of a BBS crash or similar critical event when
  183. Boxcars is in use is that files with no extention may exist in the
  184. Boxcars directory.  These files always are 0 bytes for size and will
  185. have a 'random' name, usually starting with '0'.  These may be safely
  186. deleted if there are no players in the game.
  187.  
  188.  
  189. Data Files
  190. ----------
  191. Boxcars creates several data files.  These files contain game, player,
  192. and ranking information.  They will always have the file extension of
  193. *.DAT.
  194.  
  195. They are:
  196. PLAYER.DAT   - Player data file.
  197. WINNER.DAT   - Monthly winner list.
  198. RANKDATE.BIN - Keeps track of the last time monthly rankings occurred.
  199.  
  200.  
  201.                            Development Data
  202.  
  203. Boxcars was written entirely in C++ using Watcom C++ 10.60.
  204.  
  205.  
  206.                        Technical Support
  207.  
  208. For technical support I (Scott Jibben) can be reached at the following
  209. on-line systems:
  210.  
  211. Internet:
  212. I usually read internet email at least once a day.
  213. My Internet email address is: sjibben@usinternet.com
  214. My web site is: http://www.usinternet.com/jsw
  215.  
  216. The Warehouse BBS:  612-767-2966  1200-57600 baud V.34/HST 33.6K
  217. (N81) - 6 Lines.  The Warehouse is my first (main) line of support.
  218. Since I am a sysop of this BBS, I usually log on several times a day
  219. to check for email.  This BBS is a subscription BBS, however anyone
  220. logging on will receive access rights to the file area where my
  221. software can be downloaded for FREE and a message area that is
  222. dedicated to my software.
  223.  
  224. My CompuServe ID is 72657,3303.  Feel free to send me an E-Mail any
  225. time.  I usually log on to CompuServe at least once a week.  This
  226. software can be found in the IBMBBS forum.
  227.  
  228. FidoNet:
  229. The Warehouse BBS is attempting to get on fidonet.
  230.  
  231.  
  232.  
  233.                             Acknowledgments
  234.  
  235.  
  236. I would like to thank those people that have assisted me in the
  237. development of this software:
  238.  
  239. My wife, daughter and son, for the patient support and active
  240. involvement in running this business.
  241.  
  242. All the people who made great suggestions for this game.
  243.  
  244. Finally, all of the people who've registered my software.  I really
  245. appreciate it!
  246.  
  247.  
  248.                            Disclaimers, etc.
  249.  
  250.  
  251. Jibben Software specifically disclaims all other warranties, expressed
  252. or implied, including but not limited to implied warranties of
  253. merchantability and fitness for a particular purpose, functionality or
  254. data integrity.  In no event shall Jibben Software be liable for any
  255. loss of profit or any other commercial damage, including but not
  256. limited to special, incidental, consequential or other damages.
  257.  
  258.  
  259.  
  260. Microsoft Windows is a registered trademark of Microsoft Corporation.
  261.  
  262.