


POPWatch(1)                                           POPWatch(1)


                     PPOOPPWWaattcchh -- UUssee PPOOPP ttoo wwaattcchh ffoorr mmaaiill
       POPWatch is a POP3 (Post Office Protocol) client program for Os/2 Warp's
       Internet Access Kit and/or IBM's  TCP/IP  package.  It  interegates  the
       specified  POP server at a user specified time interval and notifies the
       user of Mail/New Mail by changing the cursor and/or a message box.

IINNSSTTAALLLLAATTIIOONN
       Copy the POPW.EXE to the /iak/bin directory,  or  /tcpip/bin  directory.
       You also need the emx run-time DLLs.  You can get these from

            ftp-os2.cdrom.com:/os2/32bit/unix/emx09a/emxrt.zip

       Make sure the emx run-time DLLs are in a directory in your LIBPATH.

       Make  a  program object in your Internet Access Kit or TCP/IP folder for
       the POPW.EXE with the working directory being /tcp/etc or /iak/etc (this
       will  be  where the popw.ini file is created).  If the file contains the
       line

       You should run the program from this object without the _/_n  command  and
       fill  in the details of your POP server.  When you run the program with-
       out the _/_n switch you can change the default configuration to suite your
       own tastes.

       Personally I configure POPWatch with

            "MsgBox notification", "Notify New Only", "Quiet", "Query Cursor",
            "Alt Pointers"

       via  the  CheckBoxes,  and  use  the _/_n parameter in my Program Object's
       "Parameters" section to stop the  Dialog  Box  appearing  everytime  the
       application is run.

EEnnddiinngg PPOOPPWWaattcchh
       POPWatch  once  running  in  the  background will shut itself down if it
       fails to obtain two socket connections  in  a  row  (ie  the  server  is
       unavailble as you have ended the SL/IP connection).  You can disable the
       _A_u_t_o_E_x_i_t option to stop this - but then you have no way of  exiting  the
       program.

CCOONNTTAACCTTIINNGG TTHHEE AAUUTTHHOORR
       POPWatch  is  email-ware,  which means if you use it I'd like some mail.
       Suggestions are appreciated and may be acted on.  I can be contacted  as
       Peter Childs <pjchilds@apanix.apana.org.au>.

OOPPEERRAATTIIOONN
       There are several ways to run POPWatch.

       You  could,  by  disabling  the  _A_u_t_o_E_x_i_t  option, place a shadow of the
       object in you startup folder.

       If you use a SCRIPT for your slip connection you  could  start  it  from
       there.




                                                                1





POPWatch(1)                                           POPWatch(1)


       Alternatively,  you can start the program manually via a Program Object.

OOPPTTIIOONNSS
       The program has the following checkboxes, and command line switches.

        Command Line Switch - _/_n
                 Don't prompt for POP server details.  This  option  suppresses
                 the  dialog box.  You can use this once your options are set -
                 the are saved in/loaded from the popw.ini file.

        CheckBox - _A_u_t_o_E_x_i_t
                 AutoExit.  With this option POPWatch will automatically  exit-
                 ing  after  two  consecutive  socket connection fails.  If you
                 diable this you will only be able to stop the program by shut-
                 ing down the machine.

        CheckBox - _Q_u_i_e_t
                 Quiet  operation.   POPWatch  won't  beep on mail/new mail, or
                 when exiting.

        CheckBox - _N_o_t_i_f_y _N_e_w _O_n_l_y
                 POPWatch will only do a  five-second  cursor  change  for  new
                 mail.  (ie. a change since the last query).  Combined with the
                 _M_s_g_B_o_x _N_o_t_i_f_i_c_a_t_i_o_n option when new mail is detected you  will
                 get a message box with the relevant details.

        CheckBox - _M_s_g_B_o_x _N_o_t_i_f_i_c_a_t_i_o_n
                 POPWatch  will  use a message box in addition to cursor change
                 to give details on mail (or new mail if used with  _N_o_t_i_f_y  _N_e_w
                 _O_n_l_y switch).

        CheckBox - _E_r_r_o_r _N_o_t_i_f_i_c_a_t_i_o_n
                 POPWatch  will  use  a message box to notify of errors that it
                 would otherwise ignore - like unsuccessful  attempts  to  lock
                 the  mailbox, incorrect/unknown usernames, and incorrect pass-
                 words etc.

        CheckBox - _P_o_r_t_1_0_9
                 Use POP port 109.  The default for POP3  is  using  port  110.
                 This options tells POPWatch to use port 109.

AACCKKNNOOWWLLEEDDGGEEMMEENNTTSS
       This  program  was  written  with EMX 0.9a using the sockets.c/sockets.h
       code written by Carl Harris <ceharris@cs.vt.edu>.  It  was  inspired  by
       POPBiff written by Michele Marziani (marziani@vaxfe.fe.infn.it).

SSTTAANNDDAARRDD DDIISSCCLLAAIIMMEERR
       The author makes no representations about the accuracy or suitability of
       this material for any purpose.  It is  provided  "as  is",  without  any
       express  or implied warranties.  The author will assume no liability for
       damages either from the direct use of this product or as  a  consequence
       of the use of this product.





                                                                2


