home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / bbs_mail / acc_0110.arj / ENGLISH.DOC < prev    next >
Text File  |  1991-12-08  |  17KB  |  539 lines
  1.                               ACCOUNT V1.02
  2.                               -------------
  3.  
  4.  
  5.  
  6. This program was designed to let sysops keep User/Point payments
  7. in order.
  8.  
  9.  
  10.                        Consideration to registration
  11.                        -----------------------------
  12.  
  13.  
  14. Note, this program is not public domain or freeware !
  15.  
  16. This program is shareware. You are granted a license to try ACCOUNT
  17. for a trial period of 30 days without risk. If, after this time, you
  18. find the program useful and intend to use it to manage your user-
  19. accounts, you are expected to register.
  20.  
  21. To register ACCOUNT please transfer DM 20.-- to
  22.  
  23.             Harald Lichtblau
  24.             Kreissparkasse Hannover (Germany)
  25.             BLZ    :250 502 99
  26.             Account:2108378072
  27.  
  28. Please write your full name, home address, FidoNet Address
  29. and the program name in the notes for the receiver at the transfer
  30. form.
  31.  
  32. If I get the registration order, I will send you a registration number
  33. crashmail, if your system supports CM. After receiving your registration
  34. number press <R> in the startup window and enter your personal
  35. registration number.
  36.  
  37. If you not reachable via crashmail, tell me via netmail or in a letter, how
  38. I can send your personal registration number to you.
  39.  
  40. My address is: Harald Lichtblau
  41.                Germany
  42.                Langestrasse 1
  43.                3008 Garbsen 4
  44.                Fido-Net 2:240/1.3
  45.  
  46. If I write a new version of ACCOUNT, (I suppose I will do so) you do NOT
  47. need to reregister your current version.
  48.  
  49. The registration number will keep all further versions of ACCOUNT running.
  50. Please write your registration information down on a piece of paper and
  51. store it in a safe place to avoid trouble.
  52.  
  53.  
  54.  
  55.                               Selling ACCOUNT 
  56.                               ---------------
  57.  
  58.  
  59. 1. I do NOT allow the selling of ACCOUNT via PD/Shareware marketing companies.
  60.    If you want to, you need my written permission.
  61.  
  62. 2. I do not mind if you put the software in your BBS to let other users 
  63.    make a download of it. 
  64.  
  65. 3. You can also put the software in Shareware-packets (e.g. Mailbox-software)
  66.    without my explicit permission. However you are not allowed to put it
  67.    in, if you sell the packets via a PD/Shareware marketing company. (see #1)
  68.  
  69.  
  70. The things I mentioned in #2 and #3 are only important if we talk about
  71. the complete archive containing the following files :
  72.                                                      
  73. ACCOUNT .EXE The executable program.
  74.              (Default is english language, see end of this doc)
  75. BATCH   .BAT Batchfile to envoke aditional actions, after creating of
  76.              remindments.
  77. ENGLISH .ARJ This sub-archive containing the english text and *.DAT files.
  78. ENGLISH .DOC The english doc. file. (This file)
  79. GEMAN   .ARJ This sub-archive containing the german text and *.DAT files.
  80. GERMAN  .DOC The german doc. file.
  81.  
  82.  
  83. The ENGLISH.ARJ and GERMAN.ARJ archives contain the folowing files in the
  84. english and the german language.
  85.  
  86. !NEWS!  .TXT Bugfixes from V1.0 to V1.05
  87. BEZAHLT .DAT Example text for an acknowledgment to generate.
  88. DAT     .DOC The short doc. file for *.DAT files.
  89. TEXT-1  .DAT Example text for the 1. remindment to generate.
  90. TEXT-2  .DAT    "      "   "   "  2.     "       "     "
  91. TEXT-3  .DAT    "      "   "   "  3.     "       "     "
  92. TEXT-4  .DAT    "      "   "   "  4.     "       "     "
  93.  
  94.  
  95. In addition to that, the archive can contain a banner file of the
  96. bbs you made the download from.
  97.  
  98.  
  99.  
  100.  
  101.  
  102.                               Guarantee
  103.                               ---------
  104.  
  105.  
  106. I tested this software for quite a long time and it worked well. I am
  107. not responsible for any damage to your hardware, software, psyche or
  108. anything else. That's your own problem !
  109.  
  110. You are using this software at your OWN risk !
  111.  
  112. If you use this software you automatically agree to these terms.
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.                             A word from the author
  121.                             ----------------------
  122.  
  123.  
  124. ACCOUNT is a software to manage the sysop's users and points accounts.
  125.  
  126. If this program detects a payment or the necessity to pay, it will automatically
  127. write reminder messages or receipt messages and put it in your Fido style
  128. (*.MSG) netmail folder.
  129.  
  130. This should happen in the mailer's netmail directory.
  131.  
  132. I have tested this software succesfully with the following:
  133. D'Bridge 1.30 and MBUTIL
  134. Frontdoor 1.99 (2.0) and TosScan.
  135.  
  136. I don't know if the ACCOUNT will work with any other systems using a different
  137. mailer or tosser.
  138.  
  139. ACCOUNT creates messages automatically, so you don't need additional
  140. software like Ghostwriter.
  141.  
  142. The only thing you need is ACCOUNT itself (:-)), a Fido-Style (*.MSG) 
  143. netmail-folder and a FIDO compatible mailer. 
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.                              Introduction
  155.                              ------------
  156.  
  157.  
  158. To make the installation of ACCOUNT as easy as possible, create a
  159. directory for ACCOUNT and its help-files. Then copy the  first 5 listed files
  160. to that directory and extract the sub-archive with the next 7 files in your
  161. language.
  162.  
  163. It is not necessary to jump to that directory before starting ACCOUNT,
  164. ACCOUNT does that automatically and returns to the original-directory
  165. after program-termination.
  166.  
  167. When fireing up ACCOUNT the software tests to see if a database and a
  168. config file exists (ACCOUNT.DBF and ACCOUNT.CFG).
  169.  
  170. If the files do NOT exist, the software assumes a first time installation and
  171. runs its build in installation routines.
  172.  
  173. It is not possible to terminate the install routine via <ESC>, it must be
  174. completed.
  175.  
  176. Next, the DBase compatible Database, named ACCOUNT.DBF and the Index-file
  177. (ACCOUNT.NTX) are created.
  178.  
  179. ACCOUNT.NTX is not DBase compatible !
  180.  
  181.  
  182. ATTENTION !
  183.  
  184. After registering ACCOUNT it is no longer possible to modify the first and
  185. last name of the sysop.
  186.  
  187. If you modify the name info. in any way, the program will NO longer run.
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.                               Configuration
  198.                               -------------
  199.  
  200.  
  201. ╔════════════════════════ Mailer Configuration ═════════════════════╗
  202. ║                                                                   ║
  203. ║                SysOp:           Co-SysOp 1:       Co-SysOp 2:     ║
  204. ║ First name...? Harald           Robo                              ║
  205. ║ Second name..? Lichtblau        Cop                               ║
  206. ║ Fido-address.? 2:240/1.3        2:240/1.3                         ║
  207. ║                                                                   ║
  208. ║ Path to the netmail directory (*.MSG)....: D:\DB\MESSAGES\NETMAIL ║
  209. ║ Path to the netmail rescan signal-file...: D:\DB\DBRIDGE.RSN      ║
  210. ║ Path to the netmail waiting signal-file..: D:\DB\DBRIDGE.NMW      ║
  211. ║                                                                   ║
  212. ║ * Origin: See you later ...                        (2:240/1.3)    ║
  213. ║ Subject.: Your account                                            ║
  214. ║                                                                   ║
  215. ╚═══════════════════════════════════════════════════════════════════╝
  216.  
  217. At first, please enter your full name and you Fido Net Address.
  218.  
  219. The entrys for Co-SysOp 1: and 2: are only needed if you wish to farward the
  220. last two remindments to other peoples as you too.
  221.  
  222. Then you need to define some mailer specific parameters.
  223.  
  224. 1. The full path name including drive to your Netmail-directory. Do not use
  225.    the final-backslash.
  226.  
  227. The following files will be analysed by account but ACCOUNT writes the
  228. files when sending a reminder or a receipt message.
  229.  
  230. 2. The full path name including the drive to the file the mailer uses to decide
  231.    running a netmail-rescan or not.
  232.  
  233. 3. The full path name including the drive to the file the mailer uses, to
  234.    detect unread mail and display it in the status line ("Netmail waiting").
  235.  
  236.  
  237. The mailer should not require information in files 2. and 3. If one or both
  238. of the fields are empty, ACCOUNT will run despite of that, but none of the
  239. files will be created after a netmail was written.
  240.  
  241.  
  242. After you have finished this part of the configuration, the Fido-Net address
  243. will be displayed behind your origin-line and you can now enter your personal
  244. origin.
  245.  
  246.  
  247. The text width for your origin is 79 characters.
  248.  
  249. All space-characters (ASCII 20) in front or behind the text will be deleted.
  250.  
  251. You can use the origin by inserting a "%0" at the end of the *.DAT files.
  252. The "%0" will be replaced by the origin.
  253.  
  254. In the subject field you can enter the text, which should appear in the
  255. subject of the reminder/receipt msg.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263. ╔══════════════════════ Remindments Configuration ══════════════════════╗
  264. ║                                                                       ║
  265. ║ Path to the raw file for acknowledgments..? BEZAHLT.DAT               ║
  266. ║ (only send when a payment was received)                               ║
  267. ║                                                                       ║
  268. ║  Path to the raw file for 1.remindments...? TEXT-1.DAT                ║
  269. ║         send on which account(s)..........? 14                        ║
  270. ║             Call BATCH.BAT after this.....? N (Y/N)                   ║
  271. ║  Path to the raw file for 1.remindments...? TEXT-1.DAT                ║
  272. ║         send on which account(s)..........? 7,6,5,4,3,2,1             ║
  273. ║             Call BATCH.BAT after this.....? N (Y/N)                   ║
  274. ║  Path to the raw file for 1.remindments...? TEXT-1.DAT                ║
  275. ║         send on which account(s)..........? 0                         ║
  276. ║             Call BATCH.BAT after this.....? N (Y/N)                   ║
  277. ║  Path to the raw file for 1.remindments...? TEXT-1.DAT                ║
  278. ║         send on which account(s)..........? -14                       ║
  279. ║             Call BATCH.BAT after this.....? N (Y/N)                   ║
  280. ╚═══════════════════════════════════════════════════════════════════════╝
  281.  
  282.  
  283. In this mask you must enter the Filenames of the *.DAT files.
  284.  
  285. You only need to modify these parameters if you have renamed the dat-files
  286. or if they are not in the same directory as ACCOUNT.
  287.  
  288. With the help of these files the reminder and receipt messages are created.
  289. You can modify them with a normal ASCII editor to make them fit as you
  290. desire.
  291.  
  292.  
  293. If ACCOUNT creates a reminder msg. with the help of the last couple of
  294. files, a copy of the message will be sent to the sysop.
  295.  
  296.  
  297. In addition to that, you can specify in each file, to whom the reminder
  298. msgs. will be sent to.
  299.  
  300. That means : if a user/point account matches the number in the file, a
  301. reminder message will be sent.
  302.  
  303. The information for the accounts, the reminders will be sent to, should be
  304. seperated by a "," if more than one account appear in one field.
  305.  
  306.  
  307. Do not use " " or "+". "-" is allowed.
  308.  
  309.  
  310. The first and the last should not be a "," !!!
  311.  
  312. If you enter at "Call BATCH.BAT after this......?" <Y>, ACCOUNT will call
  313. automatical a batchfile named BATCH.BAT after creating of this remindment.
  314. Diese Datei mus sich im ACCOUNT Verzeichnis oder im Suchpfad befinden.
  315.  
  316. ACCOUNT tells all known datas of the user, whow was the destination of the
  317. remindment, to this batchfile.
  318. Now, it is easy to delete this user automatical from your userlist or to
  319. delete his password.
  320. All you need for this aktion is a tool that can do the things, do you think.
  321.  
  322. Are you a programmer ? =:-)
  323.  
  324. But one thing at least, always remember, ACCOUNT call this batchfile via a
  325. DOS-Shell and rest of memory isn't big !
  326.  
  327.  
  328. If in a *.DAT file the field for the path or the account is empty, the
  329. reminder-msg will NOT be created.
  330.  
  331.  
  332.  
  333.  
  334. ╔═ Printerconection ? ═╗   Last but not least you can specify where your
  335. ║ LPT1:                ║   printer is connected.           
  336. ║ LPT2:                ║
  337. ║ COM1:                ║   If you are not an owner of a printer (you lost :-)
  338. ║ COM2:                ║   please choose file. Then the printings will
  339. ║ File: (ACCOUNT.PRN)  ║   be written to the ACCOUNT.PRN file (you find that
  340. ╚══════════════════════╝   in your account working directory)
  341.  
  342.  
  343. The configuration is now finished  :-) (easy, isn't it ?)
  344.  
  345.  
  346. If you want to modify the configuration, you can press <F10> to get to
  347. the configuration-menu.
  348.  
  349. This will only work, if you do not redirect you function key with e.g the
  350. prompt function.
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.                                Main-menu
  367.                                ---------
  368.                                
  369.  
  370. ╔════════════════════════════ Administration ═══════════════════════════╗
  371. ║                            Search for a user                          ║
  372. ║                     <Ins>  Enter a new user                           ║
  373. ║                            Edit user                                  ║
  374. ║                            Enter a received payment                   ║
  375. ║                     <Del>  Mark user for deletion                     ║
  376. ║                     <Esc>  Exit program                               ║
  377. ╚═══════════════════════════════════════════════════════════════════════╝
  378.  
  379.  
  380. Search for a user
  381. -----------------
  382.  
  383. If you choose this option, a new window appears.
  384. You have now the possibility to change the sort method. Possibles are :
  385.  
  386. Sort on names
  387. Sort on address
  388. Sort on accounts
  389.  
  390.  
  391. If you leave the window by pressing enter, the sort method will be written
  392. to disk.  
  393.  
  394. In addition to that, the selected user will be copied the administration
  395. menu.
  396.  
  397. If you leave the window by pressing <ESC>, the sort method will be restored
  398. from your selection in "search for user". The original user will also be
  399. displayed.
  400.  
  401. You can print in that window as well.
  402.  
  403. After pressing <P> for printing, the print-job will be started. 
  404.  
  405. This software prints in the same direction like on the screen, you get
  406. also the time, amount of the last payment and the date for the next
  407. rate.
  408.  
  409. If your printer is not online, a window will allow you to abort or retry.
  410.  
  411.  
  412.  
  413.  
  414.  
  415. Enter a new user
  416. ----------------
  417.  
  418. You can now enter a new user :
  419.  
  420. I think you do not need assistance to the first couple of fields :-)
  421.  
  422.  
  423. First name ...........?
  424. Last-name ............?
  425.  
  426. Address...............? The COMPLETE Fido-address of the user.
  427.                         e.g. 2:240/1.3 for points            
  428.                              2:240/1   my boss or a normal user
  429.  
  430. Costs per 30.41 Days..? How many a month for your user costs.
  431.                         (A mont have rounded 30.41 days)
  432.  
  433. Amount of money.......? How much money the user payed.
  434.  
  435. Date of receiveing....? When the money arrived at your bank account.
  436.  
  437. You can quit during your inputs by pressing <ESC>.
  438.  
  439. After completing your inputs for a new user, the software calculates the account
  440. of the user and the date of the next payment.
  441.  
  442. Now a receipt message will be printed, and your system will send the Netmail
  443. via the system mailer to the user.
  444.  
  445.                
  446. Edit user
  447. ---------
  448.  
  449. With this function you can edit all your user data execpt the automatically
  450. calculated data.
  451.  
  452. If you change the date of the next payment, the payed amount of money or the
  453. calculation-scheme, ACCOUNT calculates the date for the next payment and the
  454. actual account for the user automatically.
  455.  
  456. If a reminder msg. is already created, the internal flag will not be reseted.
  457.  
  458.  
  459.  
  460.                   
  461. Enter a received payment
  462. ------------------------
  463.  
  464. That's almost all, but there is another small feature ....
  465.  
  466. If you want to generate reminder msgs. for test purposes, you can reset the
  467. flag, that indicates that the user already received a reminder msg. and that
  468. prevents duplicate reminding, by paying 0,-- to that account.
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476. Mark user for deletion
  477. ----------------------
  478.  
  479. This is just the function to mark a user for deletion or unmark it.
  480.  
  481. If you want to kill the deleted user from the database, just call ACCOUNT
  482. with the "pack" parameter.
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489. Exit program
  490. -------------
  491.  
  492. Exit the program and turn back to dos, what else ?
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.                            Commandline parameters
  503.                            ----------------------
  504.  
  505.  
  506.    "?" = A small help, looks like this.
  507.    "E" = Switch to English language.
  508.    "D" = Switch to German language.
  509. "AUTO" = Automatical scaning of database and writing of remindments.
  510. "PACK" = Clean database from users who are marked for deletion.
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527. This program was written in november 1991 by Harald Lichtblau on (2:240/1.3).
  528.  
  529. All rights reserved.
  530.  
  531.  
  532. The English Doc. file was translated by Henning Bitsch (2:247/31)
  533. and corrected by Howard Sucher (2:247/83).
  534.  
  535. Thanks Henning and Howard. :-)
  536.  
  537.  
  538.  
  539.