home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / MISC / MCALL111.ZIP / MAILCALL.DOC < prev    next >
Text File  |  1998-07-05  |  9KB  |  200 lines
  1.     
  2.                                 MailCall v1.11
  3.                                 by Ken Reaverson
  4.                                 For TG 3.09+ 
  5.  
  6.                            BORING LEGAL SPEAK ALERT!!
  7.  
  8.                                   ────────────
  9.                                    Disclaimer
  10.                                   ────────────
  11.  
  12.   The author of MailCall is not responsible for any damaged, corrupted, lost,
  13. or otherwise harmful occurences that may occur from use (or inability thereof)
  14. of this program. It has been tested, and the author runs it on his own system.
  15. To the best of my knowledge, MailCall has no bugs and will not destroy
  16. anything on your system. However, I guarentee nothing, except that this
  17. program will take up hard drive space. If it breaks, you own both halves.
  18.  
  19.                                    ──────────
  20.                                     Warranty
  21.                                    ──────────
  22.  
  23.   No Warranty is given, either expressed or implied, as to the functionality
  24. of this software program. By using this program, you are agreeing not to
  25. hold the author, Kenneth Reaverson, responsible for any damages (consequential
  26. or incidental) that arise from your ability to use or misuse this program,
  27. that you have read this entire document, and are familiar with its terms,
  28. and agree to exempt Kenneth Reaverson from any and all responsibilities in
  29. the event of any damages to your system which are caused either through
  30. direct or indirect use of this software.
  31.  
  32.                             BORING LEGAL SPEAK DONE!
  33.  
  34.                                   ─────────────
  35.                                    Description
  36.                                   ─────────────
  37.  
  38.   MailCall is a third-party utility designed to import the last incoming
  39. call from a mailer into Telegard, which will then display it as part of the
  40. Last Callers list.
  41.  
  42.                               ─────────────────────
  43.                                System Requirements
  44.                               ─────────────────────
  45.  
  46.    MailCall [DOS] : 80286 CPU / MS-DOS v3.3 or Above
  47.    MailCall [OS2] : 80486 CPU / OS/2 Warp 3 or Above
  48.    Both versions require the following:
  49.    A working Telegard v3.09g1 (or higher) Bulletin Board
  50.    A working Front-End Mailer of a supported type. Currently, InterMail
  51.    and FrontDoor are the supported types.
  52.  
  53.    Previously, MailCall did not work with the InterMail 2.29 series. That
  54.    should no longer be the case. If you experience problems using MailCall
  55.    with InterMail 2.29, please report them ASAP.
  56.  
  57.    NOTE: To my knowledge, this program should work with FD 2.12, 2.20, and
  58.    the 2.30 series. It doesn't look like the structures changed, but this
  59.    program has only been tested with FD 2.12. If you experience any
  60.    difficulties with MailCall on any version of FD, please contact me
  61.    immedietly. The structures are slated to change with v3.00, and MailCall
  62.    will be updated when that happens.
  63.  
  64.                               ────────────────────
  65.                                Installation/Usage
  66.                               ────────────────────
  67.  
  68.    Installing MailCall is a fairly straightforward effort. The first thing
  69. to do is decide which executable you're going to use. Rename either
  70. MAILCALL.DOS or MAILCALL.OS2 to MAILCALL.EXE. If the TELEGARD environmental
  71. variable is set, you can put the executable anywhere; it'll find TG's data
  72. files all by it's lonesome. If the TELEGARD environmental variable is *not*
  73. defined, MailCall will search the current directory for CONFIG.TG. 
  74.  
  75.    The TELEGARD environmental variable is not required for MailCall to run.
  76. The IM environmental variable is (there are exceptions, see below). If you
  77. have not set this variable, add the following line to whatever batch file
  78. starts your BBS:
  79.  
  80. SET IM=<path to main IM directory>
  81.  
  82.    If you run MailCall without the IM variable defined from your main IM
  83. path, as long as the TELEGARD environmental variable is defined, it'll work.
  84.  
  85. Basically, you have to define either TELEGARD or IM. Whichever one you
  86. don't define, you must run MailCall from that ones main directory (ie,
  87. define IM, run from TG main directory. Define TELEGARD, run from IM main
  88. directory). For simplicity's sake, define *both* of the bloody variables
  89. and run MailCall from your main TG directory. :)
  90.  
  91.    MailCall will also use the TASK environmental variable, if specified.
  92. If TASK is defined, MailCall will assume that this is the same as the Node
  93. Number, and all the node fields of all entries imported in that session will
  94. take on the value of TASK. If TASK is not defined, MailCall will assume that
  95. the call came in on Node #1, regardless of which node it actually did come in
  96. on, if multinode support is turned on. If you are running a single line
  97. system, then MailCall will assume Node #0.
  98.  
  99. For FrontDoor users: Everything said above for InterMail applies to FrontDoor
  100. as well. Simply interchange the words InterMail and FrontDoor, and IM and FD.
  101. In other words, if you're using FD, set the FD variable instead of IM. :)
  102.  
  103.    MailCall is best run immedietly after an incoming mail transfer; otherwise,
  104. you might miss importing an entry.
  105.  
  106.    MailCall will accept the following on the commandline:
  107.  
  108.    <BaudRate> = The Baud Rate that you wish to show up on the last callers
  109.                 list. Unfortunetly, InterMail doesn't store the baudrate
  110.                 on incoming calls, so this has to be faked. This must be
  111.                 the first parameter on the commandline, and it is required
  112.                 for regular use.
  113.  
  114.  <MailerType> = This defines which Mailer's data files MailCall will look
  115.                 for. There are currently two valid types: /IM for InterMail
  116.                 and /FD for FrontDoor. This must be the second parameter on
  117.                 the commandline, and it is required for regular use.
  118.  
  119.                 Example: MAILCALL 21600 /IM
  120.  
  121.     The following two options are for infomational purposes. If they're used,
  122.     MailCall won't actually import a call.
  123.  
  124.            /? = A small help screen
  125.  
  126.            /V = Miscellanous Information on this version of MailCall
  127.  
  128.                 Example: MAILCALL /?
  129.                             or
  130.                          MAILCALL /V
  131.  
  132.                                  ──────────────
  133.                                   Registration
  134.                                  ──────────────
  135.  
  136.    Yeah, right. :) Registration? For something like this? Oh blah. Too
  137. many programmers want 5 or 10 bucks for a couple hours of work on something
  138. they probably coded because they needed themselves in the first place. The
  139. learning experience is the true reward for me, and I could not in good
  140. conscience accept money for anything as simple as this program.
  141.  
  142.                                  ──────────────
  143.                                   Distribution
  144.                                  ──────────────
  145.  
  146.    MailCall may be freely distributed in it's unmodified format. See
  147. PACKING.LST for a list of contents that should be included in the archive.
  148. The archive's original format is ZIP, and it has been stamped with my AV
  149. codes. If the archive you've received is not a ZIP, be wary. When unzipping
  150. this archive, you should see the following at the very end:
  151.  
  152. Authentic Files Verified!   # CIS105
  153. Blood Enterprises, Inc.
  154.  
  155.   If this message is not present, the archive may have been tampered with.
  156.  
  157.   The most current version of MailCall will always be available for FREQ on
  158. Shadowdale with the magicname MAILCALL. See below for my contact information.
  159. Any new versions will be hatched down the FidoNet TG_SUP filebone.
  160.  
  161. ──────────────────
  162. Special Thanks To:
  163. ──────────────────
  164.  
  165.     Tim Strike and David Stumpf - Tim and Dave both answered questions and
  166.                                   lent me a hand with this utility in it's
  167.                                   initial stages. Thanks guys!
  168.  
  169.    Scott Adams, Patrick Spence,
  170.    and Dave Richmond            - All of these guys have answered Pascal
  171.                                   related questions for me at one time
  172.                                   or another. Again, thanks guys! :)
  173.                                        
  174. ────────────
  175. Future Plans
  176. ────────────
  177.  
  178.    Barring bugs and structure changes, MailCall will only be updated if other
  179. mailer types come into demand.
  180.  
  181. ──────────
  182. Copyrights
  183. ──────────
  184.  
  185.  MailCall is Copyright Blood Enterprises, 1998. All Rights Reserved.
  186.  Telegard is Copyright Tim Strike, 1994,1998. All Rights Reserved.
  187. FrontDoor is Copyright 1998 Definite Solutions HB. All rights reserved.
  188. InterMail is Copyright 1986-1988 Further Development, Inc. & InterZone
  189.              Software, Inc. All Rights Reserved.
  190.  
  191. ───────────────────
  192. Contact Information
  193. ───────────────────
  194.  
  195.   Author: Ken Reaverson
  196.   Email : tremere@mindless.com
  197.  FidoNet: TG_SUPPORT Conference
  198.  NetMail: 1:133/1004 (FidoNet) / 111:4770/2 (Sysop's TechNet)
  199.      BBS: Shadowdale - 770-982-7859 (Open 24/7, Validation on first call)
  200.