home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / pmmpp101.zip / pmmpop.txt < prev    next >
Text File  |  1996-08-14  |  5KB  |  166 lines
  1.  
  2.  ┌────────────────────────────────────────────────────────────────────────────┐
  3.  │            PmmPop -- PMMail<->UUPC/extended Gateway for OS/2               │
  4.  │                            Version 1.01                                    │
  5.  ├────────────────────────────────────────────────────────────────────────────┤
  6.  │                     (c) 1996 by Carsten Wimmer                             │
  7.  │                       cawim@train.tng.oche.de                              │
  8.  └────────────────────────────────────────────────────────────────────────────┘
  9.  
  10.  
  11. Introduction
  12. ~~~~~~~~~~~~
  13.   PmmPop is a small command-line POP3-Server that acts as a gateway
  14.   between PMMail and UUPC/extended. The idea is to provide a small local
  15.   POP3-Server that works with the email-mailboxes created by UUPC/extended.
  16.   PMMail can connect to this server and send/receive mail.
  17.  
  18.  
  19. Installation
  20. ~~~~~~~~~~~~
  21.   Make sure that IBM TCP/IP (or the IBM Internet Access Kit), PMMail
  22.   and UUPC/extended have been correctly installed.
  23.  
  24.   The installation of PmmPop itself is simple, do the following:
  25.  
  26.    - Create a directory and place all the PmmPop files there
  27.  
  28.    - Edit the PMMPOP.USR file and place all your account names, passwords
  29.      and mailbox-filenames there. The format of this file is:
  30.  
  31.        1st column: user name
  32.        2nd column: password
  33.        3rd column: filename of UUPC/extended mailbox
  34.  
  35.      Of course you can define multiple accounts, each in one separate line.
  36.  
  37.    - Configure a LOOPBACK device, so PMMail can connect to your own
  38.      machine. To do this the IFCONFIG utility is used, which comes
  39.      with IBM TCP/IP or the IBM IAK. The syntax is:
  40.  
  41.        ifconfig lo <your ip>
  42.  
  43.      For example:
  44.        ifconfig lo 194.94.253.161
  45.  
  46.      A PING on your IP should work now.
  47.  
  48.      If you reboot or anything changes the routing, the LOOPBACK device
  49.      is lost and PmmPop won't work anymore!  See below under "Automation".
  50.  
  51.    - Edit or create the HOSTS file that can be found in your ETC
  52.      directoy (for example c:\tcpip\etc\hosts or c:\mptn\etc\hosts). If
  53.      you don't know where your ETC directory is, type "set etc" on a
  54.      command-prompt. If you have everything correctly installed it will
  55.      tell you the appropriate directory.
  56.      Add the following line to your HOSTS file:
  57.  
  58.        <your ip> <your machine's name>
  59.  
  60.      For example:
  61.        194.94.253.161     train.tng.oche.de
  62.  
  63.    - Ok, that's it. PmmPop can run in the background now. Use CTRL-C
  64.      or CTRL-BREAK (or any KILL-utility) to stop it. It's probably
  65.      a good idea to start/stop PmmPop on demand. See below under
  66.      AUTOMATION.
  67.  
  68.  
  69. Configuring PMMail
  70. ~~~~~~~~~~~~~~~~~~
  71.    - Create/Edit an account and go to the account's settings.
  72.  
  73.    - Under RECEIVE and SEND:
  74.  
  75.        Select "POP" as Receive-Transport-Service.
  76.        Use <your machine's name> as "POP Server".
  77.        Use 110 as "Port".
  78.        Provide an "User ID" and "Password" that can be found in PMMPOP.USR.
  79.  
  80.    - That's all. For the rest of the configuration, have a look at the
  81.      PMMail Help.
  82.  
  83.  
  84. Automation
  85. ~~~~~~~~~~
  86.   Since it is only necessary to have PmmPop running when PMMail is
  87.   used, you can automate the starting/stopping by a small batch-file.
  88.  
  89.   I am using the following batch PPSTART.CMD, which runs only under 4OS/2.
  90.  
  91.     ifconfig lo 194.94.253.161
  92.     cdd c:\pmmpop
  93.     start "PMMail<->UUPC/extended Gateway" /C /BG /MIN /WIN pmmpop.exe
  94.     delay 2
  95.  
  96.     cd c:\SOUTHSIDE\PMMAIL
  97.     start "PMMail" /C /FG /PM /WAIT pmmail.exe
  98.  
  99.     go k pmmpop.exe
  100.  
  101.   This should get you going, it's pretty easy. GO is a small command-line
  102.   utility that is able to kill other processes. You can find it on most
  103.   OS/2 ftp-servers.
  104.  
  105.  
  106. Notes
  107. ~~~~~
  108.   Some notes:
  109.  
  110.     - PmmPop doesn't support the DELE POP3-command yet, therefore it deletes
  111.       the UUPC/extended mailbox after PMMail fetched all mail. If you run
  112.       in any problems, you may find a backup-copy of your mailbox-file
  113.       where the original file was.
  114.  
  115.     - Don't let PmmPop access your mailbox when UUPC/extended itself is
  116.       working with it.
  117.  
  118.   I will take care of these topics in future versions!
  119.  
  120.  
  121. History
  122. ~~~~~~~
  123.   v1.00  07/28/96  - First public release
  124.  
  125.   v1.01  08/14/96  - PmmPop is now able to process large UUPC mailboxes
  126.  
  127.  
  128. Legal Disclaimer
  129. ~~~~~~~~~~~~~~~~
  130.   Permission is granted to any individual or institution to use, copy, or
  131.   redistribute this archive as long as it is not modified and that it
  132.   is not sold for profit.
  133.  
  134.   PmmPop and its associated utilities are provided AS IS and come with no
  135.   warranty of any kind, either expressed or implied. In no event will
  136.   the copyright holder be liable for any damages resulting from the use
  137.   of this software.
  138.  
  139.   ALL TRADEMARKS AND SERVICE MARKS ARE THE PROPERTY OF THEIR RESPECTIVE
  140.   OWNERS.
  141.  
  142.  
  143. Registration
  144. ~~~~~~~~~~~~
  145.   PmmPop is neither Freeware nor Shareware.  It's Cardware.  If you use
  146.   it on a regular basis and like it, you have to send a picture postcard
  147.   from your location to the author.  His snail mail address is shown below.
  148.  
  149.  
  150. Final Note
  151. ~~~~~~~~~~
  152.   If you want to contact me, write to cawim@train.tng.oche.de !
  153.  
  154.   Comments, Bug-Reports and Feature-Requests are welcome.  Flames are not.
  155.  
  156.   Send any nice picture postcards to:
  157.  
  158.     Carsten Wimmer
  159.     Freunder Landstr. 53a
  160.     52078 Aachen
  161.     Germany
  162.  
  163.   Have fun!
  164.   Carsten
  165.  
  166.