home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / elm23-2.zip / README.TCP < prev    next >
Text File  |  1997-02-02  |  7KB  |  163 lines
  1. Using Elm for OS/2 together with IBM TCP/IP's sendmail
  2. ------------------------------------------------------
  3.  
  4. [It is assumed that you have read the README.OS2 file first.]
  5.  
  6.  
  7. Introduction
  8. ------------
  9.  
  10. This version of Elm also supports TCP/IP sendmail (provided by IBM
  11. in TCP/IP for OS/2) as an alternative mail transport. This is done by
  12. faking to Elm that it would run with UUPC.
  13.  
  14. The OS/2 Warp 3.0 Internet Access Kit can also provide sendmail
  15. transport. However, it is initially configured for POP3 mail, which is
  16. NOT officially supported by this release of Elm. However, a user has
  17. reported success in setting up such a configuration. Please see his
  18. instructions in the file README.POP.
  19.  
  20.  
  21. Configuration File Setup
  22. ------------------------
  23.  
  24. You just make a UUPC system.rc file with the required settings for Elm
  25. and let the UUPCSYSRC and UUPCUSRRC environment variables both point
  26. to the same file. Elm recognizes that it is working with sendmail by
  27. reading the rmail=sendmail line in that dummy .rc file.
  28.  
  29. See the sample elm-tcp.rc file which shows how to set up a .rc file to
  30. use Elm with sendmail.
  31.  
  32. The .rc file must contain the settings "rmail=sendmail", as a flag for
  33. Elm that it runs with TCP/IP sendmail and the settings "NodeName=",
  34. "Domain=", "ConfDir=", "SpoolDir=", "MailDir=", "TempDir=", "PostMaster=",
  35. "MailBox=", "Name=", "Home=", "Editor=" and "Pager=" and optionally
  36. also a "FromDomain=" and a "ReplyTo=" setting.
  37.  
  38. If you use sendmail, you have a choice how to run sendmail from within
  39. Elm when sending mail. The default behaviour is for Elm to run
  40. sendmail synchronously, i.e. to wait until it has finished sending the
  41. message. This way you are told about an eventual failure. 
  42.  
  43. Optionally, you can cause Elm to run sendmail asynchonously
  44. ("detached"), i.e. NOT to wait until it has completed. This may be
  45. preferable if you are connected to a busy network where delivery of
  46. messages can take a while (up to a minute, for example) and you don't
  47. always want to wait that long.
  48.  
  49. Both modes of running IBM's sendmail.exe require a small helper
  50. program for Elm (the included sndmail.exe program) to clean up the
  51. temporary message file after sendmail completes, especially in the
  52. case of "detached" use of sendmail. You must install the sndmail.exe
  53. program on your system (in a directory listed in PATH).
  54.  
  55. To select the "detached" mode for sendmail, add the line
  56. "Options=background" to your .rc file (see comment in the included
  57. sample elm-tcp.rc file).
  58.  
  59.  
  60. Incoming Mail
  61. -------------
  62.  
  63. Incoming mail can be received by IBM's sendmail program which is
  64. included with TCP/IP for OS/2 (version 2.0 base kit or version 3.0 and
  65. above as included with Warp Connect and Warp Server).
  66.  
  67. Depending on if you use TCP/IP 2.0 or TCP/IP 3.0, the sendmail program
  68. will act a bit different. For TCP/IP 2.0, it will deliver incoming
  69. mail into a directory to be processed by the LaMail program. For
  70. TCP/IP 3.0, it will be delivered to Ultimail/Lite. Both modes can NOT
  71. be used with Elm.
  72.  
  73. So, in both cases, you have to modify your sendmail.cf file to deliver
  74. mail into a format readable with Elm. For this purpose, a small
  75. utility (rcvmail.exe) is included with this version of Elm that can be
  76. used as the delivery agent with IBM's sendmail.
  77.  
  78. The rcvmail.exe takes two or three arguments. The first is the
  79. absolute path of the directory where the user mailbox files are
  80. stored (the same directory specified with MailDir= in the .rc file).
  81. The second is the user name for which the mail is delivered. The
  82. optional third argument is the option -u which must precede the
  83. other two, if used. The -u option causes rcvmail.exe to add the UUPC
  84. style message separators to the messages stored in the user mailbox
  85. files, which is recommended when using Elm.
  86.  
  87. Locate the line in your sendmail.cf that starts with the Mlocal
  88. keyword and modify it as indicated in the sample line below:
  89.  
  90. Mlocal, P=x:/tcpip/bin/rcvmail.exe, F=lsDFMP, S=10, R=20, A=-u x:/tcpip/mail $u
  91.  
  92. The $u symbol causes sendmail to pass the user name the mail is for as
  93. the argument to rcvmail.exe.
  94.  
  95. The MailDir= setting tells Elm where it should maintain the Unix-style
  96. mailbox file where it transfers incoming mail to. I would suggest
  97. using x:\tcpip\mail (you have to create that directory manually, of
  98. course). And if you set the MailBox= setting to, for example, higgins,
  99. then your mailbox file will be x:\tcpip\mail\higgins. Any mail coming
  100. in for a user called higgins will be delivered by rcvmail.exe into
  101. that same file.
  102.  
  103. The rcvmail.exe program will not accept mail for any arbitrary user,
  104. only for known ones. To make users known to it, you need to create a
  105. Unix style passwd file in the ConfDir= directory. See the sample
  106. included passwd file to make yourself familiar with the format. Any
  107. mail to a user name not defined in the passwd file is delivered into a
  108. mailbox file with the name specified with PostMaster= in the .rc file.
  109.  
  110.  
  111. Forward Files
  112. -------------
  113.  
  114. If a "forward" file is found in the home directory of a user rcvmail
  115. is trying to deliver mail for (the home directories are defined in the
  116. passwd file), it is processed line by line. Each line can contain either
  117. a local user name to which the mail is forwarded (and for whom in
  118. turn rcvmail checks for a forward file), a remote e-mail address (with
  119. a @ in it) to which the mail is forwarded, a \ followed by a local mailbox
  120. file name (i.e. a user name without further checking and forward 
  121. expansion) or a | followed by a system command into which the mail 
  122. message is piped on standard input. 
  123.  
  124. If all lines of a forward file failed to be processed properly, the 
  125. mail is delivered to the owning user despite the presence of the forward
  126. file. If there is at least one successfull delivery during the processing 
  127. of a forward file, the owning user does not get a copy of the message in
  128. his/her mailbox file.
  129.  
  130.  
  131. Sent/Delivered Mail Log Files
  132. -----------------------------
  133.  
  134. In the directory configured with the SpoolDir= line in the .rc file,
  135. both sndmail and rcvmail maintain log files with timestamped entries
  136. for each sent and received message. This way, you can always verify
  137. if a message was sent successfully, for example, even if you use
  138. the "detached" mode for senmail (Options=background).
  139.  
  140.  
  141. Sendmail Configuration File
  142. ---------------------------
  143.  
  144. By the way, a sample sendmail.cf for OS/2 file is included with this
  145. version of Elm. It is well commented and was written by Niel Kempson.
  146. Better use that as the starting point to create your own one than
  147. the sendmail.cf file include with OS/2's TCP/IP package because IBM's
  148. is not nearly as good commented and figuring out how to configure
  149. sendmail can become difficult.
  150.  
  151.  
  152. Mail Filtering
  153. --------------
  154.  
  155. Both the sndmail and rcvmail programs allow filtering of messages.
  156. Before further processing, both programs pass the messages through
  157. "sndfilt" and "rcvfilt" programs, respectively, if they exist.
  158.  
  159. These can, for example. be programs written in REXX. Included in
  160. this package are two samples that I use to convert to/from MIME
  161. encoding of messages with 8-bit characters as "quoted printable".
  162.  
  163.