home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / SCRAM_39.ZIP / SCRAMBLE.DOC < prev    next >
Encoding:
Text File  |  1993-09-11  |  15.5 KB  |  377 lines
  1.  
  2.  
  3.                        ============================
  4.                              S C R A M B L E !
  5.                        ============================
  6.  
  7.                       COPYRIGHT 1990,93 T&J SOFTWARE
  8.  
  9.         One of the T&J Software Collection of multi-BBS door programs.
  10.  
  11.                        VERSION 3.9      9/11/93
  12.  
  13.                                    By
  14.  
  15.                                Tom Wildoner
  16.                              397 West Broadway
  17.                               Jim Thorpe, PA
  18.                                   18229
  19.                             VOICE (717)325-9480
  20.  
  21.                                    From
  22.  
  23.                                The T&J BBS
  24.                               (717)325-9481
  25.                              12/24/9600/14400
  26.  
  27. LEGALITIES
  28. ~~~~~~~~~~
  29.       THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
  30.       WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
  31.       LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  32.       FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH
  33.       THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT,
  34.       SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF
  35.       OR BREACH OF ANY WARRANTY.
  36.  
  37. SUPPORT
  38. ~~~~~~~
  39. Please feel free to call me at my BBS number or voice number. Word
  40. lists will be available on my BBS for download as they are prepared.
  41.  
  42. DISTRIBUTION
  43. ~~~~~~~~~~~~
  44. You may make this file available for downloading from your BBS or you may
  45. upload it to any BBS of your choice, provided that you do not make any
  46. changes to the contents of the archive (ZIP file). The archive and its
  47. individual contents may not be used by any service that charges any money
  48. whatsoever, without the written permission of the author.
  49.  
  50. REGISTERING
  51. ~~~~~~~~~~~
  52. Scramble will only use the first 25 words from the list of over
  53. 30,000 words until registered.
  54.  
  55. Once registered -- it will unlock all the features of the registered
  56. version including the full 30,000+ word lists!
  57.  
  58. FEATURES
  59. ~~~~~~~~
  60.            --- Return to BBS on dropped carrier.
  61.            --- 4-minutes no activity will return to BBS.
  62.            --- Online Chat.
  63.            --- You can blank the display.
  64.            --- Dump user back to BBS.
  65.            --- Drop to DOS function.
  66.            --- Desqview Aware.
  67.            --- COM0-15 support and non-standard IRQ's.
  68.            --- Colorful ANSI screens.
  69.            --- Makes TOP TEN ANSI & ASCII bulletins.
  70.            --- NO BRUN module needed for play.
  71.            --- BETA tested on five different boards.
  72.            --- Use of HOT KEYS while in the door.
  73.            --- Support BBS available.
  74.            --- Easily RESET the entire program.
  75.            --- Self maintaining no maintenance required.
  76.            --- Door resets every month to give ALL players a chance.
  77.            --- Fossil driver support.
  78.  
  79.  
  80. INSTALLATION:     IMPORTANT!!!!!!!
  81. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  82. Run Scramble using the command line UTILITY.
  83.  
  84. Example: SCRAM UTILITY
  85.  
  86. Then, reset the door from scratch. You can also easily setup your
  87. configuration files this way!
  88.  
  89.  
  90. UPGRADING
  91. ~~~~~~~~~
  92. If you are upgrading from v1.0 to v3.7 you'll have to erase everything
  93. and restart the game from scratch.
  94.  
  95. If you are upgrading from v3.8 then follow these instructions:
  96.  
  97.    -- copy the main SCRAM.EXE file into the current game directory.
  98.    -- copy all the SCR00*.* files into the current game directory.
  99.    -- that's it! Version 3.9 is now ready to play!
  100.  
  101. CONFIGURATION
  102. ~~~~~~~~~~~~~
  103.  
  104. Example configuration file for PCBOARD.SYS
  105. ------------------------------------------
  106. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  107. T&J Software        <=-  (Change this to your BBS name)
  108. Tom                 <=-  (The Sysop's first name)
  109. Wildoner            <=-  (The Sysop's last name)
  110.  
  111. Example configuration file for USERS.SYS
  112. ----------------------------------------
  113. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  114. T&J Software        <=-  (Change this to your BBS name)
  115. Tom                 <=-  (The Sysop's first name)
  116. Wildoner            <=-  (The Sysop's last name)
  117.  
  118. Example configuration file for DOOR.SYS
  119. ---------------------------------------
  120. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  121. T&J Software        <=-  (Change this to your BBS name)
  122. Tom                 <=-  (The Sysop's first name)
  123. Wildoner            <=-  (The Sysop's last name)
  124.  
  125. Example configuration file for USERINFO.DAT
  126. -------------------------------------------
  127. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  128. T&J Software        <=-  (Change this to your BBS name)
  129. Tom                 <=-  (The Sysop's first name)
  130. Wildoner            <=-  (The Sysop's last name)
  131. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  132.  
  133. Example configuration file for CALLINFO.BBS
  134. -------------------------------------------
  135. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  136. T&J Software        <=-  (Change this to your BBS name)
  137. Tom                 <=-  (The Sysop's first name)
  138. Wildoner            <=-  (The Sysop's last name)
  139.  
  140. Example configuration file for DORINFOx.DEF
  141. -------------------------------------------
  142. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  143.                           where 'x' is the BBS Node number.
  144. T&J Software        <=-  (Change this to your BBS name)
  145. Tom                 <=-  (The Sysop's first name)
  146. Wildoner            <=-  (The Sysop's last name)
  147.  
  148. Example configuration file for SFDOORS.DAT
  149. ------------------------------------------
  150. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  151. T&J Software        <=-  (Change this to your BBS name)
  152. Tom                 <=-  (The Sysop's first name)
  153. Wildoner            <=-  (The Sysop's last name)
  154.  
  155. Example configuration file for CHAIN.TXT
  156. ----------------------------------------
  157. C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  158. T&J Software        <=-  (Change this to your BBS name)
  159. Tom                 <=-  (The Sysop's first name)
  160. Wildoner            <=-  (The Sysop's last name)
  161.  
  162. Example configuration file for GTUSER.BBS
  163. -----------------------------------------
  164. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  165. T&J Software        <=-  (Change this to your BBS name)
  166. Tom                 <=-  (The Sysop's first name)
  167. Wildoner            <=-  (The Sysop's last name)
  168. 1                   <=-  (COM port number - defaults to 1)
  169. 1                   <=-  (Node number - defaults to 1)
  170.  
  171. Example Batch File
  172. ~~~~~~~~~~~~~~~~~~
  173. A sample batch file is included and is similer to the following:
  174.    ECHO OFF
  175.    CD\DOORS\SCRAM           <=- Switch to the door's Directory.
  176.    SCRAM SCRAM.CFG          <=- Execute the door program and pass the
  177.                                 configuration filename to the program.
  178.    CD\PCB                   <=- Go back to PCB DIR when user exits door.
  179.    BOARD                    <=- Restart BBS.
  180.  
  181. This Door is multi-node  compatible so you may run more than 1 node from
  182. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  183. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  184. variables, (q.v.)
  185.  
  186. Environment Variables
  187. ~~~~~~~~~~~~~~~~~~~~~
  188. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  189. variables. Non-PCBoard systems may also use these variables by including
  190. the following in either your BBS batch or AUTOEXEC.BAT
  191.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  192.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  193. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  194. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  195. .CFG file for multi-node operation!
  196.  
  197. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  198. command line.  For example:
  199.  
  200.      SCRAM SCRAM.CFG /5
  201. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  202.      SCRAM SCRAM.CFG /%IRQ%
  203.  
  204. This tells the program to use IRQ 5 instead of the standard IRQ.
  205.  
  206.   Had reports of conflicts when using non-standard IRQ's on Novell/Netware
  207.  systems. Seems Novell also uses the / character so something went screwy
  208.  somewhere. So I added the * (asterisk) which may be used instead of the /
  209.  in case of a conflict. In other words, /%IRQ% and *%IRQ% will both work
  210.  and are interchangeable.
  211.  
  212. When specifying the location of the system file on line 1 of the doors .CFG
  213. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  214. and %wcnodeid%. Some examples:
  215.  PCBoard: 
  216.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  217.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  218.  
  219.  Wildcat!:
  220.    USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%
  221.  
  222. Non-PCBoard systems may use the PCB environment variables by setting them
  223. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  224.  SET PCBDRIVE=C:
  225.  SET PCBDIR=\BBSDIR
  226.  SET PCBNODE=1
  227.  
  228. Fossil Driver Support
  229. ~~~~~~~~~~~~~~~~~~~~~
  230. DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
  231. Fossil driver instead of the standard COM ports, just put /FD on the command
  232. line when running the door. For example:
  233.      MYDOOR MYDOOR.CFG /FD
  234. indicates that a Fossil driver is present and should be used. If no Fossil
  235. driver is detected, DoorFrame will print a message to that effect and exit
  236. the door gracefully.
  237.  
  238.  
  239. Sysop Keys
  240. ~~~~~~~~~~
  241. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  242.          written to DOOR.SYS and USERS.SYS
  243. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  244.          and/or written to DOOR.SYS and USERS.SYS
  245. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  246. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  247.          and/or written to DOOR.SYS and USERS.SYS
  248. F8    -  Returns the caller involuntarily to the BBS.
  249. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  250.          and/or written to DOOR.SYS and USERS.SYS
  251. F10   -  Activates SysOp CHAT mode within the DOOR.
  252. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  253. UP    -  Give the caller extra time while in the DOOR.  
  254. DN    -  Subtract time from the caller while in the DOOR. 
  255. HOME  -  HELP key for Status Line options.
  256. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  257. ALT-X -  PCBoard will exit after current caller logs off. Value is
  258.          passed to PCBoard. Not available on non-PCBoard systems.
  259.  
  260.  
  261. YOUR CONFIGURATION FILE
  262. ~~~~~~~~~~~~~~~~~~~~~~~
  263. Change the SYSOP.CFG file to meet your needs:
  264.  
  265. 20
  266. 5
  267. N
  268. C:\BULL.BBS
  269. C:\BULL.BBS
  270. Y
  271. 4
  272.  
  273. LINE 1: Number of words/play a user may attempt.
  274. LINE 2: Current month. Used for resetting the scores monthly!
  275. LINE 3: Tournament mode (Y or N)
  276. LINE 4: Path & Filename to your color bulletin.
  277. LINE 5: Path & Filename to your ASCII bulletin.
  278. LINE 6: Do you want bulletins created? Y or N
  279. LINE 7: How many times a player may enter the door per day.
  280.  
  281.  
  282. TOURNAMENT MODE
  283. ~~~~~~~~~~~~~~~
  284. Turning tournament mode on does the following: The first player of the
  285. day will have to wait a few seconds until the tournament words are
  286. selected. Next, the tournament words will be compiled into a file
  287. called TOURNY.TXT. All users who play today will get the same words
  288. (scrambled differently).
  289.  
  290. LOCAL MODE
  291. ~~~~~~~~~~
  292. To run in LOCAL mode simply run SCRAMBLE using the LOCAL command line:
  293.  
  294. Example: SCRAM LOCAL
  295.  
  296. RESETTING
  297. ~~~~~~~~~
  298. Scramble will reset at the first of each month -- no maintenance
  299. needed. However, you can reset Scramble any time you wish using the
  300. UTILITY command string and then selecting the appropriate menu
  301. item.
  302.  
  303. WORD LISTS
  304. ~~~~~~~~~~
  305. Word lists are now history, we've compiled the words into one large
  306. database of words. This has dramatically increased the speed of the
  307. door!
  308.  
  309. FUTURE VERSIONS
  310. ~~~~~~~~~~~~~~~
  311. > What would you like to see added?
  312. > More Words!!
  313. > Word Editor.
  314.  
  315. VERSION HISTORY
  316. ~~~~~~~~~~~~~~~
  317. Version 1.00 ......... First release. 2/2/91
  318. Version 1.10 ......... Maintenance update. Changed BBS name. 8/17/91
  319. Version 2.00 ......... Now using BASIC PDS v7.1, all external files
  320.                        placed inside the main code, now support WC!
  321.                        2.x and 3.x, added tournament mode. 10/1/91
  322. Version 2.10 ......... Fix for BBS running with com port unlocked.
  323.                        Other small mods made also.  02/01/92
  324. Version 3.00 ......... Converted to DoorFrame routines -- facelift
  325.                        for the program. 02/23/92
  326. Version 3.10 ......... Recompiled using newer DoorFrame routines and
  327.                        added new bulletin routines.  04-17-1992
  328. Version 3.50 ......... Cleaned the code a little, added the ability
  329.                        to view the TOP TEN while in the door, got
  330.                        rid of the SEXTRA program, made a new RESET
  331.                        program, moved tournament routines inside the
  332.                        main code. 05-16-92
  333. Version 3.60 ......... Verify and Setup have been moved into the main
  334.                        code. Door updated with the newest door routines.
  335.                        05-24-92
  336. Version 3.60 ......... Fixed small problem with Scramble not resetting
  337.                        the scores monthly. 06-06-92
  338. Version 3.70 ......... Basically re-wrote the entire door. Got rid of
  339.                        some menacing screens. Added 'V' at the main
  340.                        menu to view the scores. Added almost 30,000
  341.                        words to the door. Now supports fossil drivers
  342.                        and IRQ number larger than one
  343.                        digit. Got rid of the BONUS CATAGORY listing
  344.                        and decided to give bonus points just on word
  345.                        length. Added a new timer function that will
  346.                        give 20 seconds plus however many letters there
  347.                        are in the word. Added better support for
  348.                        boards running in a network environment and
  349.                        also now supports the short version of
  350.                        DOOR.SYS. The screen now automatically redraws
  351.                        after a CHAT or DROP to DOS. Got rid of the
  352.                        VERIFY program to verify word lists. The door
  353.                        will now run "registered" when playing locally
  354.                        and allow multiple people to play locally
  355.                        instead of just the sysop. 12-04-1992
  356. Version 3.80 ......... Got rid of all the seperate word lists and
  357.                        compiled to words into one large database,
  358.                        added support for COM0-15, added support for
  359.                        more than one play per day, bulletins are
  360.                        now optional, speeded up the code a little.
  361.                        05-15-1993
  362. Version 3.90 ......... Added support for COLOR or MONO while in the
  363.                        door, added more sysop controls over keyboard
  364.                        timeout, local/sysop displays, added better
  365.                        error handling routines. Added 'T' in the main
  366.                        menu for toggling color on or off. Dropped
  367.                        support for CHAIN.TXT. Added better support for
  368.                        Wildcat IM and PCBoard/M versions.
  369.  
  370. That's all there is to it! If you have any problems or questions
  371. please feel free to call the T&J BBS at (717)325-9481.
  372.  
  373. See the REGISTER.TXT file for registering.
  374.  
  375. Your users will get a lot of duplicate words until the game is
  376. registered.
  377.