home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / popw12.zip / popw.doc < prev    next >
Text File  |  1995-05-15  |  6KB  |  133 lines
  1.  
  2.  
  3.  
  4. POPWatch(1)                                           POPWatch(1)
  5.  
  6.  
  7.                      PPOOPPWWaattcchh -- UUssee PPOOPP ttoo wwaattcchh ffoorr mmaaiill
  8.        POPWatch is a POP3 (Post Office Protocol) client program for Os/2 Warp's
  9.        Internet Access Kit and/or IBM's  TCP/IP  package.  It  interegates  the
  10.        specified  POP server at a user specified time interval and notifies the
  11.        user of Mail/New Mail by changing the cursor and/or a message box.
  12.  
  13. IINNSSTTAALLLLAATTIIOONN
  14.        Copy the POPW.EXE to the /iak/bin directory,  or  /tcpip/bin  directory.
  15.        You also need the emx run-time DLLs.  You can get these from
  16.  
  17.             ftp-os2.cdrom.com:/os2/32bit/unix/emx09a/emxrt.zip
  18.  
  19.        Make sure the emx run-time DLLs are in a directory in your LIBPATH.
  20.  
  21.        Make  a  program object in your Internet Access Kit or TCP/IP folder for
  22.        the POPW.EXE with the working directory being /tcp/etc or /iak/etc (this
  23.        will  be  where the popw.ini file is created).  If the file contains the
  24.        line
  25.  
  26.        You should run the program from this object without the _/_n  command  and
  27.        fill  in the details of your POP server.  When you run the program with-
  28.        out the _/_n switch you can change the default configuration to suite your
  29.        own tastes.
  30.  
  31.        Personally I configure POPWatch with
  32.  
  33.             "MsgBox notification", "Notify New Only", "Quiet", "Query Cursor",
  34.             "Alt Pointers"
  35.  
  36.        via  the  CheckBoxes,  and  use  the _/_n parameter in my Program Object's
  37.        "Parameters" section to stop the  Dialog  Box  appearing  everytime  the
  38.        application is run.
  39.  
  40. EEnnddiinngg PPOOPPWWaattcchh
  41.        POPWatch  once  running  in  the  background will shut itself down if it
  42.        fails to obtain two socket connections  in  a  row  (ie  the  server  is
  43.        unavailble as you have ended the SL/IP connection).  You can disable the
  44.        _A_u_t_o_E_x_i_t option to stop this - but then you have no way of  exiting  the
  45.        program.
  46.  
  47. CCOONNTTAACCTTIINNGG TTHHEE AAUUTTHHOORR
  48.        POPWatch  is  email-ware,  which means if you use it I'd like some mail.
  49.        Suggestions are appreciated and may be acted on.  I can be contacted  as
  50.        Peter Childs <pjchilds@apanix.apana.org.au>.
  51.  
  52. OOPPEERRAATTIIOONN
  53.        There are several ways to run POPWatch.
  54.  
  55.        You  could,  by  disabling  the  _A_u_t_o_E_x_i_t  option, place a shadow of the
  56.        object in you startup folder.
  57.  
  58.        If you use a SCRIPT for your slip connection you  could  start  it  from
  59.        there.
  60.  
  61.  
  62.  
  63.  
  64.                                                                 1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. POPWatch(1)                                           POPWatch(1)
  71.  
  72.  
  73.        Alternatively,  you can start the program manually via a Program Object.
  74.  
  75. OOPPTTIIOONNSS
  76.        The program has the following checkboxes, and command line switches.
  77.  
  78.         Command Line Switch - _/_n
  79.                  Don't prompt for POP server details.  This  option  suppresses
  80.                  the  dialog box.  You can use this once your options are set -
  81.                  the are saved in/loaded from the popw.ini file.
  82.  
  83.         CheckBox - _A_u_t_o_E_x_i_t
  84.                  AutoExit.  With this option POPWatch will automatically  exit-
  85.                  ing  after  two  consecutive  socket connection fails.  If you
  86.                  diable this you will only be able to stop the program by shut-
  87.                  ing down the machine.
  88.  
  89.         CheckBox - _Q_u_i_e_t
  90.                  Quiet  operation.   POPWatch  won't  beep on mail/new mail, or
  91.                  when exiting.
  92.  
  93.         CheckBox - _N_o_t_i_f_y _N_e_w _O_n_l_y
  94.                  POPWatch will only do a  five-second  cursor  change  for  new
  95.                  mail.  (ie. a change since the last query).  Combined with the
  96.                  _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
  97.                  get a message box with the relevant details.
  98.  
  99.         CheckBox - _M_s_g_B_o_x _N_o_t_i_f_i_c_a_t_i_o_n
  100.                  POPWatch  will  use a message box in addition to cursor change
  101.                  to give details on mail (or new mail if used with  _N_o_t_i_f_y  _N_e_w
  102.                  _O_n_l_y switch).
  103.  
  104.         CheckBox - _E_r_r_o_r _N_o_t_i_f_i_c_a_t_i_o_n
  105.                  POPWatch  will  use  a message box to notify of errors that it
  106.                  would otherwise ignore - like unsuccessful  attempts  to  lock
  107.                  the  mailbox, incorrect/unknown usernames, and incorrect pass-
  108.                  words etc.
  109.  
  110.         CheckBox - _P_o_r_t_1_0_9
  111.                  Use POP port 109.  The default for POP3  is  using  port  110.
  112.                  This options tells POPWatch to use port 109.
  113.  
  114. AACCKKNNOOWWLLEEDDGGEEMMEENNTTSS
  115.        This  program  was  written  with EMX 0.9a using the sockets.c/sockets.h
  116.        code written by Carl Harris <ceharris@cs.vt.edu>.  It  was  inspired  by
  117.        POPBiff written by Michele Marziani (marziani@vaxfe.fe.infn.it).
  118.  
  119. SSTTAANNDDAARRDD DDIISSCCLLAAIIMMEERR
  120.        The author makes no representations about the accuracy or suitability of
  121.        this material for any purpose.  It is  provided  "as  is",  without  any
  122.        express  or implied warranties.  The author will assume no liability for
  123.        damages either from the direct use of this product or as  a  consequence
  124.        of the use of this product.
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                                                                 2
  131.  
  132.  
  133.