home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Spezial / SPEZIAL2_97.zip / SPEZIAL2_97.iso / ANWEND / ONLINE / PBIFF35 / PBIFF.TXT < prev   
Text File  |  1997-03-27  |  8KB  |  170 lines
  1. PBiff 3.5  ... 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 (yes, pbiff33.ini, because of compatibility reasons), If you 
  25. want to change this configuration, simply remove pbiff33.ini and restart the 
  26. program; it will ask you again for the information 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 five 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. -x=n   Lower left horizontal position of pbiff's window in screen coordinates;
  51.        -x=0: most left
  52.  
  53. -y=n   Lover left vertical position of pbiff's window; 
  54.        -y=0: bottom of screen
  55.  
  56. pbiff.exe is a 'run and forget' program: The recent status of your POP server/
  57. your network is displayed in the upper right corner of the screen and updated
  58. whenever there is a change. However, there is one interactive feature: With a
  59. double click in the window area, you can initialize a check (for example, just
  60. before shutting down your computer to look if some 'last minute' mail has 
  61. arrived).
  62.  
  63. To stop pbiff.exe, you have to use close feature of the task list or a kill
  64. utility.
  65.  
  66.  
  67. 4. What you need
  68. ----------------
  69. pbiff.exe has been tested under OS/2 2.1 with IBM's TCP/IP 2.0 and under WARP
  70. connect, and it works with a 'hardwired' network as well as with the SLIP
  71. protocol via modem. 
  72.  
  73. The EMX runtime DLL (emx.dll, version 0.9b) is required, but not included; it 
  74. is easily available, for example via ftp from Hobbes (ftp-os2.nmsu.edu), 
  75. ftp-os2.cdrom.com, or (in Germany) ftp.leo.org. Because lots of useful 
  76. freeware, shareware, and public domain programs are developed with the EMX 
  77. package, you might find it already on your hard disk.
  78.  
  79.  
  80. 5. How it works
  81. ---------------
  82. When being started, pbiff.exe looks for the file pbiff33.ini in its working
  83. directory. If pbiff33.ini does not exist, some data (POP host and port, user 
  84. name, password) are being asked from the user and saved in pbiff33.ini; 
  85. otherwise, this information is read from pbiff33.ini.
  86.  
  87. The program periodically tries to establish a connection to the POP host using 
  88. the port you entered on its first start. If the -m flag was not given, it tries
  89. to obtain information about the number of mails for the user. If -m was given,
  90. the connection is closed immediately after having been established, so no user 
  91. name and password information is needed (and you don't have to enter it after 
  92. the first start).
  93.  
  94. The function that establishes the connection is started as an own thread. Using
  95. a timer, it is checked how long this thread has been running; after 15 seconds
  96. without response from the POP host, the thread is killed, and a time out
  97. message is displayed. In some cases of network problems, network calls are
  98. not refused, but only 'hang'. For example, this happens if you are using the
  99. SLIP protocol via modem and your modems hangs up; in this case, most TCP/IP
  100. programs simply wait forever (or at least for a very long time), and you might
  101. not realize that your connection has broken down. pbiff.exe detects such cases
  102. by way of its time out functionality; so if you don't need the biff function,
  103. it might be useful as a simple network monitor (with the -m option).
  104.  
  105.  
  106. 6. Legal stuff
  107. --------------
  108. pbiff.exe is freeware. If you use it, send a short e-mail to the author:
  109.  
  110. oliver.diedrich@uni-tuebingen.de
  111.  
  112. pbiff.exe is distributed WITHOUT ANY WARRANTY. I hope it is useful, but there
  113. is no warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  114.  
  115.  
  116. 7. Bugs and limitations
  117. -----------------------
  118. Version 3.5 of biff.exe is the fouth version released to the public. The 
  119. program is doing well on my machines and is used by different other persons; it
  120. seems to be free of obvious bugs. If you experience any trouble, send an e-mail
  121. to the author.
  122.  
  123. pbiff.exe has been tested with different OS versions (OS/2 2.1 with the TCP/IP
  124. 2.0 package, WARP connect) and on different hardware. Of course, this does not
  125. imply that it will run with every hardware-/software-combination. Especially,
  126. there might be problems with other screen resolutions than 1024 x 786 (I've
  127. got some bad experience with other PM programs).
  128.  
  129.  
  130. 8. Author
  131. ---------
  132. Any bug reports, wishes or comments (and some friendly words if you like this
  133. program) shoud be sent to
  134.  
  135. oliver.diedrich@uni-tuebingen.de
  136.  
  137. If you are interested, I'll send you the source code.
  138.  
  139.  
  140. 9. Thanks
  141. ---------
  142. pbiff.exe was developed with EMX 0.9b. Thanks to Eberhard Mattes for this great
  143. package (for me, emx is a major reason to use OS/2), and to all who contributed
  144. to this package. 
  145.  
  146.  
  147. 10. History
  148. -----------
  149. 3.0  First public release
  150. 3.1  Occasionally, the program crashed with an access violation. Following the
  151.      EMX documentation, _beginthread() is used instead of DosStartThread(), but
  152.      the problem was not fixed; the crash was found to be caused by a string
  153.      operation. Fixed; no more crashes since then.
  154. 3.2  When starting the program, two seconds are waited before starting the
  155.      first network access, in order to get TCP/IP intitialized when started
  156.      via startup folder.
  157. 3.3  Shame on me: I used port 109 for POP services (because this works with my
  158.      POP server), instead of looking into the literature on well-known TCP/IP
  159.      ports defining port 110 for POP services. As a consequence, the user may
  160.      enter any port number on the first program start, and the port number is
  161.      stored in the ini file. The name of the ini file changed from pbiff.ini to
  162.      pbiff33.ini, in order to allow for an upgrade without difficulties.
  163.      Thanks to Michael Moennich who reported the port number problem.
  164. 3.5  As default, pbiff asks for mail every 10 minutes (instead of 60 seconds)
  165.      The time the program waits for a successful connection is increased to 15
  166.      seconds (was 10 seconds - sometimes to short when the network is slow)
  167.      Added the -x and -y parameters to position the window anywhere on the 
  168.      screen (some people asked for this); sorry, no dragging with the mouse,
  169.      but this option is quite useful when starting the program via startup
  170.      folder or \tcpip\bin\tcpstart.cmd.