home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / popw12.zip / readme.1st < prev   
Text File  |  1995-05-15  |  5KB  |  120 lines
  1.  
  2.  Hi,
  3.  
  4.  This program, called POP Watch, is for use with Os/2 and either
  5.  the IAK (Internet Access Kit) that comes with Warp, or TCP/IP v2.0.
  6.  
  7.  POP stands for Post Office Protocol and defines a method for client
  8.  /server mail transactions.  The most current document on POP is
  9.  RFC 1725.  
  10.  
  11.  If you use UltiMail, PM-Mail, or someother POP based mail reader then
  12.  perhaps POP Watch will interest you.
  13.  
  14.  POP Watch does the following -
  15.  ============================
  16.  
  17.  . When supplied with a POPServer, UserID, Password, time, and other
  18.    configuration details it will remember these.  They are stored in
  19.    the popw.ini file in the directory you run POPW.EXE from.
  20.  
  21.  . Query the Server each "time" interval to check for Mail.
  22.  
  23.  . If mail is recieved then the current Os/2 cursor will change for 5
  24.    seconds to a pointer with letters overlayed and a beep will sound.
  25.  
  26.  . If unable to gain a socket connection (ie. you have hung up the IAK)
  27.    over two (2) consecutive attempts ("time" distance apart) will exit.
  28.    (AutoExit must be on)
  29.  
  30.  . If you supply an unrecognised UserID, or password, will show the
  31.    POP Server's response - then exit. (Error Notification must be on)
  32.  
  33.  Some features of POP Watch
  34.  ==========================
  35.  
  36.  . It is a "run and forget" program.  You could have it automatically
  37.    start up when you log on with SL/IP - and when you disconnect it will
  38.    shutdown in between 1 and 2 "time" periods.
  39.  
  40.  . It doesn't use valuable processor cycles, or resources.  POP Watch
  41.    not really a PM program and only registers a message queue to display
  42.    MessageBoxes when require - then releases them.  This eliminates a
  43.    previous problem with blocked message queues.
  44.  
  45.  . It uses considerably less memory that POPBiff (1.5mb!) and is written
  46.    in C using EMX 0.9a and the BSDSockets!
  47.  
  48.  POP Watch requires the EMX 0.9a runtime package installed.  This means
  49.  the DLL's in this package must be in a location that POP Watch can find!
  50.  
  51.  POP Watch is e-mail ware.  This means if you use it please send me some
  52.  mail with what you do and don't like - and what improvements you would
  53.  like to see.
  54.  
  55.  This is the third public release of POPWatch to fix some obvious bugs.
  56.  (ie. blocked message queue on conjested SL/IP links)  It adds a few new
  57.  things, like keeping all the previous command line options in the INI
  58.  file.
  59.  
  60.  *** To All Users of Previous Versions of POPWatch ***
  61.  
  62.  I seriously recommend that you get this updated version otherwise at
  63.  times when the link between your POPServer and your machine becomes
  64.  very slow you may have a total system slowdown due to POPWatch having
  65.  a blocked message queue... this release fixes that problem.
  66.  
  67.  
  68.  Other applications I have released publicly are (PLUG MODE ON) the
  69.  Inf-HTML package that does real-time (or batch mode) conversion of Os/2
  70.  binary INF/HLP files to HTML. This can be found as infhtm08.zip on
  71.  hobbes in the /network (tcpip?) branch. (PLUG MODE OFF)
  72.  
  73.  USAGE
  74.  =====
  75.  
  76.  I suggest that you do the following -
  77.  
  78.  . Obtain and install the EMX 0.9a runtime package - the DLL's are required.
  79.  
  80.  . Put the popw.exe in your \tcpip\bin or \iak\bin directory.
  81.  
  82.  . Create a program object for it in your internet folder.
  83.  
  84.  . Run the program, fill in the fields and select a time period (1-12min)
  85.    The program is now running in the background.  If you are not connected
  86.    you will find that it will "self terminate" in about 2 "time" intervals.
  87.  
  88.  . Unless you wish to have the dialog box come up everytime you run it put
  89.    a "/n" in the parameters field of the program object.
  90.  
  91.  . For power users figure out how to start it automatically when your
  92.    SL/IP connection goes up!  (Tip - PMSL/IP's ini file has a AutoStart
  93.    field that you could use if you aren't using UltiMail/2)
  94.  
  95.  BUGS, ETC
  96.  =========
  97.  
  98.  Email me at pjchilds@apanix.apana.org.au
  99.  
  100.  FUTURE CHANGES
  101.  ==============
  102.  
  103.  I really wanted to get the current cursor, and then overlay it with the
  104.  letters (as not everyone uses the standard cursor).  I know how to do most
  105.  of this but how do you overlay one bitmap on the other (if you have two
  106.  hbm's ? )  When I have this figured I will make the change. 
  107.  
  108.  I'll get around to making a option for where you put your INI file...
  109.  Possibly a enviroment variable or command line option.
  110.  
  111.  Later,
  112.        Peter Childs
  113.  
  114.  --
  115.   Interested in making Os/2 INF files (like the Os/2 Warp FAQ) availble
  116.      on your WebServer... INF to HTML conversion of interest... see
  117.                  http://apanix.apana.org.au/~pjchilds
  118.  INTERNET: pjchilds@apanix.apana.org.au        #include<stddisclaimers.h>
  119.  
  120.