home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / uupc2mr2.zip / uupc.txt < prev   
Text File  |  1997-01-07  |  5KB  |  139 lines
  1. Installing UUPC support.
  2.  
  3. First you should have a working UUPC setup. It is now possible to
  4. use the UUPC support without a UUPC setup - see the section below
  5. titled "How to use the MR/2 UUPC support without setting up UUPC".
  6.  
  7.  
  8. The getmail.cmd and postmail.cmd files go in the MR2 ICE mail directory.
  9. This should be the user name you log on to MR/2 ICE with. If you use the
  10. default it is MAIL.
  11.  
  12. The UNMBOX.EXE program should either go in the MR/2 ICE directory or
  13. somewhere on the PATH. Edit the getmail.cmd and postmail.cmd files and
  14. change the "mail" on the indicated lines to the correct directory name
  15. for your setup. 
  16.  
  17. In the MR/2 ICE Network Settings change the Read mail and Deliver mail
  18. to Custom. Also add a valid directory to the SMTP Settings Mail Dir.
  19. Make sure this directory is empty otherwise MR/2 will attempt to
  20. interpret every file as an incoming mail file. The GETMAIL.CMD file
  21. must be edited to have the same SMTP Mail Dir. This directory MUST be
  22. created before running the UUPC support.
  23.  
  24. NOTES
  25.  
  26. The UNMBOX program can parse UUPC mailboxes with the nofromsep or fromsep
  27. format. Normally mailboxes from UUPC have the nofromsep delimeter (20 0x01 or
  28. ^A characters between each mail message). However UNMBOX will use the "From "
  29. line to split mailboxes if the first line is not a nofromsep delimiter.
  30.  
  31. The UNMBOX program renames the UUPC mailbox so as to avoid a clash with
  32. UUPC writing new mail. If it cannot rename the mailbox it will exit
  33. with no message and you can try again to collect mail later.
  34.  
  35. The default directory for users is MAIL. If this is not correct for your
  36. setup then a second parameter can be added to the "unmbox" command in
  37. getmail.cmd to specify the proper name.
  38.  
  39. HOW TO USE THE MR/2 UUPC SUPPORT WITHOUT SETTING UP UUPC
  40.  
  41. 1. Set the UNMB_MAIL environment variable to point to the mailbox.
  42. 2. Modify the postmail.cmd or create a local rmail.cmd
  43.    For example you could copy the MR/2 mail file to a directory on a file
  44.    server and the PC running UUPC could do an rmail on these files before
  45.    polling. See the rmail.ex for an example.
  46.  
  47.  
  48. TROUBLESHOOTING:
  49.  
  50. The UNMBOX program uses the following settings from the UUPC
  51. config files:
  52.  
  53. MailExt
  54. ConfDir
  55. MailDir
  56. Mailbox
  57.  
  58. nake sure that at least Confdir and Mailbox are defined.
  59.  
  60. NOTE: the UUPCUSRRC variables overide the UUPCSYSRC settings.
  61.  
  62. The environment variable UNMB_MAIL overides the UUPC config file
  63. settings. 
  64.  
  65. e.g.
  66. SET UNMB_MAIL=c:\user\mail\miket.mai unmbox
  67.  
  68. ERROR MESSAGES: (saved in MAIL\GETMAIL.ERR)
  69.  
  70. error - cannot find UUPC mailbox
  71.  
  72. It appears that it couldn't find your UUPC mailbox.
  73. Please ensure that UUPC works. Try the mail.exe that comes with UUPC
  74. and if it works then you can try the UNMB_MAIL environment variable.
  75. Please let me know if this error occurs and the UUPC mail program can
  76. find the mail!
  77.  
  78. error - cannot open new file for mail
  79.  
  80. This happens if the SMTP mail directory does not exist. Create the
  81. directory and try again.
  82.  
  83. unmbox: error - cannot open file for error message
  84.  
  85. There is no directory called MAIL for the MAIL\GETMAIL.ERR file to be
  86. created.
  87.  
  88. usage: unmbox <SMTP directory> [<username>]
  89.  
  90. UNMBOX requires the SMTP Mail Directory as a parameter.
  91.  
  92. error - no From or nofromsep line in mailbox
  93.  
  94. There was no From or nofromsep line in the mailbox. It may not be a
  95. valid mailbox.
  96.  
  97. error - no From line at start of mailbox
  98.  
  99. Make sure there are no blank lines at the start of the mailbox. The first
  100. line should either be 20 ^As or a "From xxx" type line.
  101.  
  102. error - parse error reading mailbox
  103.  
  104. This is a catchall error - it should not happen but if it does please
  105. contact miket@pcug.org.au and explain the circumstances of the error.
  106.  
  107.  
  108. HISTORY:
  109.  
  110. 1.0.00    Initial version.        12/10/1996
  111. 1.0.01    Fixes.                  19/10/1996
  112.              Fix parsing of UUPC variables
  113.              Add fromsep logic - NO fromsep should be defined!
  114.              Inprove get_next_fname so it does not
  115.              return a filename that already exists.
  116.              Rename UUPC mbox so it cannot be written
  117.              to by uuxqt/rmail.
  118. 1.0.02    Fixes.                  26/12/1996
  119.              Use tmpnam rather than tempnam and remove
  120.          dependence on envvar TMP being unset.
  121.          Do not delete renamed mailbox if no mail.
  122. 1.0.03    Fixes.                  01/01/1997
  123.              Fix UNMB_MAIL - was broken :-(
  124.          Fix bug with writing out to getmail.err - added
  125.          new command line parameter for MR/2 username.
  126. 1.0.04     Cleanup/fixes.            04/01/1997
  127.              Remove all global variables.
  128.              Fix bug in parsing UUPC definition files.
  129.              Works with nofromsep or fromsep format mailboxes.
  130. 1.0.05     Fixes.                 07/01/1997
  131.              Make new_mail routine more intelligent.
  132.  
  133. Acknowledgements:
  134. UNMB_MAIL bug reported by:
  135. Herbert Neugebauer haen@veces.bb.bawue.de
  136. Herbert also convinced me of the necessity of supporting fromsep
  137. format mailboxes.
  138. Herbert is also testing fromsep format mailbox parsing.
  139.