home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / pbiff3_3.zip / pbiff.txt < prev   
Text File  |  1996-07-30  |  7KB  |  157 lines
  1. PBiff 3.3  ... just another PM biff programm for TCP/IP
  2.  
  3.  
  4. 1. What does it do?
  5. -------------------
  6. It checks periodically if your POP mail host has got some mail for you. It
  7. works on 'hard wired' networks as well as with a SLIP connection via modem.
  8. The number of mails (or any network problems) are displayed in a window in the
  9. upper right corner of your screen.
  10.  
  11. Alternatively, the program may be used as a simple network monitor, just to 
  12. check if the network is up and running (you only need a computer with a POP 
  13. demon running anywhere reachable, without the need to have an own account on 
  14. this machine). The program will detect network problems which are not realized
  15. by most other TCP/IP programs, e.g. a broken connection due to a modem hangup,
  16. or a broken network due to heavy network traffic.
  17.  
  18.  
  19. 2. Installation
  20. ---------------
  21. Copy pbiff.exe to any directory and start the program. On its first start, it
  22. will ask you for your POP host, the port number to use (usually, port 110 will
  23. work fine), your user name, and your password. These data will be stored in a 
  24. file pbiff33.ini. If you want to change this configuration, simply remove 
  25. pbiff33.ini and restart the program; it will ask you again for the information
  26. it needs.
  27.  
  28. In order to automatically start pbiff, you may add the program either into your
  29. startup folder (located in the OS/2 system folder), or add a statement 'start
  30. x:\pbiff-path\pbiff.exe [any options]' at the end of the tcpstart.cmd file
  31. (located in x:\tcpip\bin\).
  32.  
  33. You need the EMX runtime DLL (emx.dll) in the version 0.9b, which is not 
  34. included in this package but easily available at most OS/2 ftp servers (and 
  35. included in many other useful public domain and shareware OS/2 programs).
  36.  
  37.  
  38. 3. Using pbiff.exe
  39. ------------------
  40. There a three command line options:
  41.  
  42. -m     Don't look for mail; you only need to enter the name of any machine
  43.        reachable for your computer with a POP demon running.
  44.  
  45. -t=n   Check all n seconds; e.g., -t=600 means one check every ten minutes.
  46.        Default is one check per minute.
  47.  
  48. -?     Display some information about the program.
  49.  
  50. pbiff.exe is a 'run and forget' program: The recent status of your POP server/
  51. your network is displayed in the upper right corner of the screen and updated
  52. whenever there is a change. However, there is one interactive feature: With a
  53. double click in the window area, you can initialize a check (for example, just
  54. before shutting down your computer to look if some 'last minute' mail has 
  55. arrived).
  56.  
  57. To stop pbiff.exe, you have to use close feature of the task list or a kill
  58. utility.
  59.  
  60.  
  61. 4. What you need
  62. ----------------
  63. pbiff.exe has been tested under OS/2 2.1 with IBM's TCP/IP 2.0 and under WARP
  64. connect, and it works with a 'hardwired' network as well as with the SLIP
  65. protocol via modem. 
  66.  
  67. The EMX runtime DLL (emx.dll, version 0.9b) is required, but not included; it 
  68. is easily available, for example via ftp from Hobbes (ftp-os2.nmsu.edu), 
  69. ftp-os2.cdrom.com, or (in Germany) ftp.leo.org. Because lots of useful 
  70. freeware, shareware, and public domain programs are developed with the EMX 
  71. package, you might find it already on your hard disk.
  72.  
  73.  
  74. 5. How it works
  75. ---------------
  76. When being started, pbiff.exe looks for the file pbiff33.ini in its working
  77. directory. If pbiff33.ini does not exist, some data (POP host and port, user 
  78. name, password) are being asked from the user and saved in pbiff33.ini; 
  79. otherwise, this information is read from pbiff33.ini.
  80.  
  81. The program periodically tries to establish a connection to the POP host using 
  82. the port you entered on its first start. If the -m flag was not given, it tries
  83. to obtain information about the number of mails for the user. If -m was given,
  84. the connection is closed immediately after having been established, so no user 
  85. name and password information is needed (and you don't have to enter it after 
  86. the first start).
  87.  
  88. The function that establishes the connection is started as an own thread. Using
  89. a timer, it is checked how long this thread has been running; after ten seconds
  90. without response from the POP host, the thread is killed, and a time out
  91. message is displayed. In some cases of network problems, network calls are
  92. not refused, but only 'hang'. For example, this happens if you are using the
  93. SLIP protocol via modem and your modems hangs up; in this case, most TCP/IP
  94. programs simply wait forever (or at least for a very long time), and you might
  95. not realize that your connection is broken down. pbiff.exe detects such cases
  96. by way of its time out functionality; so if you don't need the biff function,
  97. it might be useful as a simple network monitor (with the -m option).
  98.  
  99.  
  100. 6. Legal stuff
  101. --------------
  102. pbiff.exe is freeware. If you use it, send a short e-mail to the author:
  103.  
  104. oliver.diedrich@uni-tuebingen.de
  105.  
  106. pbiff.exe is distributed WITHOUT ANY WARRANTY. I hope it is useful, but there
  107. is no warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  108.  
  109.  
  110. 7. Bugs and limitations
  111. -----------------------
  112. Version 3.3 of biff.exe is the third version released to the public. The 
  113. program is doing well on my machines and seems to be free of obvious bugs. If
  114. you experience any trouble, send an e-mail to the author.
  115.  
  116. pbiff.exe has been tested with different OS versions (OS/2 2.1 with the TCP/IP
  117. 2.0 package, WARP connect) and on different hardware. Of course, this does not
  118. imply that it will run with every hardware-/software-combination. Especially,
  119. there might be problems with other screen resolutions than 1024 x 786 (I've
  120. got some bad experience with other PM programs).
  121.  
  122.  
  123. 8. Author
  124. ---------
  125. Any bug reports, wishes or comments (and some friendly words if you like this
  126. program) shoud be sent to
  127.  
  128. oliver.diedrich@uni-tuebingen.de
  129.  
  130. If you are interested, I'll send you the source code.
  131.  
  132.  
  133. 9. Thanks
  134. ---------
  135. pbiff.exe was developed with EMX 0.9b. Thanks to Eberhard Mattes for this great
  136. package (for me, emx is a major reason to use OS/2), and to all who contributed
  137. to this package. 
  138.  
  139.  
  140. 10. History
  141. -----------
  142. 3.0  First public release
  143. 3.1  Occasionally, the program crashed with an access violation. Following the
  144.      EMX documentation, _beginthread() is used instead of DosStartThread(), but
  145.      the problem was not fixed; the crash was found to be caused by a string
  146.      operation. Fixed; no more crashes since then.
  147. 3.2  When starting the program, two seconds are waited before starting the
  148.      first network access, in order to get TCP/IP intitialized when started
  149.      via startup folder.
  150. 3.3  Shame on me: I used port 109 for POP services (because this works with my
  151.      POP server), instead of looking into the literature on well-known TCP/IP
  152.      ports defining port 110 for POP services. As a consequence, the user may
  153.      enter any port number on the first program start, and the port number is
  154.      stored in the ini file. The name of the ini file changed from pbiff.ini to
  155.      pbiff33.ini, in order to allow for an upgrade without difficulties.
  156.      Thanks to Michael Moennich who reported the port number problem.
  157.