Revision history is at the end of this doc SFBANK Door Version 3 from Bob Zimmerman ------------------------------------------ This is another door designed for use with Spitfire BBS software. This door will allow users to deposit "time" into a bank. This time is subtracted from their current session. When they need to, they are able to withdraw time so they have more time for that session. Here is the basic way it works. A user, that is logged on and has 50 minutes left, can start the door, and deposit those 50 minutes (or any part of them). He is then able to withdraw those 50 minutes or any part of them at a later date. There is a "maximum" amount of time allowed in an account. The default is 60, but can be set to any amount using the /M command line parameter. For example, SFBANK /M=45 requests a maximum of 45 minutes. The user is not allowed to "deposit" or save more then this time. It prevents a user from storing 3 hours and using them all at a single session. There currently are no utilities for this door. But I do see the need for a utility that will look at the users file, and as users are no longer a member of the board, they will be "dropped" from the SFBANK file. This utility will only be available to registered users. THE SYSOP HAS AN UNDOCUMENTED OPTION. USERS WITH SECURITY LEVEL OF 999 CAN USE OPTION 'L' FROM THE MENU. It will list all users in the database with their bank times. Installation ------------ 1) Place the SFBANK file in a directory by itself. It will generate a file called SFBANK.DAT which is the "bank" file. *** WARNING*** Although the following doc explains how to install SFBANK on the File, Message or Main menus, you should only install it on the DOORS Menu until version 2.8 of Spitfire is released! 2) The SF.BAT or SFMAIN, SFMESS or SFFILE.BAT file should be updated to copy the SFDOORS/SFMAIN,SFMESS,SFFILE .DAT file to the SFBANK directory. The following code should be used: COPY SFDOORS.DAT C:\SFBANK SFBANK /M:30 /log=c:\sf\callers.tmp /dat=sfdoors.dat The above assumes this is run as a door. To run as a Sysop Configurable option, use SFMAIN.DAT, SFFILE.DAT OR SFMESS.DAT. The /M:30 requests a maximum of 30 minutes stored per user. (see above for full description). 60 minutes is the default if no /M parameter is found. /LOG requests the normal Spitfire CALLER.LOG is used for logging data. If no /CALLER is found, it will create the log in a file called PRIVATE.LOG. The parameter of /NOLOG will surpress the log totally! You should point this to the CALLERS.TMP file in the node directory. Registration ------------ All questions should be directed to: Bob Zimmerman Sysop - The Mainframe BBS 312-364-0425 2400/1200/0300 708 area code after Nov 4. The Mainframe PO Box 1387 Arlington Heights, IL 60006 MCI Mail: R. Zimmerman 386-4706 Compuserv 72371,1700 The above mailing address should be used for the registration fee. For the current version (1.5), registration is $15.00. When this is received, a ZIP file will be created on my BBS and made available for you to download. If you want me to send you the disk and this manual printed, add $5 for 5 1/4 disk or $7 for 3 1/2 disk. If you prefer, your package can be delivered via EASYPLEX of Compuserv. Registration plus Easyplex delivery will cost an additional $5. Registration will get you a specially compiled version that eliminates the front end "unregistered copy" message and will eventually get you the utility described above (to match against SFUSERS). You are granted 60 days to evaluate this program. After that 60 day period, if you choose to continue running this program, you should register the product! Version 1.1 Fixed a minor bug in calculating maximum time available. Fixed the deposit and withdraw prompts. Now if a user has not time to withdraw, and they select withdraw, it will simply tell them they have 0 minutes to withdraw and display the menu. (It won't let them deposit or withdraw 0 minutes!) Version 1.2 Added parameters /F and /T. The /F and /T specify a range of hours that the user CANNOT withdraw time during. For example, if you want users to be able to deposit time all day, but from 6 to 10 pm, you dont want them to be able to withdraw time, you could code SFBANK /CALLER /M=45 /F=18 /T=21. This would prevent anyone from withdrawing time between 6:00pm and 9:59pm. Version 1.3 Updated to work with Spitfire 2.8 (which is scheduled for release late fall. Version 1.4 Will not allow users to deposit all of their time. It only will allow them to deposit everything but 5 minutes. This will keep a user from depositing all of their time and returning to the BBS which would log them off immediately. Version 1.5 SFBANK itself has not been modified (possibly minor speed enhancements). With v1.5, a new utility program called SFBANKU for registered users is available. This utility allows a sysop to maintain the BANK (SFBANK.DAT). He is able to add users and time for those users, edit records (which includes deleting a user, modifying their time) etc... This will allow a sysop the ability to "give" some time to a registered user, even though he never made a deposit. As of this version, because of this extended utility, registration is not $15. For all previous users who have registered, the utility is free. You can pick your reigistered copy up from the Mainframe BBS. V1.6 This now runs from the SFMNUEXT correctly (extend a menu)... All parameters that take values (like /T etc...) are required to contain and = sign now. For example: /t=0300 is valid. v3.0 Updated to work with Spitfire 3.0 v3.1 Now honors Spitfire On Time Events and won't let callers withdraw too much time.