home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / TJLOT17.ZIP / TJLOTTO.DOC < prev    next >
Text File  |  1995-01-29  |  15KB  |  379 lines
  1.  
  2.  
  3.                        ============================
  4.                            The T&J LOTTO Door!
  5.                        ============================
  6.                       COPYRIGHT 1992,95 T&J Software
  7.  
  8.         One of the T&J Software Collection of multi-BBS door programs.
  9.            Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
  10.                UltraBBS, Telegard, TriBBS, Remote Access, and
  11.                             Digiboard support!
  12.  
  13.                        VERSION 1.70     01/29/94
  14.  
  15.                                    By
  16.  
  17.                                Tom Wildoner
  18.                              397 West Broadway
  19.                               Jim Thorpe, PA
  20.                                   18229
  21.                             VOICE (717)325-9480
  22.                    *between 6:00 & 8:00 p.m. Eastern Time
  23.  
  24.                                   From
  25.  
  26.                                The T&J BBS
  27.                               (717)325-9481
  28.                              3 Nodes - 28.8k
  29.  
  30. LATEST VERSION:
  31. ===============
  32. Please call the T&J BBS for the latest version of this program.
  33.  
  34. LEGALITIES:
  35. ===========
  36. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  37. WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  38. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  39. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
  40. PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
  41. OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY.
  42.  
  43. DISTRIBUTION:
  44. =============
  45. You may make this file available for downloading from your BBS or you may
  46. upload it to any BBS of your choice, provided that you do not make any
  47. changes to the contents of the archive (ZIP file). The archive and its
  48. individual contents may not be used by any service that charges any money
  49. whatsoever, without the written permission of the author.
  50.  
  51. PROGRAM DESCRIPTION:
  52. ====================
  53. Be sure to read the MAINTENANCE section - this door requires nightly
  54. maintenance to be run!! <i.e.  TJLOTTO LOTTO>
  55.  
  56. The T&J LOTTO Door allows your users to select numbers on a type of
  57. lottery ticket. The number range is SysOp configurable along with the
  58. number or tickets a person may enter per day. As the SysOp, you can pick
  59. the prizes awarded for correctly getting 4, 5 or 6 digits correct.
  60.  
  61. The user gets a chance to pick 10 numbers per lottery ticket from the
  62. number range you specify. Running TJLOTTO with the command line LOTTO
  63. (maintenance program) must be run each night. The LOTTO command line
  64. picks the winning numbers (it selects 6 numbers from the range you specify)
  65. and then reads each of the users lottery tickets and checks for winners.
  66. It will LOG the PRIZE WINNING tickets to a special SYSOP.LOG file for
  67. your records. It will also keep a listing of the last 7 days of winning
  68. tickets for the users to check.
  69.  
  70. The door also maintains a statitics file which will keep track of how many
  71. times the door was played, how many tickets (total) have been purchased,
  72. and the total winning tickets (tickets matching 4, 5, or 6 digits).
  73.  
  74. The user can check all winning lottery tickets from the previous night
  75. and a summation of all PRIZE WINNING tickets for the last week.
  76.  
  77. The LOTTO command line maintenance program will create a color and ASCII
  78. bulletin either stating that NO winning tickets were picked or that there
  79. were winning tickets picked.
  80.  
  81. NOTE:
  82. =====
  83. When you register, you will receive a LOTTO.KEY file which will unlock
  84. the full version of the door. The user is limited to just ONE ticket
  85. until registered.
  86.  
  87. CONFIGURATION:
  88. =============
  89. Use the command line TJLOTTO UTILITY to create all the files needed
  90. and to easily reset the door from scratch!
  91.  
  92. Example configuration file for PCBOARD.SYS
  93. ------------------------------------------
  94. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  95. T&J Software        <=-  (Change this to your BBS name)
  96. Tom                 <=-  (The Sysop's first name)
  97. Wildoner            <=-  (The Sysop's last name)
  98.  
  99. Example configuration file for USERS.SYS
  100. ----------------------------------------
  101. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  102. T&J Software        <=-  (Change this to your BBS name)
  103. Tom                 <=-  (The Sysop's first name)
  104. Wildoner            <=-  (The Sysop's last name)
  105.  
  106. Example configuration file for DOOR.SYS
  107. ---------------------------------------
  108. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  109. T&J Software        <=-  (Change this to your BBS name)
  110. Tom                 <=-  (The Sysop's first name)
  111. Wildoner            <=-  (The Sysop's last name)
  112.  
  113. Example configuration file for USERINFO.DAT
  114. -------------------------------------------
  115. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  116. T&J Software        <=-  (Change this to your BBS name)
  117. Tom                 <=-  (The Sysop's first name)
  118. Wildoner            <=-  (The Sysop's last name)
  119. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  120.  
  121. Example configuration file for CALLINFO.BBS
  122. -------------------------------------------
  123. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  124. T&J Software        <=-  (Change this to your BBS name)
  125. Tom                 <=-  (The Sysop's first name)
  126. Wildoner            <=-  (The Sysop's last name)
  127.  
  128. Example configuration file for DORINFOx.DEF
  129. -------------------------------------------
  130. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  131.                           where 'x' is the BBS Node number.
  132. T&J Software        <=-  (Change this to your BBS name)
  133. Tom                 <=-  (The Sysop's first name)
  134. Wildoner            <=-  (The Sysop's last name)
  135.  
  136. Example configuration file for SFDOORS.DAT
  137. ------------------------------------------
  138. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  139. T&J Software        <=-  (Change this to your BBS name)
  140. Tom                 <=-  (The Sysop's first name)
  141. Wildoner            <=-  (The Sysop's last name)
  142.  
  143. Example configuration file for GTUSER.BBS
  144. -----------------------------------------
  145. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  146. T&J Software        <=-  (Change this to your BBS name)
  147. Tom                 <=-  (The Sysop's first name)
  148. Wildoner            <=-  (The Sysop's last name)
  149. 1                   <=-  (COM port number - defaults to 1)
  150. 1                   <=-  (Node number - defaults to 1)
  151.  
  152. Example Batch File
  153. ==================
  154. A sample batch file is included and is similer to the following:
  155.    ECHO OFF
  156.    CD\DOORS\LOTTO           <=- Switch to the door's Directory.
  157.    TJLOTTO TJLOTTO.CFG      <=- Execute the door program and pass the
  158.                                 configuration filename to the program.
  159.    CD\PCB                   <=- Go back to PCB DIR when user exits door.
  160.    BOARD                    <=- Restart BBS.
  161.  
  162. This Door is multi-node  compatible so you may run more than 1 node from
  163. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  164. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  165. variables, (q.v.)
  166.  
  167. Environmental Variables
  168. =======================
  169. When specifying the location of the system file on line 1 of the doors .CFG
  170. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  171. and %wcnodeid%. Some examples:
  172.  PCBoard: 
  173.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  174.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  175.  
  176.  Wildcat!:
  177.    USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%
  178.  
  179. Non-PCBoard systems may use the PCB environment variables by setting them
  180. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  181.  SET PCBDRIVE=C:
  182.  SET PCBDIR=\BBSDIR
  183.  SET PCBNODE=1
  184.  
  185. Non-Standard IRQ's
  186. ==================
  187. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  188. command line.  For example:
  189.  
  190.      TJLOTTO TJLOTTO.CFG /5
  191. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  192.      TJLOTTO TJLOTTO.CFG /%IRQ%
  193.  
  194. This tells the program to use IRQ 5 instead of the standard IRQ.
  195.  
  196.   Had reports of conflicts when using non-standard IRQ's on Novell/Netware
  197.  systems. Seems Novell also uses the / character so something went screwy
  198.  somewhere. So I added the * (asterisk) which may be used instead of the /
  199.  in case of a conflict. In other words, /%IRQ% and *%IRQ% will both work
  200.  and are interchangeable.
  201.  
  202. Fossil Drivers
  203. ==============
  204. T&J Lotto supports the use of Fossil drivers.  To tell your Door to use the
  205. Fossil driver instead of the standard COM ports, just put /FD on the command
  206. line when running the door. For example:
  207.      TJLOTTO TJLOTTO.CFG /FD
  208. indicates that a Fossil driver is present and should be used. If no Fossil
  209. driver is detected, the door will print a message to that effect and exit
  210. gracefully.
  211.  
  212. Sysop Keys
  213. ==========
  214. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  215.          written to DOOR.SYS and USERS.SYS
  216. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  217.          and/or written to DOOR.SYS and USERS.SYS
  218. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  219. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  220.          and/or written to DOOR.SYS and USERS.SYS
  221. F8    -  Returns the caller involuntarily to the BBS.
  222. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  223.          and/or written to DOOR.SYS and USERS.SYS
  224. F10   -  Activates SysOp CHAT mode within the DOOR.
  225. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  226. UP    -  Give the caller extra time while in the DOOR.  
  227. DN    -  Subtract time from the caller while in the DOOR. 
  228. HOME  -  HELP key for Status Line options.
  229. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  230. ALT-X -  PCBoard will exit after current caller logs off. Value is
  231.          passed to PCBoard. Not available on non-PCBoard systems.
  232.  
  233.  
  234.  
  235. -=-=-=-=-=-=-=-=-=-=-=- MISCELLANEOUS FILES -=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  236.  
  237. SYSOP.CFG FILE:
  238. ~~~~~~~~~~~~~~~
  239. Your SYSOP.CFG file should contain ALL the items listed below. You can use
  240. your text editor to edit the provided file.
  241.  
  242. You will get a gift certificate for
  243. $10 off a purchase from T&J Software
  244. You will get a gift certificate for
  245. $15 off a purchase from T&J Software
  246. You will get a gift certificate for
  247. $20 off a purchase from T&J Software
  248. C:\WC30\BULL\BULL99.SCR
  249. C:\WC30\BULL\BULL99.BBS
  250. 35
  251. 10
  252.  
  253. LINE 1&2: The prize that will be awarded for getting 4 numbers
  254.           correct. If you only use one line, leave line 2 blank! Try
  255.           to limit each line to 70 characters. This text will be
  256.           centered in the door display, so don't worry about centering.
  257. LINE 3&4: The prize that will be awarded for getting 5 numbers correct.
  258.           follow the same guidance as above.
  259. LINE 5&6: The prize that will be awarded for getting 6 numbers correct.
  260.           follow the same guidance as above.
  261. LINE   7: PATH & FILENAME to your color bulletin or NONE
  262. LINE   8: PATH & FILENAME to your ASCII bulletin or NONE
  263. LINE   9: The range for your numbers (i.e. from 1 to ??). Try keeping
  264.           this number between 30 and 80 in intervals of 5 (40, 45, 50
  265.           55, etc). What are the chances of winning you ask? See the
  266.           section titled CHANCES?!? listed below.
  267. LINE  10: How many tickets a person can enter in one day.
  268.  
  269. The file MUST have all 10 lines!
  270.  
  271. THE BAD.USR FILE:
  272. ~~~~~~~~~~~~~~~~~
  273.  
  274. The BAD.USR file is just what is implied. It's there to keep bad users
  275. or users that have already won from entering the door. The file has
  276. the following format:
  277.  
  278. 1:> Sorry, you don't have access to this door!
  279. 2:> You have either already won a prize or are not allowed in the door!
  280. 3:> TOM WILDONER
  281. 4:> JANE WILDONER
  282. 5:> MIKE WILDONER
  283.  
  284. Lines 1 and 2 are reserved for the message you want to send to a bad
  285. users or user that has already won. Lines 3 to ?? is where you would
  286. plug in the users names who don't have access to the door. Use your
  287. favorite text editor to edit/maintain this file.
  288.  
  289. THE SPECIAL.USR FILE:
  290. ~~~~~~~~~~~~~~~~~~~~~
  291. The SPECIAL.USR file is just what is implied. It's there for special
  292. users of your system. Simply enter their name followed by a comma and then
  293. enter how many tickets they can play per day! See the example SPECIAL.USR
  294. file supplied with the door.
  295.  
  296. The number of tickets listed after their name will over-ride the default
  297. number of tickets you have listed in your SYSOP.CFG file. One idea
  298. you can use is to make the prize for getting 4 digits correct is increasing
  299. the number of tickets that user can play per day! If they hit 4 digits, add
  300. there name to the SPECIAL.USR file and increase the number of tickets they
  301. can play!
  302.  
  303. THE SYSOP.LOG FILE:
  304. ~~~~~~~~~~~~~~~~~~~
  305. Contains a listing of past winners or shows NO winners.
  306.  
  307. Local Playing
  308. =============
  309. Use the command line TJLOTTO LOCAL
  310.  
  311. CHANCES?!?
  312. ==========
  313. How often do you want your users to win? I randomly generated 25,000 tickets
  314. for each possible range of number (i.e. 1 to 40, 1 to 50, 1 to 60, 1 to 70,
  315. and 1 to 80). The data will show how many tickets had 0 numbers picked, 1
  316. number picked, etc.... Here are the results I obtained:
  317.  
  318. Number Range from 1 to 30, tickets generated: 25000
  319. 0: 1635  1: 6466  2: 9183  3: 5831  4: 1681  5: 199  6: 6
  320.  
  321. Number Range from 1 to 40, tickets generated: 25000
  322. 0: 3775  1: 9270  2: 8169  3: 3127  4: 615  5: 44  6: 1
  323.  
  324. Number Range from 1 to 50, tickets generated: 25000
  325. 0: 6093  1: 10228  2: 6516  3: 1880  4: 266  5: 18  6: 0
  326.  
  327. Number Range from 1 to 60, tickets generated: 25000
  328. 0: 7807  1: 10694  2: 5197  3: 1172  4: 123  5: 8  6: 0
  329.  
  330. Number Range from 1 to 70, tickets generated: 25000
  331. 0: 9554  1: 10374  2: 4215  3: 779  4: 78  5: 1  6: 0
  332.  
  333. Number Range from 1 to 80, tickets generated: 25000
  334. 0: 10953  1: 10090  2: 3384  3: 538  4: 36  5: 0  6: 0
  335.  
  336. As you can see, the higher the number, the fewer 4, 5, and 6 digit
  337. winners are. This doesn't mean that a user on his first attempt will
  338. not hit the BIG ONE (6 digits) on his first attempt at picking numbers
  339. from the range of 1 to 80!
  340.  
  341. If you have a very nice prize setup for hitting 6 digits, then use a
  342. higher number!
  343.  
  344. RESETTING THE DOOR:
  345. ==================
  346. Run TJLOTTO UTILITY and choose the reset door from scratch option!
  347.  
  348. MAINTENANCE!:
  349. ============
  350. You must run TJLOTTO with the LOTTO command line as part of your nightly
  351. maintenance for the door to operate properly! The maintenance routines
  352. for BBS's vary, so it's up to you to determine how to run this program as
  353. part of your maintenance. I run it at midnight each and every night!
  354.  
  355. Run it like this ---->    TJLOTTO LOTTO
  356.  
  357. FUTURE VERSIONS:
  358. ================
  359. Let me know what you would like to see!
  360.  
  361. VERSION HISTORY:
  362. ===============
  363. See the enclosed HISTORY.TXT file.
  364.  
  365. TIPS & HINTS:
  366. ============
  367. See the TJHELP.TXT file.
  368.  
  369. UPGRADING:
  370. =========
  371. See the enclosed UPGRADE.TXT file.
  372.  
  373. REGISTERING:
  374. ============
  375. That's all there is to it! If you have any problems or questions
  376. please feel free to call the T&J BBS at (717)325-9481.
  377.  
  378. See the enclosed registration form for ordering!  (REGISTER.TXT)
  379.