home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / TBANK107.ZIP / TBANK107.DOC < prev    next >
Encoding:
Text File  |  1992-02-17  |  11.8 KB  |  237 lines
  1.         ┌─────────────────────────────────────────────────────────────┐
  2.         │ WWIV Online Time Bank V1.07 Installation and Documentation. │
  3.         │    Doctor Fred (1@9800) Maniac Mansion ]I[ 908-525-8295     │
  4.         └─────────────────────────────────────────────────────────────┘
  5.  
  6.                                V1.07 - 02/17/92
  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. TBANK107.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. TBANK107.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.xx 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.                                  REGISTRATION
  55.                                  ------------
  56.  
  57. Registration entitles you to BUG UPDATES and UPGRADE NOTICES.  You can
  58. register this door by selecting the REGISTER ME option from within the
  59. Timebank (If you are in WWIVNet).  Currently, there is no charge to register.
  60. Even if you registered earlier, I suggest that you re-register this version.
  61. The next version of this door WILL require a registration fee (to help me
  62. recoup the costs of the COMM routines I purchased).  Those already registered
  63. (FREE) by 06/15/92, will be eligible for a reduced rate on the next version.
  64. I expect the next version to have quite a few new features.
  65.  
  66.  
  67.  
  68.                                  INSTALLATION
  69.                                  ------------
  70.  
  71. 1.  Copy All EXE files to your main bbs directory.
  72.      (Where BBS.EXE and BBS.COM are located)
  73.  
  74. 2.  Make a backup copy of your USER.LST file (In the data directory).
  75.  
  76. 3.  Run the bbs, signon, type //CHAINEDIT and set up the following options.
  77.  
  78.  
  79. A.  Description  : TimeBank/Casino
  80. B.  Filename     : TBANK107 %1
  81. C.  SL           : 50                <-- Change to suit your needs.
  82. D.  AR           : None              <-- Change to suit your needs.
  83. E.  ANSI         : Optional
  84. F.  DOS Interrupt: NOT Used          <-- *** MUST BE "Not Used" ***
  85. G.  300 Baud     : Allowed           <-- Change to suit your needs.
  86. H.  Shrink       : Yes               <-- *** MUST BE "Yes" ***
  87.  
  88.  
  89. This Door MUST use the SHRINK options, or it will not function properly.
  90.  
  91.  
  92. 4.  Now run TBEDIT.EXE and select option 1 to setup your configuration.
  93.     If you have modified your source code, be sure to compile & run the
  94.     TBSAFE.C file first.
  95.  
  96. That's It.... Enjoy....
  97.  
  98.  
  99.                          NOTES ON USING THE TIME BANK
  100.                          ----------------------------
  101.  
  102. There are several things you should be aware of when using this door.
  103.  
  104.   1.  The current version is restricted to your first 2000 users.
  105.       I didn't think there would be that many systems with more than
  106.       2000 users.  It will still run on systems with more than 2000
  107.       users, but any user number greater than 2000 is turned away.
  108.       Contact me if you need more than 2000 users.
  109.  
  110.   2.  The Default Account Limit used to be 120 minutes.  Now, I'd
  111.       suggest making it much higher (like 99999).  If you make this limit
  112.       too low, the users won't be able to win any time in the gambling
  113.       sections.
  114.  
  115.   3.  If the user changes his name, or if a user is deleted and
  116.       a new user reuses the same number, the account will be
  117.       reset to 0 minutes.
  118.  
  119.   4.  If the BBS uses an external event, please make sure that the EVENT
  120.       time is NOT set to 00:00.  If the time is set to 00:00, then the
  121.       timebank will NOT think you are using an external event.
  122.  
  123.   5.  The TBLIST program will generate a listing of each users balance.
  124.       The list can be sent to a printer by using the following command at
  125.       the normal DOS prompt: TBLIST > LPT1: or saved to a file by typing
  126.       TBLIST > filename.
  127.  
  128.   6.  If you are upgrading from an earlier version, just copy the files over
  129.       the old ones, and run TBEDIT.EXE to setup the configuration.  You will
  130.       not lose your old data (It's compatible with earlier versions).
  131.  
  132.   7.  Sysops in WWIVNet can now receive automatic free upgrades via the
  133.       network.  Simply use the REGISTER ME option from within the Timebank,
  134.       and make sure DE998.EXE is installed in your BBS directory.  I will add
  135.       your name to the registered list.  When an upgrade occurs, you will
  136.       be notified automatically.
  137.  
  138.   8.  If you have given a user extra time via the F8 key multiple times, it
  139.       is perfectly normal for the BANK to show more time than the BBS does.
  140.       This is not a bug in the timebank.  It really indicates that you have
  141.       given the user more time than you realize.  Most likely because of an
  142.       external event.  For example.  An external event occurs in 30 minutes,
  143.       the user has only 10 minutes left, but you press the F8 key 10 times
  144.       (what you have done is given the user 50 minutes extra time, for a
  145.       total of 60 minutes), but the BBS will only show 30 minutes because
  146.       the external event occurs in 30 minutes.
  147.  
  148.   9.  The Timebank DOES work.  If you don't believe it, call my system and
  149.       see for yourself.  If you are having trouble, try the following steps.
  150.       Make sure it is installed exactly as stated here.  Make sure you have
  151.       FILES=20 (or more) in your config.sys.  REMOVE any TSR's.  Run
  152.       TBEDIT.EXE and setup configuration properly.  99% of all problems
  153.       I've heard of can be resolved by the above methods.  I have also heard
  154.       that some versions of ANSI.SYS shipped with MS-DOS do not work
  155.       properly all the time (This may be the case, if you see everything
  156.       on one line).  If that is the case, you might want to try one of the
  157.       ANSI.SYS substitutes (FANSI.SYS, etc...).
  158.  
  159.  
  160.  10.  TBEDIT will not allow you to edit an account if the user has not
  161.       opened it yet.  You can get around this, simply //chuser to that
  162.       account, Enter the timebank, and deposit 1 minute.  This is sufficient
  163.       to establish the account.  TBEDIT will then allow you to edit the
  164.       account.
  165.  
  166.  11.  Changing the configuration in TBEDIT resets the lottery and the
  167.       registration status.
  168.  
  169.  
  170.                               ┌───────────────┐
  171.                               │ Revision List │
  172.                               └───────────────┘
  173.  
  174. V1.00   5/21/90 - Initial Release.
  175.  
  176. V1.01   6/04/90 - Default Maximum Account Limit (120 Minutes)
  177.                   can now be altered via TBEDIT.
  178.  
  179. V1.02   6/20/90 - Slight Modifications to the TBEDIT program.
  180.                   (Cosmetic Changes Really).
  181.  
  182. V1.03  10/13/90 - Added the GAMBLE TIME option to TBEDIT and
  183.                   TIMEBANK.EXE.  Added userrec adjustments so users
  184.                   with modified source code can now use this door.
  185.  
  186. V1.04  01/27/91 - Major changes made.  Program now recognizes and
  187.                   handles the Scheduled Event.  Added MANY new options.
  188.                   Blackjack added.  Can limit the maximum withdrawls.
  189.                   Lots more comments in the sysoplog.  Colors changed
  190.                   slightly.  You can now suppress the Odds Display.
  191.                   Door keeps running until you are done or hangup.
  192.                   Will not allow access to the door if within 10 minutes
  193.                   of an external event.  Memory usage made more efficient.
  194.                   TBEDIT.EXE modified to handle the new options.
  195.  
  196. V1.05  07/07/91 - Added configurable gold/time exchange.  Timebank can now
  197.                   determine if you are not using DOS interrupt, and will
  198.                   ask you to install it properly.  Configuration changed
  199.                   slightly.  You will not lose data by upgrading to 1.05.
  200.                   Timebank now has a BUG ALERT/UPGRADE NOTICE feature.
  201.                   It's a little long winded to explain here, but if you're
  202.                   interested, contact me.  Also, the door now uses a TBANK
  203.                   sub-directory (which it will create) to store it's data
  204.                   files.  TBEDIT & TBLIST were also modified to use the TBANK
  205.                   sub-directory.  It may be possible to move TIMEBANK.EXE to
  206.                   that directory, and run it from there, but I haven't tried
  207.                   it yet.  The door now stays in the gambling sections until
  208.                   either the person's account is empty, or they wish to exit
  209.                   it.  Registration Policy has been changed.
  210.  
  211. V1.07  02/17/92 - Now uses it's own Buffered COMM and ANSI routines. (Doesn't
  212.                   use Wayne's DOS INTERRUPT routines anymore).  The data file
  213.                   was expanded (to allow future options).  Added the Instant
  214.                   Lottery.  Dealer now wins on a draw in BLACKJACK.  Built-In
  215.                   REGISTER-ME option for WWIVNet Sysops.  TBEDIT was modified
  216.                   to convert old Timebank data files to the new version.
  217.                   The last lottery winner can not play again until someone
  218.                   else wins (or the configuration is changed in TBEDIT)
  219.  
  220. V1.08  Future   - Ability to limit the amount of lottery tickets that can be
  221.                   purchased each day.  Ability to set a maximum DAILY
  222.                   withdrawl limit (as opposed to the maximum time online).
  223.                   The door will show the name of the last lottery winner.
  224.                   Possibly different limits allowed for different users.
  225.                   Ability to charge a transaction fee (GOLD) for each
  226.                   transaction.  (More as I think of them).
  227.  
  228.  
  229. I can be reached via WWIVNet  1@9800  or you can call my bbs
  230.  
  231.                               Maniac Mansion ]I[
  232.                                  908-525-8295
  233.               300/1200/2400/9600/19200+ BPS HST/V.32/V.32bis/V.42
  234.                  ┌─────────────────────────────────────────┐
  235.                  │Doctor Fred #1@9800 - Group 7 Coordinator│
  236.                  └─────────────────────────────────────────┘
  237.