home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / EVENTS / TBANK108.ZIP / TBANK108.DOC next >
Text File  |  1993-03-16  |  12KB  |  234 lines
  1.         ┌─────────────────────────────────────────────────────────────┐
  2.         │ WWIV Online Time Bank V1.08 Installation and Documentation. │
  3.         │    Doctor Fred (1@9800) Maniac Mansion ]I[ 908-525-8295     │
  4.         └─────────────────────────────────────────────────────────────┘
  5.  
  6.                                V1.08 - 03/15/93
  7.  
  8. The WWIV Online Time Bank is a program which allows your users to save their
  9. unused time for another call.  The program requires NO modifications to the
  10. BBS program.  It was written for WWIV V4.xx, and should work on all UNMODIFIED
  11. WWIV V4.xx Systems, unless Wayne Bell changes/changed the structure of the
  12. user file.  As written, this program works fine on my BBS (V4.20E).  Install
  13. this program at YOUR own risk.  Ansi.sys should be installed on your system
  14. for best results.  This door can be installed on a modified system IF you
  15. follow ALL the instructions.  The newest version of Timebank can always be
  16. found on my system, and I always upload it to Wayne Bell's BBS as well.
  17. I will also attempt to upload it to @5252.
  18.  
  19. There are several files included in this package:
  20.  
  21. TBANK108.EXE   -  The actual Time Bank Door.
  22. TBLIST.EXE     -  A utility program to list out active accounts.
  23. TBEDIT.EXE     -  A utility that lets you set configuration/modify accts.
  24. TBANK108.DOC   -  This text file.
  25. TBSAFE.C       -  A program to see if it's safe to use Time Bank
  26.                   (Only Needed If You Modified The BBS Source Code)
  27. DE998.EXE      -  This will allow you to receive BUG ALERTS/UPDATE NOTICES
  28.                   via WWIVNet.
  29.  
  30.  
  31.                                   ┌────────┐
  32.     IMPORTANT NOTE FOR THOSE WITH │MODIFIED│ WWIV V4.XX SOURCE CODE.
  33.                                   └────────┘
  34.  
  35. Skip over this section if you are running an UNMODIFIED WWIV 4.22 BBS!
  36. If you have modified the length or position of any of the fields in the User
  37. Record, follow these instructions VERY carefully.  Copy TBSAFE.C to the same
  38. directory as your BBS source code, and compile it using Turbo C.  Now run the
  39. TBSAFE.EXE program, and write down the 3 numbers presented (You will need them
  40. to setup the proper configuration file.
  41.  
  42.  
  43.                          IMPORTANT NOTE FOR ALL SYSOPS
  44.                          -----------------------------
  45.  
  46. In order to adjust the online time, it was necessary to directly access the
  47. User file (USER.LST in the data directory).  I highly recommended that you
  48. make a backup copy of that file BEFORE installing this Door.  To date, I have
  49. not encountered any situation which has damaged the file, but you should not
  50. take ANY chances.  Improper installation of this software CAN (and probably
  51. will) damage your USER.LST file, so don't take this warning lightly.
  52.  
  53.  
  54. If you are not running the standard WWIV 4.22 user record, than you need
  55. to compile the TBSAFE.C program to determine where in the user record certain
  56. fields are.  If you have not modified the user record, but are using a version
  57. of WWIV prior to 4.22 you may use the following values.
  58.  
  59. WWIV Version (stock) Used Offset   Time Offset   Gold Offset   Rec Length
  60. -------------------- -----------   -----------   -----------   ----------
  61.  4.22 (unmodified)          Defaults Automatically To Proper Values    
  62.  4.21a w/64 subs         624           628           644          832
  63.  4.21a w/32 subs         624           628           644          700
  64.  4.xx - all prior        624           628           644          700
  65.         to 4.21a
  66.  
  67.                                  INSTALLATION
  68.                                  ------------
  69.  
  70. 1.  Copy All EXE files to your main bbs directory.
  71.      (Where BBS.EXE and BBS.COM are located)
  72.  
  73. 2.  Make a backup copy of your USER.LST file (In the data directory).
  74.  
  75. 3.  Run the bbs, signon, type //CHAINEDIT and set up the following options.
  76.  
  77.  
  78. A.  Description  : TimeBank/Casino
  79. B.  Filename     : TBANK108 %1
  80. C.  SL           : 50                <-- Change to suit your needs.
  81. D.  AR           : None              <-- Change to suit your needs.
  82. E.  ANSI         : Optional
  83. F.  DOS Interrupt: NOT Used          <-- *** MUST BE "Not Used" ***
  84. G.  300 Baud     : Allowed           <-- Change to suit your needs.
  85. H.  Shrink       : Yes               <-- *** MUST BE "Yes" ***
  86.  
  87.  
  88. This Door MUST use the SHRINK options, or it will not function properly.
  89.  
  90.  
  91. 4.  Now run TBEDIT.EXE and select option 1 to setup your configuration.
  92.     If you have modified your source code, be sure to compile & run the
  93.     TBSAFE.C file first.
  94.  
  95. That's It.... Enjoy....
  96.  
  97.  
  98.                          NOTES ON USING THE TIME BANK
  99.                          ----------------------------
  100.  
  101. There are several things you should be aware of when using this door.
  102.  
  103.   1.  The current version is restricted to your first 2000 users.
  104.       I didn't think there would be that many systems with more than
  105.       2000 users.  It will still run on systems with more than 2000
  106.       users, but any user number greater than 2000 is turned away.
  107.       Contact me if you need more than 2000 users.
  108.  
  109.   2.  The Default Account Limit used to be 120 minutes.  Now, I'd
  110.       suggest making it much higher (like 99999).  If you make this limit
  111.       too low, the users won't be able to win any time in the gambling
  112.       sections.
  113.  
  114.   3.  If the user changes his name, or if a user is deleted and
  115.       a new user reuses the same number, the account will be
  116.       reset to 0 minutes.
  117.  
  118.   4.  If the BBS uses an external event, please make sure that the EVENT
  119.       time is NOT set to 00:00.  If the time is set to 00:00, then the
  120.       timebank will NOT think you are using an external event.
  121.  
  122.   5.  The TBLIST program will generate a listing of each users balance.
  123.       The list can be sent to a printer by using the following command at
  124.       the normal DOS prompt: TBLIST > LPT1: or saved to a file by typing
  125.       TBLIST > filename.
  126.  
  127.   6.  If you are upgrading from an earlier version, just copy the files over
  128.       the old ones, and run TBEDIT.EXE to setup the configuration.  You will
  129.       not lose your old data (It's compatible with earlier versions).
  130.  
  131.   7.  If you have given a user extra time via the F8 key multiple times, it
  132.       is perfectly normal for the BANK to show more time than the BBS does.
  133.       This is not a bug in the timebank.  It really indicates that you have
  134.       given the user more time than you realize.  Most likely because of an
  135.       external event.  For example.  An external event occurs in 30 minutes,
  136.       the user has only 10 minutes left, but you press the F8 key 10 times
  137.       (what you have done is given the user 50 minutes extra time, for a
  138.       total of 60 minutes), but the BBS will only show 30 minutes because
  139.       the external event occurs in 30 minutes.
  140.  
  141.   8.  The Timebank DOES work.  If you don't believe it, call my system and
  142.       see for yourself.  If you are having trouble, try the following steps.
  143.       Make sure it is installed exactly as stated here.  Make sure you have
  144.       FILES=20 (or more) in your config.sys.  REMOVE any TSR's.  Run
  145.       TBEDIT.EXE and setup configuration properly.  99% of all problems
  146.       I've heard of can be resolved by the above methods.  I have also heard
  147.       that some versions of ANSI.SYS shipped with MS-DOS do not work
  148.       properly all the time (This may be the case, if you see everything
  149.       on one line).  If that is the case, you might want to try one of the
  150.       ANSI.SYS substitutes (FANSI.SYS, etc...).
  151.  
  152.  
  153.   9.  TBEDIT will not allow you to edit an account if the user has not
  154.       opened it yet.  You can get around this, simply //chuser to that
  155.       account, Enter the timebank, and deposit 1 minute.  This is sufficient
  156.       to establish the account.  TBEDIT will then allow you to edit the
  157.       account.
  158.  
  159.  11.  Changing the configuration in TBEDIT resets the lottery and the
  160.       registration status.
  161.  
  162.  
  163.                               ┌───────────────┐
  164.                               │ Revision List │
  165.                               └───────────────┘
  166.  
  167. V1.00   5/21/90 - Initial Release.
  168.  
  169. V1.01   6/04/90 - Default Maximum Account Limit (120 Minutes)
  170.                   can now be altered via TBEDIT.
  171.  
  172. V1.02   6/20/90 - Slight Modifications to the TBEDIT program.
  173.                   (Cosmetic Changes Really).
  174.  
  175. V1.03  10/13/90 - Added the GAMBLE TIME option to TBEDIT and
  176.                   TIMEBANK.EXE.  Added userrec adjustments so users
  177.                   with modified source code can now use this door.
  178.  
  179. V1.04  01/27/91 - Major changes made.  Program now recognizes and
  180.                   handles the Scheduled Event.  Added MANY new options.
  181.                   Blackjack added.  Can limit the maximum withdrawls.
  182.                   Lots more comments in the sysoplog.  Colors changed
  183.                   slightly.  You can now suppress the Odds Display.
  184.                   Door keeps running until you are done or hangup.
  185.                   Will not allow access to the door if within 10 minutes
  186.                   of an external event.  Memory usage made more efficient.
  187.                   TBEDIT.EXE modified to handle the new options.
  188.  
  189. V1.05  07/07/91 - Added configurable gold/time exchange.  Timebank can now
  190.                   determine if you are not using DOS interrupt, and will
  191.                   ask you to install it properly.  Configuration changed
  192.                   slightly.  You will not lose data by upgrading to 1.05.
  193.                   Timebank now has a BUG ALERT/UPGRADE NOTICE feature.
  194.                   It's a little long winded to explain here, but if you're
  195.                   interested, contact me.  Also, the door now uses a TBANK
  196.                   sub-directory (which it will create) to store it's data
  197.                   files.  TBEDIT & TBLIST were also modified to use the TBANK
  198.                   sub-directory.  It may be possible to move TIMEBANK.EXE to
  199.                   that directory, and run it from there, but I haven't tried
  200.                   it yet.  The door now stays in the gambling sections until
  201.                   either the person's account is empty, or they wish to exit
  202.                   it.  Registration Policy has been changed.
  203.  
  204. V1.07  02/17/92 - Now uses it's own Buffered COMM and ANSI routines. (Doesn't
  205.                   use Wayne's DOS INTERRUPT routines anymore).  The data file
  206.                   was expanded (to allow future options).  Added the Instant
  207.                   Lottery.  Dealer now wins on a draw in BLACKJACK.  Built-In
  208.                   REGISTER-ME option for WWIVNet Sysops.  TBEDIT was modified
  209.                   to convert old Timebank data files to the new version.
  210.                   The last lottery winner can not play again until someone
  211.                   else wins (or the configuration is changed in TBEDIT)
  212.  
  213. V1.08  03/15/93 - Wow, it's been over a year since I worked on this.  Not
  214.                   much has changed, except that the bank has been upgraded to
  215.                   work with WWIV 4.22 and beyond.
  216.  
  217. V1.09  Future   - Ability to limit the amount of lottery tickets that can be
  218.                   purchased each day.  Ability to set a maximum DAILY
  219.                   withdrawl limit (as opposed to the maximum time online).
  220.                   The door will show the name of the last lottery winner.
  221.                   Possibly different limits allowed for different users.
  222.                   Ability to charge a transaction fee (GOLD) for each
  223.                   transaction.  (More as I think of them).
  224.  
  225.  
  226. I can be reached via WWIVNet  1@9800  or you can call my bbs
  227.  
  228.                               Maniac Mansion ]I[
  229.                                  908-525-8295
  230.               300/1200/2400/9600/19200+ BPS HST/V.32/V.32bis/V.42
  231.                  ┌─────────────────────────────────────────┐
  232.                  │Doctor Fred #1@9800 - Group 7 Coordinator│
  233.                  └─────────────────────────────────────────┘
  234.