home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / CEREBRUM / DM197B2.ZIP / DMAIL.DOC < prev    next >
Text File  |  1994-05-03  |  12KB  |  280 lines
  1.  
  2.                                Dawg's DMail
  3.                                   v1.97B1
  4.                                May 2, 1994
  5.              Copyright (C) 1993, 1994, by Lawrence C. Bensinger
  6.                            All Rights Reserved
  7.  
  8.  
  9.  
  10.                   DESCRIPTION
  11.                   ===========
  12.  
  13. Dawg's DMail is a utility to send email and/or ssm's from dos.  I am of the
  14. understanding that there are other programs out there that will allow for this
  15. but I've never been able to find one (*).  So I got tired of looking and
  16. decided to write it myself.  Here is a short list of it's features:
  17.  
  18. -   Send email/ssm's from dos
  19. -   Will also post on subs,
  20.       also alphanumeric subs,
  21. -   Send newuser email,
  22.       also can send from users other than #1,
  23. -   Send ASV email,
  24. -   Mail >ALL< users,
  25. -   Now with DMTINY.EXE for DV users,
  26. -   Now with DMMAIL.EXE to send multimail,
  27. -   Will spawn your favorite editor on the fly
  28.  
  29. (*) since Dmail was first written, Trader Jack has released Fastmail which
  30.     will also send email from DOS.
  31.  
  32.                   REGISTRATION
  33.                   ============
  34.  
  35. DMail is not public domain, it is shareware.  After 15 days you must either
  36. register DMail or quit using it.  The registration request for the program 
  37. is $15.  I've spent more time than I care to admit on this and I think that is
  38. a fair price if you wish to use the program.  I had considered making the
  39. program function only if registered.
  40.  
  41.  
  42.                 FUTURE ENHANCEMENTS
  43.                 ===================
  44.  
  45. I've already added most of what I had planned on;  however, I am open to
  46. suggestions from others as to what they'd like to see it do.  Registered users
  47. will get priority as far as any suggestions.  Most of the recent enhancements
  48. have come from users.  One thing that I >am< adding is the ability to mail 
  49. all users that match a profile.  This is partially coded at the moment and
  50. with any luck will be in the next full release (2.00?).
  51.  
  52.  
  53.                    COMPATIBILITY
  54.                    =============
  55.  
  56. It *should* be compatible with any WWIV that uses NETWORKS.DAT as that is the
  57. only file other than config.dat that I look at.  You also MUST be networked
  58. for this to work since I chose to write to P*.NET instead of email.dat.  The
  59. main reason I did this was that during testing I didn't want to chance screwing
  60. up my email file so I wrote to a network file and let it handle things (ie it
  61. deletes corrupted packets, and handles the user.lst which keeps me from
  62. receiving that wonderful 'your program trashed my user.lst' email! :> ).
  63. I used to write to P2.NET automatically, now starting with v1.83 I grab
  64. the first available P?.NET file.  Made more sense to me as some programs
  65. (Jim Wire's Clout for instance) won't look for anything over P1.NET and
  66. therefore won't clean up the network files.
  67.  
  68.                    INSTALLATION
  69.                    ============
  70.  
  71. Place Dmail and Dmcfg both in the main bbs directory to start off with.
  72. Starting with v1.80, you need to run DMCFG prior to running Dmail.  The first
  73. time you run DMCFG, it will create a dmail.cfg file with defaults.  I would
  74. suggest running it again and setting things for yourself.  If you are
  75. upgrading to v1.96 you will need to run DMCFG before Dmail will run.  This is
  76. due to the fact that I've added several things to the dmail.cfg file.
  77.  
  78. Here are the command line switches, there will be a few examples at the
  79. bottom of this section:
  80.  
  81.  /F<filename>    This is the filename of the email to send.  It needs the
  82.                  path as well.
  83.  
  84.  /L<filename>    List of users to multimail in mode 8.  Needs full path to
  85.                  function, and it will only be effective if registered.
  86.  
  87.  /M<mode>        This is the mode to run in.  This allows for use as a command
  88.                  line utility to run unattended (ie in extern.bat or such).
  89.                  The possible modes at the moment are:  1 - EMAIL, 2 - SSM,
  90.                  3 - NEWUSER EMAIL, 4 - ASV Email Via TB3.MOD, 5 - POST,
  91.                  6 - Mail ALL users on the BBS, 7- cleanup newtworks.
  92.                  To fully integrate mode 4 you need TB3.MOD (not included) as
  93.                  well as DAWG19.MOD (included).
  94.  
  95.  /N<network>     Network to function on.  This defaults to network 0 which is
  96.                  your primary net.  Remember that this works like the dot
  97.                  commands so in other words to run it on your third network
  98.                  you'd have /N2.
  99.  
  100.  /S<system>      System to email.  This defaults to your own system (handy
  101.                  to send yourself logs and such).
  102.  
  103.  /U<user>        User to email.  This defaults to user #1 except in MODE 3
  104.                  in which case it reads the user number from chain.txt.
  105.  
  106.  /X<filename>    Filename of SSM to send.  This is simliar to the /F command,
  107.                  but allows for you to send SSM's unattended.  This isn't very
  108.                  useful, but since I had unattended email, I wanted to have
  109.                  the same for SSM's.
  110.  
  111.  /T              Disables taglines on email.  This was a user requested
  112.                  addition (Ozz 1@13468 <L>).  This only functions on registered
  113.                  copies, again to help prevent abuse from mass mailings and
  114.                  such.
  115.  
  116.  /G<titlenumber> Grabs a title from TITLES.STR if it exists.  It must be in
  117.                  the main bbs directory with Dmail.  This only functions on
  118.                  registered copies.  Also a user requested addition (Morgul
  119.                  1@8315 <N>).
  120.  
  121.  /P<subtype>     This is the subtype to post on.  It much be numeric, and you
  122.                  *must* be in the Nxxxx.NET file for that sub.  Otherwise the
  123.                  net software will reject the post.  This only functions with
  124.                  registered versions!
  125.  
  126.  /H<system>      This is the host of the sub.  If this is omitted it will
  127.                  default to your own node.  This only functions with
  128.                  registered versions!
  129.  
  130.  /P<subtype>     This is the subtype to post on.  It much be alphanumeric.
  131.                  This only functions with registered versions!
  132.  
  133.  /C<filename>    Used with newuser email (starting with v1.92ß/WWIV v4.23).
  134.                  INIT setting for newuser event should be DMAIL /M3 /C%1.
  135.  
  136.  /?              Displays a short listing of all commands.
  137.  
  138.  
  139. We use it on @3478 to email the probelite (Tolkien program) log files to me.
  140. Here is the command line for that:
  141.  
  142. DMAIL /M1 /S3478 /U2 /FD:\BBS\GFILES\PROBE.LOG
  143.  
  144. The /M1 indicates email mode, the /S3478 is the node for that board (the first
  145. network he's on), the /U2 is user 2, the /FD:\BBS\GFILES\PROBE.LOG is the
  146. filename to send.  This is at the end of the extern.bat file we run.  The 
  147. bbs will analyze the p2.net file on it's own before it goes back up so
  148. the mail will be 'delivered' immediately.  In this case the /S3478 is optional
  149. as that is the home system and the program will default to the home system
  150. if none is specified with the /M command.
  151.  
  152. If I wanted to send the same file to my own bbs on another network (say
  153. WWIVlink which is my second network) here would be the command line:
  154.  
  155. DMAIL /N1 /M1 /S13498 /U1 /FD:\BBS\GFILES\PROBE.LOG
  156.  
  157. Just remember with the /N parameter it's always the network number-1 just
  158. like using the dot commands with WWIV.  Here the /U1 is optional as the
  159. program will default to user 1 if none is specified when used with the
  160. /M command.
  161.  
  162. A special note for those of you that use Tolkien's Tam.  Someone was requesting
  163. a way to send a form letter to a user who had a file removed in Tam.  Dmail
  164. can be used for that, here is the command line from my F4 key in TAMCFG:
  165.  
  166. DMAIL /M1 /U%2 /FD:\BBS\GFILES\BADFILE.MSG    
  167.  
  168. Starting with version 1.22ß when running the program without a /M switch you
  169. can specify the entire network address (including network) at the line where
  170. it requests user number.  The format for doing so is xxxx@yyyyy.zz where the
  171. xxxx is the user number, the yyyyy is the system number, and the zz is the
  172. netnumber (just like the dot commands for lnet and such).  If you wish to
  173. use this it MUST follow the above format.  Thanks to Falken for requesting
  174. this...
  175.  
  176.  
  177. Thanks to Starship Trooper (1@3251 WWIVnet) the program now allows you to
  178. type your text online.  It will spawn an editor if you don't specify the file
  179. on the command line (via the /F) and then just hit enter on the line
  180. requesting it.  It will first check the environment variable EDITOR and
  181. try that.  Failing that it tries Qedit, then the EDIT from Dos.  Failing
  182. all of those it will abort.  The majority of the code for this is ST's and
  183. it was *very* appreciated!  Thanks.
  184.  
  185.                    REGISTERING
  186.                    ===========
  187.  
  188. To register, send $15 and the name of your bbs EXACTLY as it appears in 
  189. INIT to the following address.  This is CASE SENSITIVE, so for example
  190. Defcon Five and DEFCON FIVE would have different codes.
  191.  
  192.     Lawrence Bensinger
  193.     RE: DMAIL-REG
  194.     315 Park West
  195.     St. Peters, MO 63376
  196.  
  197.  
  198.  
  199.  
  200. Note, I DO NOT mail out disks.  DMail just needs a code to be registered, not
  201. any special file.  You can always download the latest version of this on
  202. several bbs's including: The Fellowship, The Land of Oz, The Trading Post
  203. [SOUTH].  I try for Dragon's Den and Amber, but we know how that goes.
  204. Starting with v1.90 you should also be able to request Dmail through FILEnet
  205. which I have just joined.  I can either email you the number and code via one
  206. of the networks I am in (WWIVnet/WWIVlink,IceNET)
  207.  
  208.                                     or   
  209.  
  210. If, and only *IF* you are high speed (v.32/v.32bis (NOT HST ONLY)), AND
  211. you have ASV I will call your bbs and email you the registration information
  212. there as well as uploading you the latest copy of the program.  If you do
  213. not have ASV (but are high speed), and you still would like me to call and
  214. u/l the program and registrations, create an account for me with the following
  215. information and include this information in your registration letter:
  216.  
  217.     Name: Dawg
  218.     User Number: _______ 
  219.     Real Name: Chuck Bensinger
  220.     Last 4 : 3248
  221.     Password: ______________ (make one up)
  222.  
  223.     The other info can be filled in as you please (although, for
  224.     completeness: Comp Type: 3, ANSI: Yes, BDay: 09/25/70, 
  225.     and if networked, please forward my mail to one of the net
  226.     addresses listed below!)
  227.  
  228.  
  229.  
  230.  
  231. SPECIAL NOTE:
  232.    I am more than willing to 'swap registrations' with other shareware
  233.    authors out there.  So if you have written some useful piece of shareware
  234.    (preferable WWIV related) and you want to trade registrations, please
  235.    let me know and we can see what we can work out.  I will not make any
  236.    guarantees about this, it is at my discretion as to whether or not I
  237.    wish to do this.
  238.  
  239. YET ANOTHER NOTE:
  240.  
  241.                CONTACTING THE AUTHOR
  242.                =====================
  243.  
  244. I can be contacted at the following network addresses:
  245.  
  246.   WWIVnet   DAWG@3456 (The Fellowship)  
  247.  
  248.   WWIVnet   (mail only! 1@3472)
  249.   WWIVlink  (mail only! 1@3472)
  250.   IceNET    (mail only! 1@3487)
  251.   PDnet     (mail only! 1@4)
  252.   FILEnet   (mail only! 1@1550)
  253.  
  254. NOTE:  I will give whatever tech support I can.  My time is limited though so
  255.        I will give registered users priority in answering questions and such.
  256.  
  257.                  CREDITS
  258.                  ======= 
  259.  
  260. WWIV is copyright Wayne Bell.
  261.  
  262. I'd like to thank the following people:
  263.  
  264. Wayne Bell (1@    1 WWIVNet)   for the great WWIV program.
  265.  
  266. Falken     (1@ 3478 WWIVNet)   for letting me use his BBS as a guinea pig!
  267.  
  268. Sam        (1@ 2077 WWIVNet)   for testing this.
  269. Sandman    (1@ 3462 WWIVNet)   "     "      "
  270. Ozz        (1@13468 WWIVLink)  "     "      "
  271. Shadowfax  (1@13465 WWIVLink)  "     "      ", and for some invaluable help!
  272. Morgul     (1@ 8315 WWIVNet)   for some great ideas....
  273.  
  274. Tolkien    (1@ 3456 WWIVNet)   for helping me track down some bugs.  THANKS!
  275.  
  276.                  REVISION HISTORY
  277.                  ================
  278.  
  279.   See whats.new!
  280.