ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
 ³            PmmPop -- PMMail<->UUPC/extended Gateway for OS/2               ³
 ³                            Version 1.01                                    ³
 ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
 ³                     (c) 1996 by Carsten Wimmer                             ³
 ³                       cawim@train.tng.oche.de                              ³
 ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ


Introduction
~~~~~~~~~~~~
  PmmPop is a small command-line POP3-Server that acts as a gateway
  between PMMail and UUPC/extended. The idea is to provide a small local
  POP3-Server that works with the email-mailboxes created by UUPC/extended.
  PMMail can connect to this server and send/receive mail.


Installation
~~~~~~~~~~~~
  Make sure that IBM TCP/IP (or the IBM Internet Access Kit), PMMail
  and UUPC/extended have been correctly installed.

  The installation of PmmPop itself is simple, do the following:

   - Create a directory and place all the PmmPop files there

   - Edit the PMMPOP.USR file and place all your account names, passwords
     and mailbox-filenames there. The format of this file is:

       1st column: user name
       2nd column: password
       3rd column: filename of UUPC/extended mailbox

     Of course you can define multiple accounts, each in one separate line.

   - Configure a LOOPBACK device, so PMMail can connect to your own
     machine. To do this the IFCONFIG utility is used, which comes
     with IBM TCP/IP or the IBM IAK. The syntax is:

       ifconfig lo <your ip>

     For example:
       ifconfig lo 194.94.253.161

     A PING on your IP should work now.

     If you reboot or anything changes the routing, the LOOPBACK device
     is lost and PmmPop won't work anymore!  See below under "Automation".

   - Edit or create the HOSTS file that can be found in your ETC
     directoy (for example c:\tcpip\etc\hosts or c:\mptn\etc\hosts). If
     you don't know where your ETC directory is, type "set etc" on a
     command-prompt. If you have everything correctly installed it will
     tell you the appropriate directory.
     Add the following line to your HOSTS file:

       <your ip> <your machine's name>

     For example:
       194.94.253.161     train.tng.oche.de

   - Ok, that's it. PmmPop can run in the background now. Use CTRL-C
     or CTRL-BREAK (or any KILL-utility) to stop it. It's probably
     a good idea to start/stop PmmPop on demand. See below under
     AUTOMATION.


Configuring PMMail
~~~~~~~~~~~~~~~~~~
   - Create/Edit an account and go to the account's settings.

   - Under RECEIVE and SEND:

       Select "POP" as Receive-Transport-Service.
       Use <your machine's name> as "POP Server".
       Use 110 as "Port".
       Provide an "User ID" and "Password" that can be found in PMMPOP.USR.

   - That's all. For the rest of the configuration, have a look at the
     PMMail Help.


Automation
~~~~~~~~~~
  Since it is only necessary to have PmmPop running when PMMail is
  used, you can automate the starting/stopping by a small batch-file.

  I am using the following batch PPSTART.CMD, which runs only under 4OS/2.

    ifconfig lo 194.94.253.161
    cdd c:\pmmpop
    start "PMMail<->UUPC/extended Gateway" /C /BG /MIN /WIN pmmpop.exe
    delay 2

    cd c:\SOUTHSIDE\PMMAIL
    start "PMMail" /C /FG /PM /WAIT pmmail.exe

    go k pmmpop.exe

  This should get you going, it's pretty easy. GO is a small command-line
  utility that is able to kill other processes. You can find it on most
  OS/2 ftp-servers.


Notes
~~~~~
  Some notes:

    - PmmPop doesn't support the DELE POP3-command yet, therefore it deletes
      the UUPC/extended mailbox after PMMail fetched all mail. If you run
      in any problems, you may find a backup-copy of your mailbox-file
      where the original file was.

    - Don't let PmmPop access your mailbox when UUPC/extended itself is
      working with it.

  I will take care of these topics in future versions!


History
~~~~~~~
  v1.00  07/28/96  - First public release

  v1.01  08/14/96  - PmmPop is now able to process large UUPC mailboxes


Legal Disclaimer
~~~~~~~~~~~~~~~~
  Permission is granted to any individual or institution to use, copy, or
  redistribute this archive as long as it is not modified and that it
  is not sold for profit.

  PmmPop and its associated utilities are provided AS IS and come with no
  warranty of any kind, either expressed or implied. In no event will
  the copyright holder be liable for any damages resulting from the use
  of this software.

  ALL TRADEMARKS AND SERVICE MARKS ARE THE PROPERTY OF THEIR RESPECTIVE
  OWNERS.


Registration
~~~~~~~~~~~~
  PmmPop is neither Freeware nor Shareware.  It's Cardware.  If you use
  it on a regular basis and like it, you have to send a picture postcard
  from your location to the author.  His snail mail address is shown below.


Final Note
~~~~~~~~~~
  If you want to contact me, write to cawim@train.tng.oche.de !

  Comments, Bug-Reports and Feature-Requests are welcome.  Flames are not.

  Send any nice picture postcards to:

    Carsten Wimmer
    Freunder Landstr. 53a
    52078 Aachen
    Germany

  Have fun!
  Carsten