home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac / stab_221.zip / SYNC_TAB.DOC < prev    next >
Text File  |  1994-05-08  |  19KB  |  406 lines
  1.  
  2.                               Sync_TABS  V2.21
  3.                                     for
  4.                           Synchronet BBS V1C & 2.XX
  5.                                     by
  6.                             (C)1994 Dean Lodzinski
  7.                             Hologram Computing BBS
  8.                                (908) 727-1914
  9.                              Fidonet: 1:107/633
  10.                       Dean.Lodzinski@Hologram.MetroNJ.Org
  11.  
  12.                           Document Updated: 5/8/94
  13.  
  14.                       FREQ: SYNC_TAB for latest version
  15.  
  16.         Disclaimer
  17.         ==========
  18.  
  19.         Use of Sync_TABS is solely at your own risk.  Dean Lodzinski and
  20.         Hologram Computing shall not be liable for any damage to your system,
  21.         self, data or anything which is caused by using this program.  The
  22.         use of this program is solely at your own risk.  I have tested this
  23.         program, and to the best of my knowledge, functions as stated in
  24.         this documentation.  If it should not work as stated or if it ceases
  25.         to function or functions in a way not stated in this documentation,
  26.         I am not responsible for any damage.  I am under no obligation to
  27.         make future enhancements or support this product if I so choose.
  28.         This product is sold as is.
  29.  
  30.         Copyright Notice                         
  31.         ================
  32.  
  33.         Sync_TABS and all associated files are copyrighted by Dean Lodzinski
  34.         and Hologram Computing.  Use of this product constitutes your
  35.         agreement to abide by the laws and regulations governing copyrights
  36.         locally and internationally.  Dean Lodzinski and Hologram Computing
  37.         have the right to take action on any breach of copyright in any
  38.         jurisdiction whatsoever.
  39.  
  40.            Well, that's the end of that stuff.  Yuk!
  41.  
  42.  
  43.     WELCOME
  44.     =======
  45.  
  46.     Welcome to the Synchronet TABS Door.  This door is written exclusively
  47.     for Synchronet BBS software V1C & 2.xx.  I can't guarrantee compatability
  48.     with older or newer versions of Synchronet BBS Software.  Sync_TABS is
  49.     shareware.  If you are making some money running your board using
  50.     TABS, then the $10 registration fee shouldn't kill you.  If you aren't
  51.     making money using TABS, maybe this door will help you do it.  More on
  52.     the registration will follow.
  53.  
  54.     Synchronet TABS Door is for SysOps who are clients of TABS.  It will
  55.     allow users to enter Subscription IDs and have their main level,
  56.     expiration date, credits, flags, exemptions, restrictions, and
  57.     minutes updated upon entering a valid Subscription for your BBS.
  58.  
  59.     Dean Lodzinski and Hologram Computing are not associated with TABS
  60.     in any way, shape or form, except as a client of TABS.  Any questions,
  61.     comments, criticism, complaints, or information about TABS should be
  62.     directed to the phone number and address below.
  63.  
  64.     TABS is a service of True Media, Inc. 1270 Clearmont Street
  65.                          Palm Bay,  FL   32905   (407) 722-3150
  66.  
  67.     To find out what TABS is, read the files in TABSINFO.ZIP, which is
  68.     included in this archive.
  69.  
  70.     Installation
  71.     ============
  72.  
  73.     Name                        Synchronet TABS 900 Subscriptions
  74.     Start-up Directory          C:\SBBS\XTRN\TABS  (or whatever yours is!)
  75.     Command Line                SYNC_TAB <alt $> [optional options] (See below)
  76.     Clean-up Command Line
  77.     Cost in Credits             0
  78.     Access Requirements         (Whatever you want)
  79.     Execution Requirements      (Whatever you want)
  80.     ANSI Required               No
  81.     Multi-User                  Yes   (Version 1.20+ supports Multi-User)
  82.     Intercept I/O Interrupts    Yes
  83.     Shrink BBS                  No
  84.     Modify User Data            Yes
  85.     Uses WWIV Color Codes       No
  86.     Execute on Event            No
  87.     Menu Command Keys           Main ( )        Transfer ( )
  88.     BBS Drop File Type          Synchronet      XTRN.DAT (Use Real Names)
  89.     Place Drop File In          Node Directory
  90.  
  91.          The <alt $> is a dollar amount, from 1-99, without the $.  Currently
  92.          TABS has $10 & $25 subscriptions.  This will allow you to add a
  93.          third subscription amount if TABS has a new option.  It can also
  94.          be used for test purposes.  Even if you don't use it, you must
  95.          enter a number here.  (ie. Sync_TAB.exe 50)
  96.  
  97.          You can enter Sync_TAB DEBUG for some debugging information which
  98.          may or not be useful to you.  Use only for testing purposes.
  99.  
  100.     When first run, Sync_TABS will display a file called INTRO.TAB.  This
  101.     file should contain information about TABS and all your disclaimers about
  102.     the 900 number, under 18 must get permission from parents, etc.  This
  103.     file must exist as per your agreement with TABS and for legal purposes.
  104.  
  105.     When Sync_TABS runs for the first time, it will display the INTRO.TAB
  106.     file and then bring you right to the Profit Configuration Screen.
  107.     Enter what percentage TABS takes for each of the three subscription
  108.     types.  The default is 25%, just backspace over these numbers if you
  109.     wish to enter something else.  From the main menu you can always change
  110.     these percentages.  Sync_TABS will then use this new percentage for
  111.     any future IDs entered by users and tally everything up.  Any IDs that
  112.     were redeemed with the old percentages are kept as well as your profit
  113.     amounts so you will always have an accurate total of what you have
  114.     made to date.  To start from scratch, delete the PROFIT.DAT file.
  115.  
  116.     You will have to use the ", . /" commands to enter your subscription
  117.     ID numbers before Sync_TABS will allow users to redeem their codes.
  118.  
  119.     Create a file called BENEFITS.TAB that will contain information
  120.     on the benefits of subscribing to your BBS so the users can check
  121.     or double check what benefits they will receive for their money.
  122.     This file does not have to exist.
  123.     
  124.     Create a file called SPECIALS.TAB that will contain information about
  125.     any specials you may have running and in the SPECIALS.CFG file.
  126.  
  127.     A log file, called TABS_LOG.TXT will be created in this directory to
  128.     log VALID and NOT VALID subscription IDs entered by users.  All other
  129.     errors and messages are sent as a message to User #X on your system.
  130.     This user # is configurable in the SYNC_TAB.CFG file.
  131.  
  132.     The data filenames are as follows:
  133.         sync_tab.cfg                main config file - Must be present
  134.         10$code.cfg                 Config file for $10 ID redemption
  135.         25$code.cfg                 Config file for $25 ID redemption
  136.         XX$code.cfg                 Config file for Alt ID redemption
  137.         specials.cfg                Config for Special events (see below)
  138.         10$code.dat & 10$used.dat   for $10 Subscription IDs
  139.         25$code.dat & 25$used.dat   for $25 Subscription IDs
  140.         XX$code.dat & XX$used.dat   for the Alternate Amount$
  141.         profit.dat                  for Profit Summary Information
  142.  
  143.      The SYNC_TAB.CFG file must be present.  This is all you will need
  144.      if you are only accepting one type of ID.  If you are accepting
  145.      multiple $ Subscription IDs, you will need to create a config
  146.      file for each one with the names above *BUT* you will still need
  147.      the SYNC_TAB.CFG file for Sync_TABS to work.
  148.  
  149.     All VALID IDs will be marked as *USED* in the code.dat files and
  150.     placed in the used.dat files.  If your code.dat files get too big
  151.     just remove the lines that say *USED*.  Keep a backup for safety
  152.     as always.
  153.  
  154.  
  155.     Sync_TABS.CFG File Setup
  156.     ========================
  157.  
  158. 60
  159. 30
  160. 0
  161. FLAG1ADD
  162. FLAG2ADD
  163. FLAG3ADD
  164. FLAG4ADD
  165. EXEMPTADD
  166. RESTRICTADD
  167. 0
  168. FLAG1REMOVE
  169. FLAG2REMOVE
  170. FLAG3REMOVE
  171. FLAG4REMOVE
  172. EXEMPTREMOVE
  173. RESTRICTREMOVE
  174. 1
  175. 0000000
  176. =======================================
  177. Line 1:  Main Level to raise user to upon valid subscription ID
  178. Line 2:  Days to extend description
  179. Line 3:  Credits to add to user's account
  180. Line 4:  Flags to adjust in Flag Set #1   *
  181. Line 5:  Flags to adjust in Flag Set #2   *
  182. Line 6:  Flags to adjust in Flag Set #3   *
  183. Line 7:  Flags to adjust in Flag Set #4   *
  184. Line 8:  Exemptions to adust in User's Account    *
  185. Line 9:  Restrictions to adjust in User's Account *
  186. Line 10: Minutes to Add to User's Bank            *
  187. Line 11: Flags to Remove in Flag Set #1 *  Synchronet V2.xx
  188. Line 12: Flags to Remove in Flag Set #2 *  Synchronet V2.xx
  189. Line 13: Flags to Remove in Flag Set #3 *  Synchronet V2.xx
  190. Line 14: Flags to Remove in Flag Set #4 *  Synchronet V2.xx
  191. Line 15: Exemptions to Remove   *          Synchronet V2.xx
  192. Line 16: Restrictions to Remove *          Synchronet V2.xx
  193. Line 17: User to send usage/error messages to (Usually SysOp #1)
  194. Line 18: Registration Code
  195.  
  196. * - Requires registration to actually update user.  Lines still need to be
  197.     present in sync_tab.cfg file.
  198.  
  199.     If you don't want to make any changes to a particular line, make sure
  200.     you leave it blank.  Any line after the Registration Code can be
  201.     used for comments, don't put comments on the same line as the option
  202.     lines.
  203.  
  204.     *NOTE*  Make sure there are no extra spaces after options.  For example,
  205.             if you enter 60 as the new level, make sure there aren't any
  206.             extra spaces after 60 or the MODUSER.DAT file will not be
  207.             updated properly. *** I M P O R T A N T ***
  208.  
  209.     *NOTE*  Synchronet V1C users must make sure they have all the
  210.             lines entered in the SYNC_TAB.CFG file even though V1C
  211.             does not have certain options.  Just leave the line
  212.             blank.  V1C SysOps will enter a - to remove a flag, exemption
  213.             or restriction.  V2.xx SysOps will just enter the flag,
  214.             exemption or restriction on the Remove lines without the -.
  215.  
  216.  
  217.    Special Subscription Events (SSE):  What they are and why to use them
  218.    =====================================================================
  219.  
  220.     So you may be asking "What's all this about Special Subscription Events."
  221.     Or "Why would I need them when I can modify user's accounts via the
  222.     10$code.cfg file."  The answer is simple: Encourage users to subscribe
  223.     to your system by giving them extra value for their money.  I will call
  224.     these extras "Perceived Values" as they may or may not be valuable to
  225.     certain callers.  Let's say that May is a slow month for callers and new
  226.     subscribers.  You can set up a SSE for every day in May that will give
  227.     the the users 15 extra days of subscription time and also 1,000,000
  228.     extra credits.  These values are above and beyond what is listed in the
  229.     configuration files.  Or every month on the 15th, give subscribers
  230.     a special access level, credits, time, etc.  We all like to get something
  231.     "free" or for "nothing".  We like the sound of it and so do the users.
  232.     Ask your users what Perceived Values they would like and set up SSE
  233.     according to their feedback.  Only you know what your traffic pattern
  234.     is for your BBS.  Here are some extra tools you can use to POSSIBLY
  235.     enhance your subscribing caller base.  Obviously, I make no guarrantee
  236.     that using SSE will bring you in more Subscribing Callers or more money.
  237.  
  238.     If a user enters a valid subscription ID for your BBS during a SSE
  239.     period, a flashing red S will be displayed after the subscription
  240.     amount in the TABS_LOG.TXT file.
  241.  
  242.     Now you may be thinking "But I told TABS that each caller would get
  243.     30 days of subscription time for each $10 call."  As long as you give
  244.     them at least 30 days you have met your obligation.  I do not recall
  245.     TABS saying that you can't give more than what you specified.
  246.  
  247.  
  248.     SPECIALS.CFG File Setup
  249.     =======================
  250.  
  251. May
  252. 8
  253. 30
  254. 50
  255. 100000
  256. Jun
  257. 0
  258. 0
  259. 0
  260. 2000000
  261. All
  262. 15
  263. 90
  264. 0
  265. 0
  266. All
  267. 0
  268. 45
  269. 0
  270. 10000
  271. .
  272. .
  273. .
  274. .
  275. .
  276. Really no limit except disk size as far as I can see
  277. ====================================================
  278. Line 1: Month.     First 3 letters of month name or All for all months
  279. Line 2: Day.       Specific numberic day of month or 0 for all days of month
  280. Line 3: Extra Days to Extend Subscription or 0 for no extra days and to just
  281.                    extend subscription by what is in the config files
  282. Line 4: New Level. New validation level or 0 to keep level that is in the
  283.                    10$code.cfg, 25$code.cfg or xx$code.cfg files
  284. Line 5: Extra Credits to add to subscription or 0 to only add credits that
  285.                    are in the configuration files   
  286.                    
  287.      The first special that matches the current date will be used.  There
  288.      is really no limit to the number of SSE that you can have in the
  289.      SPECIALS.CFG file except for possibly disk space.
  290.  
  291.      Months:  Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec, All
  292.  
  293.      Explanations of examples above:
  294.        Special 1:  If user enters a valid ID on May 8 they will receive
  295.                    30 extra days to their subscription, a level of 50,
  296.                    and 100,000 extra credits.
  297.        Special 2:  Any day in June the user will receive 2,000,000 extra
  298.                    credits.  The level and subscription time will be taken
  299.                    from the proper configuration file, no extension/changes.
  300.        Special 3:  On the 15th of each month, a user will have their
  301.                    subscription extended by 90 days.  Level and credits will
  302.                    be taken from the proper configuration file.
  303.        Special 4:  Every day of every month a user will have their
  304.                    subscription extended by 45 days and be given 10,000
  305.                    extra credits.  Level will be taken from configuration
  306.                    file.
  307.  
  308.           In the examples above, if Special 3 and Special 4 were reversed,
  309.           Special 3 would never be encountered because Every Day of Every
  310.           month would always be picked first.  *ORDER IS IMPORTANT*
  311.  
  312.  
  313.                                           
  314.         At the Sync_TABS main menu, there are at most 7 user choices
  315.         depending on whether you use each of the 3 subscription options.
  316.         Only options available to the user will be displayed.  User options
  317.         are displayed in what should be Red.
  318.  
  319.         B - Display BENEFITS.TAB file if it exists
  320.         D - Display the INTRO.TAB file again
  321.         S - Display SPECIALS.TAB file if it exists
  322.         1 - Enter a $10 Subscription ID for your BBS
  323.         2 - Enter a $25 Subscription ID for your BBS
  324.         3 - Enter a Alternate Amount$ Subscription ID for your BBS
  325.         Q - Quit back to the BBS
  326.  
  327.         SysOp Commands for Users with a level of 90+.  SysOp commands are
  328.         displayed in what should be Yellow.
  329.  
  330.         , - Enter $10 SID?????.TAB IDs into your active file
  331.         . - Enter $25 SID?????.TAB IDs into your active file
  332.         / - Enter Alternate Amount$ SID?????.TAB IDs into your active file
  333.         [ - Inquire about how many $10 VALID IDs are left for your BBS
  334.         ] - Inquire about how many $25 VALID IDs are left for your BBS
  335.         \ - Inquire about how many Alternate Amount$ VALID IDs are left
  336.             for your BBS
  337.         C - Change Percentages taken by TABS
  338.         L - Log file display
  339.         M - Modify/Change all Profit Statistics
  340.         P - Profit Summary Report
  341.  
  342.  
  343.     What Next?
  344.     ==========
  345.     Well, the rest is up to you.  Hopefully if you have gotten this far
  346.     you know what TABS is all about.  If not, read the TABSINFO.ZIP stuff.
  347.     That will answer all your questions and also let you know more about
  348.     how this program works.  This program follows the specifications in
  349.     the TABS_DEV.TXT file as closely as possible.  Changes were made to
  350.     allow the program to better fit the needs of TABS SysOps using
  351.     Synchronet.  The TABS_DEV.TXT file is also located in the TABSINFO.ZIP
  352.     archive.
  353.  
  354.  
  355.     Registration Information
  356.     ========================
  357.     You are entitled to use this program for 30 days.  After this time,
  358.     you either agree to send Dean Lodzinski the $10 registration fee or
  359.     discontinue use of this program and destroy all copies, both on paper
  360.     and on magnetic media.  You may not transfer your Registration Code
  361.     to any other users/sysops.  Your Code is non-transferable.  The
  362.     UNREGISTERED copy of Sync_TAB displays an unregistered message.  The
  363.     Key is based on the name of your BBS, so enter your BBS name exactly
  364.     as it is entered in SCFG.  I read the XTRN.DAT file to determine the
  365.     name of your BBS and use what I find to verify you have a valid
  366.     Registration Key.  You can send me a copy of an XTRN.DAT file created
  367.     by your copy of Synchronet if you are unsure as to what to enter.
  368.  
  369.  
  370.     Registration Form
  371.     =================
  372.  
  373.     Name: _______________________________________________________________
  374.  
  375.     Address: ____________________________________________________________
  376.  
  377.     City: _________________________________ State: ______ Zip: __________
  378.      (BBS Name is case sensitive)
  379.     BBS Name EXACTLY as in SCFG/XTRN.DAT:________________________________
  380.  
  381.     Phone:_______________________  BBS Phone: ___________________________
  382.  
  383.     Fidonet Address: ____________  Alternate Addresses: _________________
  384.         (Specify time zone please)
  385.     Hours your BBS is available to receive Crashed Netmail: _____________
  386.  
  387.     Password on my BBS if you will pick up code there:  _________________
  388.  
  389.     Where did you get your copy of Sync_TABS:  __________________________
  390.  
  391.  
  392.     I will be out of the country for a while.  I will have someone handle
  393.     all registration forms if I am not here.  They will send your code
  394.     via US Mail.  If I am around, I will Netmail your code via Fidonet
  395.     or send it via Internet mail.  Fill out the above form so we can read
  396.     it.  If we can't read it we can't make the registration number for you.
  397.     If I am around, I will make only 2 attempts to NETMAIL your code to
  398.     you.  After this I will mail it to you only.
  399.  
  400.     Mail check or money order, made payable to DEAN LODZINSKI for
  401.     $10 US Dollars to :
  402.                       Dean Lodzinski
  403.                       47 Mercury Circle
  404.                       South Amboy, NJ  08879-2464
  405.                       ATTN:  Sync_TABS Registration
  406.