home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / DOOR / CAMSUB13.ZIP / CAM-SUB.DOC < prev    next >
Text File  |  1995-02-16  |  38KB  |  785 lines
  1.                             Cam's Subscription Door
  2.                  (C) Copyright 1994-1995 by Cam DeBuck Software
  3.                       (801) 785-6286 or (801) 785-6190 BBS
  4.  
  5. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  6.  
  7. DISCLAIMER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  8.  
  9. LICENSE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  10.  
  11. REGISTRATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  12.  
  13. Automated Transaction Services, Inc. . . . . . . . . . . . . . . . . . .   7
  14.  
  15. Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  16.  
  17. Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  18.      SUBCFG.EXE. . . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  19.  
  20.         Registration Information . . . . . . . . . . . . . . . . . . . .   9
  21.  
  22.         General Door Information . . . . . . . . . . . . . . . . . . . .   9
  23.            Location of BBS . . . . . . . . . . . . . . . . . . . . . . .   9
  24.            Accept Subscriptions. . . . . . . . . . . . . . . . . . . . .   9
  25.            Accept Donations. . . . . . . . . . . . . . . . . . . . . . .   9
  26.            Minimum Donation to Accept. . . . . . . . . . . . . . . . . .   9
  27.            Echo Dots for Card Number . . . . . . . . . . . . . . . . . .   9
  28.            Write to the Caller Logs. . . . . . . . . . . . . . . . . . .   9
  29.            Write to Sysop Comment Field. . . . . . . . . . . . . . . . .  10
  30.            Output User Info Files. . . . . . . . . . . . . . . . . . . .  10
  31.            Minimum Level for Subscribers . . . . . . . . . . . . . . . .  10
  32.            Orders File Type to Output. . . . . . . . . . . . . . . . . .  10
  33.            Sort the Subscription Options . . . . . . . . . . . . . . . .  10
  34.            Subscription Tax Rate . . . . . . . . . . . . . . . . . . . .  10
  35.  
  36.         Subscription Information . . . . . . . . . . . . . . . . . . . .  11
  37.            Description . . . . . . . . . . . . . . . . . . . . . . . . .  11
  38.            Cost. . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  39.            Security Level. . . . . . . . . . . . . . . . . . . . . . . .  11
  40.            Update Security Level . . . . . . . . . . . . . . . . . . . .  11
  41.            Expired Security Level. . . . . . . . . . . . . . . . . . . .  11
  42.            Update Expired Security Level . . . . . . . . . . . . . . . .  11
  43.            Days to Add to Expiration . . . . . . . . . . . . . . . . . .  11
  44.            Update Expiration Date. . . . . . . . . . . . . . . . . . . .  12
  45.            Clear UL/DL Counts. . . . . . . . . . . . . . . . . . . . . .  12
  46.            Amount of Files to Credit . . . . . . . . . . . . . . . . . .  12
  47.            Amount of Bytes to Credit . . . . . . . . . . . . . . . . . .  12
  48.            Credits . . . . . . . . . . . . . . . . . . . . . . . . . . .  12
  49.            Conferences . . . . . . . . . . . . . . . . . . . . . . . . .  12
  50.  
  51.         Paths and Filenames. . . . . . . . . . . . . . . . . . . . . . .  13
  52.            MENU. . . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  53.            SUBHELP . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  54.            WELCOME . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  55.            SUBLIST . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  56.            WARN. . . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  57.            NOTICE. . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  58.            RECEIPT . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  59.            CLOSE . . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  60.            THANKS. . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  61.  
  62.         Protocol Information . . . . . . . . . . . . . . . . . . . . . .  14
  63.  
  64.         Credit Card Information. . . . . . . . . . . . . . . . . . . . .  14
  65.  
  66.         Online Check Information . . . . . . . . . . . . . . . . . . . .  15
  67.  
  68.         Communication Information. . . . . . . . . . . . . . . . . . . .  16
  69.  
  70. SUBTXT.EXE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  16
  71.  
  72. CAM-SUB.EXE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  17
  73.  
  74. Event Operation (Online Checks). . . . . . . . . . . . . . . . . . . . .  18
  75.  
  76. Event Operation (Credit Cards) . . . . . . . . . . . . . . . . . . . . .  18
  77.  
  78. Maintenance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  19
  79.  
  80. SUBMGR.EXE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  19
  81.  
  82. CAM-SUB MACROS . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  19
  83. Introduction
  84.  
  85.   Welcome to the Cam's Subscription Door for PCBoard.  The door was written for
  86. the use of having your users subscribe to your BBS either by writing a check online
  87. or using their credit card.
  88.  
  89.   The door is very straight forward and easy to use.  Just about everything is
  90. configurable and can be changed by the Sysop to meet your needs.  All you have to
  91. do is run the appropriate .EXE file or modify a Menu/Help file.
  92.  
  93.   If you need assistance please call our BBS at (801)785-6286 or (801)785-6190.
  94. You may also register this product online by calling our BBS and using the PURCHASE
  95. door.
  96.                                        3
  97. DISCLAIMER
  98.  
  99.       This software is provided without any guarantee, either expressed
  100.       or implied.  All responsibilities for its use rest with the user
  101.       of the software and not the author.
  102.  
  103.       Cam-Subscription software and documents are (C) Copyright 1994-1995 by
  104.       Cam DeBuck Software.  All rights reserved World Wide.
  105.  
  106. LICENSE
  107.  
  108.       Cam-Subscription is not in the Public Domain.  Cam-Subscription is not
  109.       free.  Non-registered users are granted a limited, 30-day license to
  110.       determine whether or not the program meets their needs.
  111.       Continued use of Cam-Subscription beyond the 30-day evaluation time
  112.       period requires registration of the program.  Use of non-
  113.       registered copies of Cam-Subscription beyond the original evaluation
  114.       period is strictly prohibited.
  115.  
  116.       No one may modify Cam-Subscription for any reason, in any way, including
  117.       but not limited to decompiling-compiling, patching, disassembling, or
  118.       reverse engineering the program. Cam-Subscription may be copied and
  119.       distributed to others, subject to the above restrictions and the
  120.       following:
  121.  
  122.              * Cam-Subscription must be copied in unmodified form, including
  123.                the file containing this license information.
  124.              * Complete Cam-Subscription documentation and Online Help must be
  125.                included.
  126.              * No copying fee of any type may be assessed other than basic
  127.                charges for the cost of the copying medium.
  128.              * Cam-Subscription may not be distributed with any other software
  129.                or hardware product(s) without the express written permission
  130.                of Cam DeBuck Software.
  131.  
  132.       Sysops (bulletin board system operators) may make Cam-Subscription
  133.       available for downloading by their users as long as all above
  134.       conditions are met.
  135.  
  136.       Commercial Distributors of Public Domain, ShareWare, or User-
  137.       Supported software may distribute Cam-Subscription subject to the above
  138.       conditions only after obtaining specific written permission from
  139.       Cam DeBuck Software and filling out a registration form for
  140.       upgrade notifications.  This condition supersedes any and all
  141.       previous agreements.
  142.                                        4
  143.                                   REGISTRATION
  144.                           Cam-Subscription Door v1.00
  145.  
  146.  ****You can Register Online with a credit card as well by calling our BBS!****
  147.                     **** ALL ORDERS ARE SHIPPED OUT ***
  148.      Your registration includes one year of support on our BBS, which allows you
  149. to access any BETA files that are not available to the general public and access
  150. to all of our files/conferences on the BBS.  Once your registration has expired,
  151. you have the option of renewing your support for another year (Renewal is $10.00
  152. for one year).
  153.  
  154. All information must be PRINTED CLEARLY, EXACTLY the way you want it to show up.
  155.  
  156. Sysop Name:___________________________________________
  157.   BBS Name:___________________________________________
  158.  BBS Phone:___________________________________________
  159. Home Phone:___________________________________________(For my Use Only)
  160. Work Phone:___________________________________________(For my Use Only)
  161.  
  162. Registration is welcomed by Check, Money Order, Credit Card or Online Check.
  163.  
  164. Please Check One
  165. [ ] Enclosed is $44.00 for the Registered Version (5 1/4" Diskette)
  166. [ ] Enclosed is $44.00 for the Registered Version (3 1/2" Diskette)
  167.  
  168. Please Check One
  169. [ ] Check/Money Order    [ ] Visa    [ ] MasterCard    [ ] Diners Club
  170. [ ] Carte Blanche        [ ] JCB
  171. [ ] Online Check 
  172.  
  173.   If using a Credit Card, please fill out the credit card information.
  174.  
  175. Card Number:__________________________________Expiration Date:_________________
  176.  
  177. Card Holder's Signature REQUIRED:______________________________________________
  178.  
  179.   If using a Online Check, please fill out the Check Information and then upload
  180. the two pages of registration information to our BBS for processing (be sure to
  181. leave us a message stating you uploaded this file).
  182.  
  183. Name(s) on Check    :__________________________________________________________
  184. Address, City, State:__________________________________________________________
  185. Phone               :__________________________________________________________
  186.  
  187. Check Number:____________
  188.  
  189. Routing Number:________________  Account Number:_______________________________
  190.  
  191.  
  192. Include one of the following:
  193. Drivers License(Please Include State then Number):_____________________________
  194. Social Security Number                           :_____________________________
  195.                                        5
  196. Registration Information Continued
  197.  
  198. Shipping Address:______________________________________________________________
  199.  
  200. _______________________________________________________________________________
  201.  
  202. _______________________________________________________________________________
  203. All orders should be payable to:
  204.  
  205.   Cam DeBuck Software
  206.   P.O. Box 19
  207.   Springville, Utah  84663
  208.   USA
  209.  
  210. *Note, all funds must be in U.S. Dollars!
  211. *DO NOT SEND CASH -- Please use a Personal Check or Money Order!
  212.                                        6
  213. Automated Transaction Services, Inc.
  214.   In order to process checks online, you will need to get setup with Automated
  215. Transaction Services, Inc.  There is a file included with this package called
  216. SYSOEB10.TXT.  Take a look at that file for more information.  You may also contact
  217. them at (805)379-9271.
  218.                                        7
  219. Installation
  220.   Simply run the INSTALL program.  It will then ask you some questions and install
  221. the door for you.  It doesn't get any easier than that.
  222.  
  223.  
  224. Configuration
  225.                                    SUBCFG.EXE
  226.   Before you can use the door you must use the SUBCFG.EXE program to configure the
  227. door.  The main menu of this program looks like this:
  228.  
  229. ░░░░░░░░░░░░░░░░░┌────────────────────────────────────────────┐░░░░░░░░░░░░░░░░
  230. ░░░░░░░░░░░░░░░░░│ Cam's Subscription Door Setup Utility v1.0 │░░░░░░░░░░░░░░░░
  231. ░░░░░░░░░░░░░░░░░└────────────────────────────────────────────┘░░░░░░░░░░░░░░░░
  232. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  233. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  234. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  235. ░░░░░░░░╔══════════════════════════════════════════════════════════════╗░░░░░░░
  236. ░░░░░░░░║                      Configuration Menu                      ║░░░░░░░
  237. ░░░░░░░░╟──────────────────────────────────────────────────────────────╢░░░░░░░
  238. ░░░░░░░░║                                                              ║░░░░░░░
  239. ░░░░░░░░║               A - Registration Information                   ║░░░░░░░
  240. ░░░░░░░░║               B - General Door Information                   ║░░░░░░░
  241. ░░░░░░░░║               C - Subscription Information                   ║░░░░░░░
  242. ░░░░░░░░║               D - Paths and Filenames                        ║░░░░░░░
  243. ░░░░░░░░║               E - Protocol Information                       ║░░░░░░░
  244. ░░░░░░░░║               F - Credit Card Information                    ║░░░░░░░
  245. ░░░░░░░░║               G - Online Check Information                   ║░░░░░░░
  246. ░░░░░░░░║               H - Communication Information                  ║░░░░░░░
  247. ░░░░░░░░║     Enter your Registered Information to Register Cam-Sub    ║░░░░░░░
  248. ░░░░░░░░╚══════════════════════════════════════ [F1]=Help  [ESC]=Quit ═╝░░░░░░░
  249. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  250. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  251.  
  252.   What you will want to do is go into *all* of the different options.  
  253.   If you ever have a question about an option, simply press the F1 key
  254.   and it will bring up a help menu.
  255.  
  256.   Basically you can go through the entire SUBCFG.EXE program using the F1 key
  257.   for an explaining without having to use the documentation.  Everything is
  258.   straight forward.  However, we will try to give a little more information
  259.   in the documentation when necessary.
  260.                                        8
  261.   A - Registration Information
  262.  
  263.   ┌───────────────────────[ Registration Information ]───────────────────────┐
  264.   │                                                                          │
  265.   │ Sysop's Name :                                                           │
  266.   │ BBS Name     :                                                           │
  267.   │ Serial Number: 00000000                                                  │
  268.   └──────────────────────────────────── [F1]=Help ─ [F10]=Save ─ [ESC]=Quit ─┘
  269.  
  270.   Fill out the Sysop's Name and the BBS Name.  In order to fill in the Serial
  271.   number you will need to register the software.  You will then be given your
  272.   serial number to remove the "Unregistered" info.
  273.  
  274.  
  275.   B - General Door Information
  276.  
  277.   You will have the following information to fill out:
  278.  
  279. Location of BBS
  280.       This is the location of the BBS and will ask the user if they are a
  281.       resident of this area.  It's used for TAXABLE information.  In most
  282.       cases you will want to put the STATE that the BBS is located.
  283.  
  284. Accept Subscriptions
  285.       If you wish to accept subscriptions answer yes to this question.  You
  286.       will need to make sure you answer Yes to either this option or the
  287.       Donation option.  If you answer No to both questions, then the door
  288.       isn't going to do anything for you.
  289.  
  290. Accept Donations
  291.       If you would like to be able to accept donations from your users,
  292.       set this field to Yes if not, set the field to No.  You will need to
  293.       make sure you answer Yes to either this option or the Subscription
  294.       option.  If you answer No to both questions, then the door isn't going
  295.       to do anything for you.
  296.  
  297. Minimum Donation to Accept
  298.       Enter the minimum amount of money to accept for a donation.  The user can
  299.       give a higher amount, just not lower.  This field is used to prevent
  300.       users from donating amounts of $1, $3, etc.
  301.  
  302. Echo Dots for Card Number
  303.       If you would like the user to see "...."'s instead of their actual credit
  304.       card number when they are entering it, set this field to "Y".  This comes
  305.       in handy if you operate your BBS in an environment where nosy over-seers
  306.       can write down a user's credit card number and use it illegally.
  307.  
  308. Write to the Caller Logs
  309.       If you set this to "Y", a line will be added to the caller log for the
  310.       node the is on, stating how much he/she charged.
  311.                                        9
  312. Write to Sysop Comment Field
  313.       If you set this to "Y", a note will be written to the user's comment
  314.       field (only shown to the sysop) showing the date and amount of the user's
  315.       subscription.
  316.  
  317. Output User Info Files
  318.       This, if set to "Y", will create two files containing the user's name in
  319.       one, and the subscription they have purchased in the other.  This is
  320.       useful for importing the text file into a message to the sysop.  You
  321.       need a program, such as TXT2MSG.EXE, to do this.
  322.  
  323.       The files created are:
  324.  
  325.         USERxxxx.NAM - the user's name.
  326.         USERxxxx.INF - the user's subscription information as a text file.
  327.  
  328.         The xxxx represent the node number the user was on to purchase the
  329.         subscription.
  330.  
  331. Minimum Level for Subscribers
  332.       This is the lowest security level you offer to your users as being a
  333.       Subscriber level.  Here's an example:
  334.  
  335.         Levels 0,10,20,30,40,50,60,70,80,90,100,110 are your security levels
  336.         on your BBS.
  337.  
  338.         Level 20,30,40,50 are levels of users allowed in CAM-SUB, but are NOT
  339.         subscribers.
  340.  
  341.         Level 60,70,80,90 are subscriber levels.
  342.  
  343.         For Minimum Subscriber Level you would thus put "60".
  344.  
  345. Orders File Type to Output
  346.       Enter a number, from 1 - 3 for the type of orders record file to write
  347.       to.
  348.  
  349.         1 = Random Access Database Transaction File
  350.         2 = ASCII Text File
  351.         3 = Output BOTH Types of Orders Files
  352.  
  353. Sort the Subscription Options
  354.       Answering YES to this question will sort the subscription options in
  355.       ascending order, using the cost for the sort criteria (sorts by cost
  356.       field).  The highest cost will be first, the lowest cost will be last.
  357.  
  358. Subscription Tax Rate
  359.       If your state/providence needs to charge for tax on Subscriptions, then enter
  360.       the amount that needs to be charged.
  361.  
  362.       Please note that in some States in the US that you must charge tax for
  363.       subscriptions.  I know that Utah is one of them.  Please contact your
  364.       State Tax Commission to find out.
  365.                                        10
  366.   C - Subscription Information
  367.  
  368.     You can define up to 50 different types of subscriptions.  The following
  369.     information must be filled out for each different subscription that is
  370.     available on your BBS:
  371.  
  372. Description
  373.         You are given 49 characters in which you need to describe the
  374.         subscription option as best you can.  You must do this with every one
  375.         of the options you plan to have.  Try to tell the user what level,
  376.         how much time, how many bytes, etc. he/she will receive if they
  377.         choose this level.
  378.  
  379. Cost
  380.         This is how much the user will pay in order to receive this
  381.         subscription option.  Make sure you enter a price for every available
  382.         subscription option;  the door stops reading in the options you have
  383.         entered when it comes upon a zero dollar field for the cost.
  384.  
  385. Security Level
  386.         This is the security level the user will be upgraded to if he/she
  387.         purchases this option and you have the Update Security Level set to
  388.         Yes.
  389.  
  390. Update Security Level
  391.         If you want the door to upgrade the user's security level, set this to
  392.         Yes;  if set to No, there will be nothing done to the user's security
  393.         level, regardless of what you entered in the last field.
  394.  
  395. Expired Security Level
  396.         Same as "Security Level," only this applies to the user's expired
  397.         security level.  This is the level that PCBoard (C) gives to the user
  398.         once he/she expires.
  399.  
  400. Update Expired Security Level
  401.         Same as "Update Security Level," only this applies to the user's
  402.         expired security level.
  403.  
  404. Days to Add to Expiration
  405.         This is the amount of time a user will receive this security level
  406.         for, in one day increments (31 = 1 month.)  When the user chooses this
  407.         level, he/she gets this many days either added to today's date (if
  408.         they were a non-subscriber, or had no time left on their expiration
  409.         left), or appended to their expiration date (if they still had some
  410.         time remaining before expiration - If they had the same security level
  411.         before (*) see note.)  If you would like to have "Lifetime"
  412.         subscriptions, you may set this field to "0", thus setting the user's
  413.         expiration date to "000000", for a lifetime subscription (The 'Update
  414.         Expiration Date' field must also be set to "Y" for this to work.)
  415.  
  416.         * If the user re-subscribes when he/she still has time left before
  417.           expiration, they will be told that the time left can be credited to
  418.           the price of the new subscription (minus the amount of used days),
  419.           or the user can settle for subscribing to the same security level
  420.           again, or they can wait until they totally expire before
  421.           re-subscribing.
  422.                                        11
  423.  
  424. Update Expiration Date
  425.         If you wish the door to update the user's expired security level, set
  426.         this option to Yes.
  427.  
  428. Clear UL/DL Counts
  429.         If this field if set to Yes, upon completing the charge, and the user
  430.         purchasing this option, his/her byte and file ratios are cleared -
  431.         ACCORDING TO RATIO.  If the user has 2 uploads, 2 downloads, and the
  432.         ratio is 2:1, then the user's record is adjusted to:
  433.  
  434.           1 upload, 0 downloads.
  435.  
  436.         If the user has 1 upload, 4 downloads, 2:1 ratio, the record is
  437.         adjusted to:
  438.  
  439.           0 uploads, 0 downloads.
  440.  
  441.         (Applies to bytes as well)
  442.  
  443.         This will keep the users happy by not erasing any file/byte credits
  444.         the user has earned.
  445.  
  446. Amount of Files to Credit
  447.         If you wish to give the user a certain number of files for purchasing
  448.         this subscription option, enter the amount here.
  449.  
  450. Amount of Bytes to Credit
  451.         If you wish to give the user a certain number of bytes for purchasing
  452.         this subscription option, enter the amount here.
  453.  
  454.         For BYTES, 1 = 1 Megabyte (1,048,576 bytes.)
  455.  
  456. Credits
  457.         Enter the amount of Credits that should be given to a user upon
  458.         purchasing this option.
  459.  
  460.         Please note that this option only works with PCBoard 15.2+ and *ONLY*
  461.         if you have the PCBoard Accounting PSA installed via PCBSM.EXE.
  462.  
  463. Conferences
  464.         Enter the conference numbers the user should be registered in upon
  465.         purchasing this option.  Use commas (",") to separate; a dash ("-")
  466.         can be used to define ranges (Ex: "0,1-5,7", etc.)
  467.                                        12
  468.   D - Paths and Filenames
  469.  
  470.     In this area I *HIGHLY* suggest that you leave everything as the defaults
  471.     except for the Path/Name of your PCBOARD.DAT.  Be sure you give the path
  472.     and filename of this file.
  473.  
  474.     If you run a multi-node system have no fears.  The path/name of the
  475.     PCBOARD.DAT is only used to find where the location of your USERS file
  476.     are for the SUBMGR.EXE program.  Your USERS file is *always* located in
  477.     the same directory for all of your nodes (at least I hope it is).
  478.  
  479.     You will also want to modify the following DEFAULT filename files to fit
  480.     your BBS needs:
  481.  
  482.        MENU - This file contains the door's main menu.  Customize it, and remove
  483.               all of the commands that do not apply.  For example remove the
  484.               (D)onation command if you are not using donation mode.
  485.  
  486.        SUBHELP - This file contains help for the various main menu functions
  487.                  of the door.
  488.  
  489.        WELCOME - This file is displayed to the users right after the door has
  490.                  been opened.
  491.  
  492.        SUBLIST - This file contains a detailed list of each subscription
  493.                  option. Here is where you tell the users as much as possible
  494.                  about each subscription option you have.
  495.  
  496.        WARN - This file should be a very impressive display of "It is a
  497.               FEDERAL offense to use a stolen credit card, and we turn in all
  498.               attempts to the proper law authorities."
  499.  
  500.        NOTICE - This file is shown to the user right before he/she begins
  501.                 entering the credit card and personal information.  You should
  502.                 tell the user how much is going to be charged, what is going to
  503.                 be charged, etc. here.  All valid CAM-SUB text file macros
  504.                 apply to this file (see later in documentation for macros).
  505.  
  506.        RECEIPT - This is the receipt of the user's actions in the door.  The
  507.                  user can preview this file before he/she makes the actual
  508.                  charge.  This file is shown to the user when he/she makes
  509.                  their charge (before and after.)  The user is also allowed to
  510.                  download this file after the charge goes through.  The
  511.                  invoice number is set to "PREVIEW" until the charge is
  512.                  complete, then the actual number is inserted.  You also have
  513.                  full use of all CAM-SUB macros here too.
  514.  
  515.        CLOSE - This is the file shown to ALL users of the door when they exit
  516.                back to the BBS.
  517.  
  518.        THANKS - This is a kind of Thank You file to be shown to the user upon
  519.                 making a charge and exiting the door.  You have full support
  520.                 of all the CAM-SUB macros.
  521.                                        13
  522.   E - Protocol Information
  523.  
  524.     If a user wants to download their invoice, this is where they will be
  525.     shown what protocols are available.  You can have a total of 10 protocols
  526.     that are available.  In most cases using the default Zmodem Protocol
  527.     will be all that is necessary.
  528.  
  529.     Here is what this screen looks like:
  530.  
  531.     ┌────────────────────────[ Protocol Information ]────────────────────────┐
  532.     │                                                                        │
  533.     │ LTR ERR    Protocol Name              Protocol Command Line            │
  534.     │                                                                        │
  535.     │  Z   N  Zmodem               C:\PCB\ZMSEND.EXE %DFN%                   │
  536.     │                                                                        │
  537.     └────────────────────────────────── [F1]=Help ─ [F10]=Save ─ [ESC]=Quit ─┘
  538.  
  539.     LTR is the Protocol Letter that the user will select in order to download
  540.     the invoice.
  541.  
  542.     ERR is whether or not this protocol is for ERROR CORRECTING MODEMS.  The
  543.     only protocols that I am aware of that are ECM type modems are Ymodem-G
  544.     and Xmodem-G.
  545.  
  546.     Protocol Name is where you give a description of this protocol.  This
  547.     will be displayed to the user when downloading an Invoice.
  548.  
  549.     Protocol Command Line is where you define the actual path/filename of the
  550.     program.  You can use the following Macros to be passed to the program:
  551.  
  552.       %DFN%  - The filename of the invoice.  Does *not* include the PATH
  553.                since it will always be created in the current directory of
  554.                where the program is running.
  555.  
  556.       %BAUD% - The baud rate of the caller.
  557.  
  558.       %IRQ%  - The IRQ that the comport is on.
  559.  
  560.       %BASE% - The Base Address that the comport is on.
  561.  
  562.   F - Credit Card Information
  563.  
  564.     If you have a Credit Card Merchant Account (like with Telefloral) then be
  565.     sure you define what credit cards you can take.
  566.  
  567.     The door can also verify credit cards online fi you have the TELEPC-B.EXE
  568.     (which is available through Telefloral).  All you have to do is make sure
  569.     you enable the "Verify Credit Cards Online" to Yes.  You will need a spare
  570.     modem and phone for this option to work.
  571.  
  572.     If you do have an account with Telefloral and have their TELEPC-B.EXE
  573.     program, you can make things even easier for yourself since you can have
  574.     the software to run the TELEPC-B program with a touch of a button.  Simply
  575.     use the SUBMGR.EXE program and use the F9 key to process a credit card
  576.     order.
  577.                                        14
  578.   G - Online Check Information
  579.  
  580.     If you wish to accept Checks Online, then be sure to set the Accepts
  581.     Checks Online to Yes.
  582.  
  583.     The screen looks like this:
  584.  
  585.     ┌──────────────────────────[ Check Information ]─────────────────────────┐
  586.     │                                                                        │
  587.     ├────────────────────────────────────────────────────────────────────────┤
  588.     │ Accept Checks Online:  Y                                               │
  589.     ├────────────────────────────────────────────────────────────────────────┤
  590.     │ Merchant ID          : MYID                                            │
  591.     │ Check Memo           : Subscription to CamSoft                         │
  592.     │ Check Verification   : N                                               │
  593.     │ Check Guarantee      : N                                               │
  594.     │ Check Entered By     : ABC                                             │
  595.     │ Production Account (EFT): N                                            │
  596.     └────────────────────────────────── [F1]=Help ─ [F10]=Save ─ [ESC]=Quit ─┘
  597.  
  598.     In order to do this you will need to setup an account with Automated
  599.     Transaction Services, Inc.  Once you have been setup with them you will
  600.     need to add your Merchant ID in this area.
  601.  
  602.     There are also two other optional services that are provided by Automated
  603.     Transaction Services, Inc.  They are Check Verification and Check
  604.     Guarantee.
  605.  
  606.     Check Verification will verify the account of the check before
  607.     processing.
  608.  
  609.     Check Guarantee will insure the check for Non Sufficient Funds charges.
  610.  
  611.     The other options (Check Memo and Entered By) should be filled out by
  612.     you.
  613.  
  614.     Check Memo should contain something that describes what the user has just
  615.     purchased, or perhaps the name of your BBS.  Basically the users check
  616.     will contain whatever information you put on here.
  617.  
  618.     Check Entered By should contain your initials or the initials of the
  619.     Sysop running the BBS.
  620.  
  621.     Production Account (EFT) is another option that should only be set to Yes
  622.     if you have enabled this with ATS.  This is for paperless transactions.
  623.  
  624.                                        15
  625.   H - Communication Information
  626.  
  627.     This is where you define your communication information for your online
  628.     check transactions.  If you are not using the online check option, then
  629.     you do not need to fill this information out.  The screen looks like this:
  630.  
  631.     ┌────────────────────[ Communication Information ]──────────────────────┐
  632.     │                                                                       │
  633.     │ User Name         : JOHN DOE                                          │
  634.     │ User Password     : PASSWORD                                          │
  635.     │ Maximum Baud Rate : 57600                                             │
  636.     │ Comport #         : 1                                                 │
  637.     │ Irq Number        : 4                                                 │
  638.     │ Base Address      : 3F8                                               │
  639.     └───────────────────────────────── [F1]=Help ─ [F10]=Save ─ [ESC]=Quit ─┘
  640.  
  641.     Once you have been approved by Automated Transaction Services, Inc., they
  642.     will provide you with an account on their BBS.  You will need to fill in the
  643.     User Name and User Password with the same information they provide you.
  644.  
  645.     Also, be sure you are in EXPERT Mode so the SENDDBF.EXE program will run
  646.     smoothly and use as less time calling long distance as possible (every
  647.     minute adds up).
  648.  
  649.     You will also need to make sure that your Protocol is set to Zmodem on
  650.     their BBS as the SENDDBF.EXE program uses Zmodem to transfer the
  651.     transaction files.
  652.  
  653.     You will also need to define the maximum baud rate your modem supports
  654.     and what comport the modem is on.  If your comport is above 2, you will
  655.     need to define the IRQ and BASE Address.  COM1 and COM2 will
  656.     automatically be replaced with their appropriate values.
  657.  
  658.     Please be aware that the SENDDBF.EXE program will not work if you are
  659.     using FOSSIL.  A FOSSIL driver can exist, but the program uses direct
  660.     access to the comport (ASYNC) for operation.
  661.  
  662.                                    SUBTXT.EXE
  663.   Before you can use the door you must use the SUBTXT.EXE program to
  664.   create the SUBTEXT Prompt file.
  665.  
  666.   Upon running the program you will be prompted for the SUBTEXT Path/Filename.
  667.   Simply use SUBTEXT.  If you would like to create different SUBTEXT language
  668.   files (as defined in PCBSetup for your languages), then you can create
  669.   other SUBTEXT.lng files (where lng is replaced with the appropriate
  670.   extension).
  671.  
  672.   The SUBTXT.EXE program allows you to modify any of the prompts that are
  673.   displayed to the user to fit your own needs or taste.
  674.                                        16
  675.                                    CAM-SUB.EXE
  676.   The operation of the CAM-SUB is fairly simple.  Simply run CAM-SUB in your
  677.   door batch file (which is created by the INSTALL program).  That's it.
  678.  
  679.   However, there are two optional command line options that you can use.
  680.  
  681.     /C:filename  - replace filename with a different configuration file.
  682.     /LETTERS     - Replaces the subscription numbers with letters.  Simply
  683.                    a matter of preference.  However, if you do use this
  684.                    option you can only have a total of 26 subscriptions since
  685.                    there are only 26 letters in the alphabet.
  686.  
  687.   In order for the door to run properly you need to make sure the USER SYS
  688.   option in your DOORS.LST is set to Yes.  The requires that this file is
  689.   available so any changes to the users record can be made while the user
  690.   is online.
  691.  
  692.   One piece of information that might interest you.  When a user selects a
  693.   subscription option, they will be displayed a file that gives the full details
  694.   of the subscription.  In order for this to work you will need to create file(s)
  695.   called SUBDx (where x is the subscription number).  This is not required and is
  696.   simply for informational purposes only for the user.
  697.  
  698.                                        17
  699. Event Operation (Online Checks)
  700.  
  701.   If you are using the Online Check Option and have your Merchant ID with
  702.   Automated Transaction Services, Inc., you will need to use the SENDDBF.EXE
  703.   program.
  704.  
  705.   Simply have your event look like this:
  706.  
  707.   CD \CAM-SUB
  708.   SENDDBF.EXE
  709.  
  710.   That's it.  The software will do everything automatically for you.  You
  711.   should ALWAYS use this program for proper operation of the door and the
  712.   .DBF files.
  713.  
  714.   Please be aware that the SENDDBF.EXE program will only work if you have
  715.   registered this software.
  716.  
  717.   Also, PKZIP.EXE must be in your PATH since it will be called to ZIP up
  718.   the .DBF file(s) for processing.
  719.  
  720.  
  721. Event Operation (Credit Cards)
  722.  
  723.   There isn't a way to do credit cards in an event.  You will manually need
  724.   to use the DCCDMGR.EXE program.  Go to the user that you need to
  725.   process a credit card for and press the F9 key.  The F9 key will only
  726.   work if you are using Telefloral as your Credit Card Merchant and you have
  727.   the TELEPC-B.EXE software.
  728.                                        18
  729. Maintenance
  730.  
  731.   For the most part there isn't much maintenance that needs to be done.
  732.   Probably about the only maintenance that you might want to do is print out
  733.   an invoice.  The Invoice is printed out based upon the RECEIPT file that
  734.   you have modified.  Be sure you modify this file to fit your needs.
  735.  
  736.   However, printing an invoice isn't necessary if you leave the invoice online
  737.   for the user to read in a message if you use a program like TXT2MSG.EXE in
  738.   the Door Batch file and have the "Output User Info Files" set to Yes in the
  739.   SUBCFG.EXE program.  You could then have our Door Batch file look something like
  740.   this:
  741.            CD \CAM-SUB
  742.            CAM-SUB.EXE
  743.            if exist USER%PCBNODE%.INF  then  TXT2MSG.EXE commandline options..
  744.  
  745.   If you need to print an invoice, use the SUBMGR.EXE program.  Go to the
  746.   user you need to print use the ALT-P command.  The program will print
  747.   to LPT1 (PRN).
  748.                                    SUBMGR.EXE
  749.     You can use the SUBMGR.EXE program to modify or add a user.  It will also
  750.     let you know how many subscribers you have to your BBS.
  751.  
  752.                                  CAM-SUB MACROS
  753.   Here is a list of the macros that are supported by the software.
  754.  
  755.       @CAMINVOICE@      - Invoice Number
  756.       @CAMSUBTOTAL@     - Subtotal Cost (includes Sub. Cost and Donation)
  757.       @CAMTOTAL@        - Total Cost (Subtotal * Tax Rate)
  758.       @CAMUSERNAME@     - Users Name
  759.       @CAMCARD@         - Credit Card Number
  760.       @CAMTIME@         - Current Time
  761.       @CAMDATE@         - Current Date
  762.       @CAMCOMMA@        - Comma (Only works if City field isn't blank)
  763.       @CAMEXPIRATION@   - Credit Card Expiration Date
  764.       @CAMCARDNAME@     - Credit Card Holder Name
  765.       @CAMCARDTYPE@     - Credit Card Type (Visa, Master, etc)
  766.       @CAMADDRESS1@     - Address Line 1
  767.       @CAMADDRESS2@     - Address Line 2
  768.       @CAMCITY@         - City of User
  769.       @CAMSTATE@        - State of User
  770.       @CAMZIP@          - ZipCode of User
  771.       @CAMCOUNTRY@      - Country of User
  772.       @CAMPROCESSOR@    - Billing party's name
  773.       @CAMDAYPHONE@     - Users Day Phone
  774.       @CAMEVENINGPHONE@ - Users Evening Phone
  775.       @CAMBESTTIME@     - Best time to call user
  776.       @CAMBIRTH@        - Users Birth Date
  777.       @CAMSUBS@         - Description of Subscription user purchased
  778.       @CAMSUBSCOST@     - Cost of Subscription
  779.       @CAMDONATION@     - Donation Amount by user
  780.       @CAMTAX@          - Is the user Taxable (Y/N)
  781.       @CAMSUBTAXRATE@   - Subscription Tax Rate
  782.       @POS:xx@          - Remove anything past xx (use for formatting)
  783.  
  784.                                        19
  785.