home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1997 July / PCO_07_97.ISO / filesbbs / OS2 / OS2POPS.ARJ / OS2POPS.ZIP / os2pops.INF (.txt) < prev    next >
Encoding:
OS/2 Help File  |  1997-05-08  |  295.6 KB  |  1,457 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Introduction ΓòÉΓòÉΓòÉ
  3.  
  4. This POP server was written with the administrator in mind.  Functions such as 
  5. stopping and starting the server as well as client definition and modification 
  6. are easily done through the graphical interface. The functions of the POP 
  7. server are easily monitored with the status window that is provided.  Extensive 
  8. logging is also provided to assist in problem determination if it should be 
  9. required. 
  10.  
  11. The logging of client connections as well as the number of mail items delivered 
  12. along with the actual amount of data delivered provide the framework for 
  13. reporting on the activity of your POP server.  This information also provides a 
  14. way to discover clients that may no longer be using your POP server as well as 
  15. clients who may be receiving very large amounts of data. 
  16.  
  17. OS2PopS has been in production since May 1996 serving over 3,000 clients within 
  18. IBM.  The latest information about OS2PopS may always be found on the Web at 
  19. http://www.raleigh.ibm.com/misc/os2pops 
  20.  
  21.  
  22. ΓòÉΓòÉΓòÉ 2. Copyright ΓòÉΓòÉΓòÉ
  23.  
  24. This program and the contents of the ZIP file it was contained in are 
  25. copyrighted by IBM Corporation. 
  26.  
  27. (c) Copyright IBM Corporation 1996, 1997 - All rights reserved. 
  28.  
  29.  
  30. ΓòÉΓòÉΓòÉ 3. History of Changes ΓòÉΓòÉΓòÉ
  31.  
  32.  Change History 
  33.  
  34. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  35. ΓöéDate    ΓöéVersΓöéIntΓöéDescription                                       Γöé
  36. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  37. Γöé03/31/96Γöé0.01ΓöéDJMΓöéFirst release.                                    Γöé
  38. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  39. Γöé04/14/96Γöé0.02ΓöéDJMΓöéMajor reformat of install screen. Changed INI     Γöé
  40. Γöé        Γöé    Γöé   Γöéinformation to root directories only. Each area,  Γöé
  41. Γöé        Γöé    Γöé   Γöéuser file, mail, accounting, and log, has its own Γöé
  42. Γöé        Γöé    Γöé   Γöédirectory below the server root.                  Γöé
  43. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  44. Γöé04/17/96Γöé0.03ΓöéDJMΓöéCompleted client maintenance details.             Γöé
  45. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  46. Γöé04/25/96Γöé0.04ΓöéDJMΓöéAdded data items sent and number of bytes to the  Γöé
  47. Γöé        Γöé    Γöé   Γöécontrol panel. Removed some of the messages that  Γöé
  48. Γöé        Γöé    Γöé   Γöéwere going to the status window to reduce the     Γöé
  49. Γöé        Γöé    Γöé   Γöéclutter.                                          Γöé
  50. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  51. Γöé04/26/96Γöé0.05ΓöéDJMΓöéAdded maillock empty file to a clients mail       Γöé
  52. Γöé        Γöé    Γöé   Γöédirectory when they log in to prevent the same    Γöé
  53. Γöé        Γöé    Γöé   Γöéclient from connecting a 2nd time.                Γöé
  54. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  55. Γöé04/28/96Γöé0.06ΓöéDJMΓöéAdded handling of the TOP command.                Γöé
  56. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  57. Γöé04/30/96Γöé0.07ΓöéDJMΓöéAdded checking and cleanup of lock files during   Γöé
  58. Γöé        Γöé    Γöé   Γöéinitialization.                                   Γöé
  59. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  60. Γöé05/05/96Γöé0.08ΓöéDJMΓöéMoved client counter update into a single routine Γöé
  61. Γöé        Γöé    Γöé   Γöéto make sure it's always updated correctly. Added Γöé
  62. Γöé        Γöé    Γöé   Γöéchecking to make sure the Rexx functions we need  Γöé
  63. Γöé        Γöé    Γöé   Γöéget loaded correctly (including the socket        Γöé
  64. Γöé        Γöé    Γöé   Γöéfunctions).  If they don't load correctly we'll   Γöé
  65. Γöé        Γöé    Γöé   Γöéshow an error message and die. Changed INI file   Γöé
  66. Γöé        Γöé    Γöé   Γöéfor main window position, status window position, Γöé
  67. Γöé        Γöé    Γöé   Γöéand status window colors and font to be single    Γöé
  68. Γöé        Γöé    Γöé   Γöévalues (MainPos, StatPos, StatLooks).  Changed theΓöé
  69. Γöé        Γöé    Γöé   Γöécall to VRSet for positioning the windows to a    Γöé
  70. Γöé        Γöé    Γöé   Γöésingle call instead of a call for each portion of Γöé
  71. Γöé        Γöé    Γöé   Γöéthe window positioning. Force all user IDs to     Γöé
  72. Γöé        Γöé    Γöé   Γöélower case in client maintenance when adding      Γöé
  73. Γöé        Γöé    Γöé   Γöéclients.  Forcing IDs to lower case was also done Γöé
  74. Γöé        Γöé    Γöé   Γöéin POPSMAIL to make sure things are consistent.   Γöé
  75. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  76. Γöé05/10/96Γöé0.09ΓöéDJMΓöéMinor cleanup and double check for ways the clientΓöé
  77. Γöé        Γöé    Γöé   Γöécounter could get out of sync.                    Γöé
  78. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  79. Γöé05/15/96Γöé0.0AΓöéDJMΓöéChanged our INI values to only store the root     Γöé
  80. Γöé        Γöé    Γöé   Γöédirectory to where we store things.  The rest of  Γöé
  81. Γöé        Γöé    Γöé   Γöéthe directories may be derived from the root and  Γöé
  82. Γöé        Γöé    Γöé   Γöéwe can add any we might need easily.              Γöé
  83. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  84. Γöé05/18/96Γöé0.0BΓöéDJMΓöéFixed a bug in the client interaction code that   Γöé
  85. Γöé        Γöé    Γöé   Γöéwas introduced trying to handle only linefeeds    Γöé
  86. Γöé        Γöé    Γöé   Γöéinstead of crlf from clients (like LAMPOP).       Γöé
  87. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  88. Γöé05/30/96Γöé0.0CΓöéDJMΓöéMoved report selection and generation out of this Γöé
  89. Γöé        Γöé    Γöé   Γöéprogram and made it a separate program that we    Γöé
  90. Γöé        Γöé    Γöé   Γöéstart.  This was done to avoid blocking the       Γöé
  91. Γöé        Γöé    Γöé   Γöélistening thread and the client interaction       Γöé
  92. Γöé        Γöé    Γöé   Γöéthread(s).                                        Γöé
  93. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  94. Γöé05/30/96Γöé0.0DΓöéDJMΓöéChanged Check_Directory routine to handle nested  Γöé
  95. Γöé        Γöé    Γöé   Γöédirectories since we don't prevent the user from  Γöé
  96. Γöé        Γöé    Γöé   Γöéinstalling us several directories deep.           Γöé
  97. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  98. Γöé06/17/96Γöé0.0EΓöéDJMΓöéFixed bug in Client_Maint window that was cutting Γöé
  99. Γöé        Γöé    Γöé   Γöéoff client IDs longer than 10 characters.  This   Γöé
  100. Γöé        Γöé    Γöé   Γöéwas seen when trying to delete a client ID longer Γöé
  101. Γöé        Γöé    Γöé   Γöéthan 10 characters. Fixed focus problem after     Γöé
  102. Γöé        Γöé    Γöé   Γöéadding/updating a client.  Focus was returning to Γöé
  103. Γöé        Γöé    Γöé   Γöéthe main window.                                  Γöé
  104. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  105. Γöé06/25/96Γöé0.0FΓöéDJMΓöéChanged client maint window to invisible in the   Γöé
  106. Γöé        Γöé    Γöé   Γöédesign so it doesn't "bounce" as it is being      Γöé
  107. Γöé        Γöé    Γöé   Γöépositioned. Changed client information stored in  Γöé
  108. Γöé        Γöé    Γöé   Γöéthe client. stem in order to reduce the memory    Γöé
  109. Γöé        Γöé    Γöé   Γöérequirements. We never really used the comment    Γöé
  110. Γöé        Γöé    Γöé   Γöéportion of the client information anyway.         Γöé
  111. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  112. Γöé07/07/96Γöé0.0GΓöéDJMΓöéStarted adding remote admin support.  Added 2 new Γöé
  113. Γöé        Γöé    Γöé   Γöécode files, MonP6110 and RemotAdm, as well as the Γöé
  114. Γöé        Γöé    Γöé   Γöégroundwork for adding/changing/delete admin IDs.  Γöé
  115. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  116. Γöé07/14/96Γöé0.0HΓöéDJMΓöéCompleted remote admin to the point where client  Γöé
  117. Γöé        Γöé    Γöé   Γöéadditions will work.  For now IDs and PWs are hardΓöé
  118. Γöé        Γöé    Γöé   Γöécoded here.                                       Γöé
  119. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  120. Γöé07/24/96Γöé0.0JΓöéDJMΓöéFINALLY found and fixed the problem that was      Γöé
  121. Γöé        Γöé    Γöé   Γöécausing delivery failures for some people.  Turns Γöé
  122. Γöé        Γöé    Γöé   Γöéout it was probably responsible for a lot of      Γöé
  123. Γöé        Γöé    Γöé   Γöécorruption that probably wasn't noticeable in     Γöé
  124. Γöé        Γöé    Γöé   Γöéplain text. Turned off Trace and Info logging     Γöé
  125. Γöé        Γöé    Γöé   Γöéuntil the settings notebook is completed.         Γöé
  126. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  127. Γöé07/27/96Γöé0.0KΓöéDJMΓöéAdded settings notebook for logging and pruning.  Γöé
  128. Γöé        Γöé    Γöé   ΓöéAdded registration key menu pulldown.             Γöé
  129. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  130. Γöé07/30/96Γöé0.0LΓöéDJMΓöéAdded status window clear setting to the misc     Γöé
  131. Γöé        Γöé    Γöé   Γöésettings notebook page.                           Γöé
  132. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  133. Γöé08/03/96Γöé0.0MΓöéDJMΓöéFixed a bug in the Quit routine that only showed  Γöé
  134. Γöé        Γöé    Γöé   Γöéup at installation time.  We can't try to log     Γöé
  135. Γöé        Γöé    Γöé   Γöéanything until after the installation in complete.Γöé
  136. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  137. Γöé08/11/96Γöé0.0PΓöéDJMΓöéAdded a display options page to the notebook to   Γöé
  138. Γöé        Γöé    Γöé   Γöéallow control of how much detail is shown in the  Γöé
  139. Γöé        Γöé    Γöé   Γöéstatus window.                                    Γöé
  140. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  141. Γöé08/17/96Γöé0.0QΓöéDJMΓöéChanged method of passing data to AddMLEMsg so we Γöé
  142. Γöé        Γöé    Γöé   Γöécan allow the user to choose the level of detail  Γöé
  143. Γöé        Γöé    Γöé   Γöéthey want displayed. Changed client abnormal      Γöé
  144. Γöé        Γöé    Γöé   Γöédisconnect messages to W (warning) level instead  Γöé
  145. Γöé        Γöé    Γöé   Γöéof error.                                         Γöé
  146. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  147. Γöé08/20/96Γöé0.0RΓöéDJMΓöéFixed buglet that was causing the display options Γöé
  148. Γöé        Γöé    Γöé   Γöéto be "forgotten" and not displayed again after   Γöé
  149. Γöé        Γöé    Γöé   Γöéthe NB had been closed. Fixed error handling in   Γöé
  150. Γöé        Γöé    Γöé   Γöéregistration screen that would cause the          Γöé
  151. Γöé        Γöé    Γöé   Γöéregistration screen to be closed if an invalid    Γöé
  152. Γöé        Γöé    Γöé   Γöécombo of name and key was entered.                Γöé
  153. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  154. Γöé08/27/96Γöé0.0SΓöéDJMΓöéFixed a typo in the Add_Client routine.  It was   Γöé
  155. Γöé        Γöé    Γöé   Γöécalling the wrong error routine if a problem was  Γöé
  156. Γöé        Γöé    Γöé   Γöéfound while updating the user file.               Γöé
  157. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  158. Γöé08/31/96Γöé0.0TΓöéDJMΓöéChanged main window saving and positioning to onlyΓöé
  159. Γöé        Γöé    Γöé   Γöéuse the Top and Left values since the window can'tΓöé
  160. Γöé        Γöé    Γöé   Γöébe sized. Added silent saving of the positions of Γöé
  161. Γöé        Γöé    Γöé   Γöéthe client maint and client details windows. MovedΓöé
  162. Γöé        Γöé    Γöé   Γöéretrieval of the physcial screen size into the    Γöé
  163. Γöé        Γöé    Γöé   ΓöéINIT routine so we only have to do it once. Added Γöé
  164. Γöé        Γöé    Γöé   Γöémenu items to the Control pulldown to show/hide   Γöé
  165. Γöé        Γöé    Γöé   Γöéthe status window.                                Γöé
  166. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  167. Γöé09/30/96Γöé1.00ΓöéDJMΓöéFinal cleanup for release.                        Γöé
  168. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  169. Γöé10/13/96Γöé1.01ΓöéDJMΓöéRemoved registration screen and defaulted to an   Γöé
  170. Γöé        Γöé    Γöé   Γöéunlimited number of clients for OS2TOOLS. Added   Γöé
  171. Γöé        Γöé    Γöé   Γöéwarning and cautions to the sendmail.cf help so   Γöé
  172. Γöé        Γöé    Γöé   Γöépeople don't accidently destroy the tabs in       Γöé
  173. Γöé        Γöé    Γöé   Γöésendmail.cf.                                      Γöé
  174. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  175. Γöé11/04/96Γöé1.02ΓöéDJMΓöéContinued work with remote admin support.         Γöé
  176. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  177. Γöé11/16/96Γöé1.03ΓöéDJMΓöéAdded stripping and space(0) to client values thatΓöé
  178. Γöé        Γöé    Γöé   Γöéare retrieved during client maintenance. Removed  Γöé
  179. Γöé        Γöé    Γöé   Γöéextra spaces in the window list titles that we    Γöé
  180. Γöé        Γöé    Γöé   Γöépresent for various components.                   Γöé
  181. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  182. Γöé11/29/96Γöé1.04ΓöéDJMΓöéFixed bug in the variable that was added to       Γöé
  183. Γöé        Γöé    Γöé   Γöéconfig.sys when installing.  Instead of just the  Γöé
  184. Γöé        Γöé    Γöé   Γöédrive and path the entire name of the INI file wasΓöé
  185. Γöé        Γöé    Γöé   Γöébeing added (incorrectly).  This caused us to     Γöé
  186. Γöé        Γöé    Γöé   Γöéthink we hadn't been installed when in fact we    Γöé
  187. Γöé        Γöé    Γöé   Γöéhad. Fixed a bug in detecting whether or not the  Γöé
  188. Γöé        Γöé    Γöé   ΓöéRXSock DLL was available and the socket functions Γöé
  189. Γöé        Γöé    Γöé   Γöéwere loaded without error (if they weren't        Γöé
  190. Γöé        Γöé    Γöé   Γöéalready).                                         Γöé
  191. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  192.  
  193.  
  194. ΓòÉΓòÉΓòÉ 4. Why OS2PopS? ΓòÉΓòÉΓòÉ
  195.  
  196. Some of you may be wondering why you should try OS2PopS instead of one of the 
  197. other POP servers that are available.  Here are some of the reasons we think 
  198. you should give it a try and why we think you will like it. 
  199.  
  200.      Production proven - in use since May of 1996 serving over 3,000 clients 
  201.  
  202.      Ease of administration - all administrative chores are presented with a 
  203.       graphical interface with ease of use a top priority 
  204.  
  205.      Experience - 15 years of experience with Rexx resulting in optimal coding 
  206.       for the speed which is critical for a POP server 
  207.  
  208.  Once you have given OS2PopS a test drive we are sure you will be pleased.  If 
  209.  you have any questions, comments, concerns, or problems please let us know. 
  210.  You may reach us by E-Mail by writing to djm@raleigh.ibm.com or by visiting 
  211.  the OS2PopS Web page at http://www.raleigh.ibm.com/misc/os2pops 
  212.  
  213.  
  214. ΓòÉΓòÉΓòÉ 5. Requirements ΓòÉΓòÉΓòÉ
  215.  
  216. The OS2PopS POP server has no special hardware requirements but we'll try to 
  217. provide some guidance on what you will need in the Hardware section.  There are 
  218. some software requirements though so we'll give you the information you will 
  219. need in the Software section. 
  220.  
  221. Important Note! Installation of the OS2PopS POP server assumes that you have 
  222. installed and configured your system, including TCP/IP, before you install and 
  223. use OS2PopS. 
  224.  
  225. Of particular importance is the configuration of sendmail and the sendmail.cf 
  226. configuration file for Sendmail. 
  227.  
  228.  
  229. ΓòÉΓòÉΓòÉ 5.1. Hardware ΓòÉΓòÉΓòÉ
  230.  
  231. There are no hard and fast rules when it comes to choosing what hardware to use 
  232. for your OS2PopS POP server.  Obviously the more clients you plan on supporting 
  233. the more powerful a machine you will need. 
  234.  
  235. The 2 things that will contribute most to having a server that is fast enough 
  236. to respond to your clients requests are memory and disk.  The amount of memory 
  237. available and the "speed" of your disks drives will have the most impact on the 
  238. service your clients receive. 
  239.  
  240. You should consider, at a minimum, a machine with the following 
  241. characteristics: 
  242.  
  243.      60 Mhz Pentium class CPU 
  244.  
  245.      16 megabytes of memory 
  246.  
  247.      1 gigabyte SCSI disk drive 
  248.  
  249.      Network adapter card or modem for connectivity 
  250.  
  251.  Memory 
  252.  
  253.  Let's talk about memory first.  If you are planning on having only a few 
  254.  clients, say 10 or less, you can probably get away with only 16 megabytes of 
  255.  memory.  Of course more is always better. 
  256.  
  257.  Any more than 10 clients and you'll want to consider 32 megabytes as the 
  258.  minimum.  Our server with 500+ clients handles them just fine with 32 meg of 
  259.  memory.  As always, if you can afford to have more do it. 
  260.  
  261.  If you will have more than 1,000 clients consider 64 megabytes of memory the 
  262.  minimum.  And, at the risk of being repetitive, more is always better. 
  263.  
  264.  Disk Drives 
  265.  
  266.  The capacity of the disk drives you choose is not as important as the average 
  267.  access time of the disk drives.  The lower the number the better.  The fastest 
  268.  drives you will find are SCSI drives which are available in a dizzying array 
  269.  of sizes and access times. 
  270.  
  271.  Look for disk drives that provide 8 to 10 millisecond average access times 
  272.  with 8 or 8.5 being ideal.  You will find that the access times start going up 
  273.  when you get above 4 gigabyte sizes so stick with those that are 4 gig or less 
  274.  in size. 
  275.  
  276.  If you can afford it, use a system with 2 separate disk drives.  The first 
  277.  one, the boot drive, only needs to be 500 megabytes or so since it will 
  278.  contain only OS/2 and supporting software such as TCP/IP. 
  279.  
  280.  The 2nd drive should be as large as you anticipate you will need to hold your 
  281.  clients data.  There is no way to predict that x number of clients will need y 
  282.  amount of disk space so, at best, the size of this 2nd disk is a judgement 
  283.  call. 
  284.  
  285.  Our server provides service for 500+ clients with only 650 megabytes of disk 
  286.  space.  If your clients may be sending or receiving large files, such as disk 
  287.  images, that amount of space might not be enough. 
  288.  
  289.  Be very generous with disk space.  Go for at least a 2 gigabyte or larger 
  290.  drive.  With a single SCSI disk controller you will be able to support a total 
  291.  of 7 devices so you should be able to grow easily. 
  292.  
  293.  There are other options available that can provide large disk "images" by 
  294.  presenting multiple disk drives as a single very large disk drive to the 
  295.  operating system.  There is nothing in OS2PopS that would prevent them from 
  296.  being used. 
  297.  
  298.  You have probably noticed that we haven't mentioned IDE disk drives at all so 
  299.  far.  Although they will work just fine for your OS2PopS POP server, their 
  300.  access times are usually slower than SCSI disk drives and we don't recommend 
  301.  them if you will have more than a few clients. 
  302.  
  303.  The CPU 
  304.  
  305.  The CPU is close behind memory and disk drives in importance.  Even with just 
  306.  a few clients a 60 Mhz Pentium class machine should be considered the minimum. 
  307.  If you anticipate a lot of traffic and/or a large number of clients step up to 
  308.  a 133 Mhz or better machine. 
  309.  
  310.  Miscellaneous 
  311.  
  312.   The type of display you use does not matter to the OS2PopS POP server.  The 
  313.  main control panel and status panel will fit just fine on a screen running at 
  314.  VGA resolution. 
  315.  
  316.  Other than the display you will need some type of connection to a network 
  317.  whether it be within your company or a direct connection to the Internet.  We 
  318.  can't possibly try to explain all of the options you might have available in 
  319.  this area so just make sure you have some sort of network card or modem to 
  320.  connect to "a network". 
  321.  
  322.  
  323. ΓòÉΓòÉΓòÉ 5.2. Software ΓòÉΓòÉΓòÉ
  324.  
  325. The minimum software requirements for OS2PopS are: 
  326.  
  327.      OS/2 Warp Connect 
  328.  
  329.      The VROBJ.DLL revision level D or higher 
  330.  
  331.      TCP/IP version 3 
  332.  
  333.      Software to support your network card or modem connection 
  334.  
  335.  The VROBJ.DLL must be at revision level D or higher or OS2PopS will not work 
  336.  correctly.  You will need to install the DLL, which is provided in the OS2PopS 
  337.  ZIP file, in a directory that is in your LIBPATH.  If you have Warp Connect 
  338.  installed you may find an older level of the DLL in the \grpware directory on 
  339.  your boot drive. 
  340.  
  341.  If you have an older version of VROBJ.DLL in your \grpware directory you will 
  342.  have to replace it with the version supplied in the OS2PopS ZIP file.  If any 
  343.  program you use has called functions in the DLL since you last booted the DLL 
  344.  will be "locked" and you will not be able to replace it without rebooting. 
  345.  
  346.  If you have to reboot to install a new VROBJ.DLL use Alt-F1 when the little 
  347.  white square appears in the upper lefthand corner of your screen.  Select "C" 
  348.  from the list of options that will be displayed and you will be presented with 
  349.  an OS/2 full screen session.  Change to the \grpware directory on your boot 
  350.  drive and replace the copy of VROBJ.DLL. 
  351.  
  352.  
  353. ΓòÉΓòÉΓòÉ 6. Installation ΓòÉΓòÉΓòÉ
  354.  
  355. You may install the OS2PopS POP server code on any HPFS formatted drive on your 
  356. system.  You may install it in any directory name you'd like but we recommend 
  357. using OS2PopS so it is easily identified. 
  358.  
  359. The following installation topics will provide more details about installing 
  360. OS2PopS. 
  361.  
  362. Contents of the ZIP file 
  363.  
  364. Where should I install OS2PopS? 
  365.  
  366. The installation screen 
  367.  
  368. SENDMAIL 
  369.  
  370. sendmail.cf 
  371.  
  372. PopSMail 
  373.  
  374. Why is HPFS required? 
  375.  
  376.  
  377. ΓòÉΓòÉΓòÉ 6.1. Contents of the ZIP file ΓòÉΓòÉΓòÉ
  378.  
  379. The OS2PopS distribution ZIP file should contain the following files: 
  380.  
  381.      ReadMe.1st - brief how to get OS2PopS installed instructions 
  382.  
  383.      License.TXT - IBM License Agreement 
  384.  
  385.      OS2POPS.ABS - OS2PopS abstract 
  386.  
  387.      OS2POPS.EXE - the main program 
  388.  
  389.      OS2POPS.ICO - the OS2PopS icon 
  390.  
  391.      VROBJ.DLL - VXRexx support DLL 
  392.  
  393.      RXMD5.DLL - DLL to support MD5 encoding (for APOP and remote admin) 
  394.  
  395.      OS2POPS.INF - this on-line document 
  396.  
  397.      OS2POPS.HLP - help on demand in OS2PopS 
  398.  
  399.      POPSMAIL.EXE - the sendmail "endmailer" 
  400.  
  401.      POPSRPTR.EXE - the OS2PopS report program 
  402.  
  403.      POPSRPTR.ICO - the OS2PopS report program icon 
  404.  
  405.      POPRADM.ZIP - the OS2PopS remote administration package 
  406.  
  407.      WEBREG.CMDSAMPLE - sample CMD file for registering people to a OS2PopS 
  408.       POP server via the Web (using GoServe as the Web server) 
  409.  
  410.      SENDMAIL.ZIP - a copy of version 2.01 sendmail for OS/2 
  411.  
  412.  
  413. ΓòÉΓòÉΓòÉ 6.2. Where should I install OS2PopS? ΓòÉΓòÉΓòÉ
  414.  
  415. Although it doesn't really matter where you install the OS2PopS POP server 
  416. code, we highly recommend putting it into a directory named OS2PopS.  This 
  417. makes it easier to identify and find.  The only requirement OS2PopS has is that 
  418. it MUST be installed on a drive that has been formatted with HPFS. See Why is 
  419. HPFS required? for details on why an HPFS formatted drive is required. 
  420.  
  421. The other thing you need to consider is how many clients you anticipate having. 
  422. The amount of disk space you will need is, in part, based on the number of 
  423. clients.  As mentioned in the Introduction, the OS2PopS POP server has been in 
  424. production serving over 800 clients.  The server and client mail store is on a 
  425. partitioned 1 gigabyte disk drive with approximently 650 megabytes of space 
  426. available. 
  427.  
  428. As mail is received by OS2PopS, and then retrieved by your clients, the amount 
  429. of disk space available will vary constantly.  You will want to be VERY 
  430. generous with disk space so you don't run short.  We estimate that the 650 
  431. megabytes we have with 500 clients today should be able to support at least 
  432. another 500, for a total of 1000 clients, before we'll need to consider 
  433. additional disk space. 
  434.  
  435. Of course there are no hard and fast rules nor anything preventing your clients 
  436. from receiving multi-megabyte files so the best advice is to keep an eye on the 
  437. amount of disk space remaining. 
  438.  
  439.  
  440. ΓòÉΓòÉΓòÉ 6.3. The installation screen ΓòÉΓòÉΓòÉ
  441.  
  442. This is the first screen that OS2PopS will display if you have never installed 
  443. OS2PopS before.  Detailed information about the fields displayed my be found 
  444. here. 
  445.  
  446.  
  447. ΓòÉΓòÉΓòÉ 6.4. Installation screen details ΓòÉΓòÉΓòÉ
  448.  
  449. The first time OS2PopS is started it will not be able to find its INI file and 
  450. will assume that you are installing OS2PopS for the first time.  The 
  451. installation screen contains some brief information about where you might want 
  452. to install OS2PopS followed by several choices you will need to make regarding 
  453. the installation. 
  454.  
  455. The first thing you must decide is where you want OS2PopS to store its INI 
  456. file.  The INI file is used to store the OS2PopS root directory, the positions 
  457. of the main control panel and status panel on the screen, and several other 
  458. pieces of information.  Details of what the INI file contains may be found 
  459. here. 
  460.  
  461. OS2PopS will, by default, look for its INI file in the following locations in 
  462. the order shown before giving up and deciding that an INI file is not 
  463. available: 
  464.  
  465.    1. The directory pointed to by the ETC variable in config.sys 
  466.  
  467.    2. The directory pointed to by the OS2PopS variable in config.sys 
  468.  
  469.    3. The OS/2 user INI file - OS2.INI (application name OS2PopS) 
  470.  
  471.  The ETC variable 
  472.  
  473.  When TCP/IP or MPTS is installed, the ETC directory will be created.  The 
  474.  location of this directory is defined by the ETC variable that is added to 
  475.  config.sys.  You may find out where your ETC directory is by issuing SET ETC 
  476.  in an OS/2 window.  OS2PopS will default to using the ETC directory for its 
  477.  INI file since using it does not require a reboot of the machine after OS2PopS 
  478.  is installed.  The ETC directory is also one of the directories that should be 
  479.  backed up on a regular basis. 
  480.  
  481.  The OS2PopS variable 
  482.  
  483.  You may choose to have OS2PopS store its INI file in its own directory instead 
  484.  of the ETC directory.  If you choose this option your config.sys will be 
  485.  updated and you will need to reboot to pick up the change.  Note however that 
  486.  OS2PopS will start and run 1 time without a reboot. 
  487.  
  488.  If this option is choosen the single line that will be added to your 
  489.  config.sys (at the very bottom) is: 
  490.  
  491.   SET OS2PopS=D:\OS2POPS\
  492.  
  493.  Of course the drive and directory will depend on where you choose to install 
  494.  OS2PopS. 
  495.  
  496.  The OS/2 INI file 
  497.  
  498.  If you don't mind an application such as OS2PopS updating the OS/2 user INI 
  499.  file, OS2.INI, choose this option and OS2PopS will store the location of its 
  500.  INI file there.  It will be stored under the application name OS2PopS with a 
  501.  single key named "INILoc".  The INILoc key will contain the location of the 
  502.  OS2PopS INI file. 
  503.  
  504.  OS2PopS INI location 
  505.  
  506.  If you decide to store the OS2PopS INI file in the OS2PopS directory the 
  507.  OS2PopS INI location input field will be enabled.  You may store the OS2PopS 
  508.  INI file on any HPFS drive on your system.  We strongly suggest that you 
  509.  choose to store it in the same place as the rest of the OS2PopS POP server. 
  510.  
  511.  Enter the INI file location in the format: 
  512.  
  513.   drive:\directory\
  514.  
  515.  OS2PopS root location 
  516.  
  517.  The OS2PopS root location is key to the operation of OS2PopS.  All of your 
  518.  client mail, the user file with your client information, log files, and 
  519.  accounting files will all be stored in directories below the directory you 
  520.  specify here.  You will want to make sure that the drive you choose will have 
  521.  enough space. 
  522.  
  523.  Enter the OS2PopS root location in the format: 
  524.  
  525.   drive:\directory\
  526.  
  527.  By default this field will contain the drive and directory where you started 
  528.  OS2PopS for the first time. 
  529.  
  530.  After you have made your choices clicking on the green bar at the bottom of 
  531.  the installation screen will cause OS2PopS to build all of the necessary 
  532.  directories and files and create its INI file.  Once these things are done it 
  533.  will start running and be ready to accept client connections. 
  534.  
  535.  If you decide not to install OS2PopS click on the red bar at the bottom of the 
  536.  window.  Cancelling the installion of OS2PopS will prevent any directories or 
  537.  files from being created. 
  538.  
  539.  
  540. ΓòÉΓòÉΓòÉ 6.5. SENDMAIL ΓòÉΓòÉΓòÉ
  541.  
  542. We won't attempt to explain what the sendmail program does here because it 
  543. would take a large book all by itself.  The installation of OS2PopS assumes 
  544. that you already have TCP/IP installed and configured and that sendmail is 
  545. functioning properly.  You should have sendmail being started automatically by 
  546. TCPSTART which is usually shadowed out of the TCP/IP folder into the STARTUP 
  547. folder. 
  548.  
  549. The OS2PopS POP server receives mail via sendmail by modifying the Mlocal line 
  550. in your existing sendmail.cf.  What it does is add an endmailer that actually 
  551. receives the data from the sendmail program and puts it into the directory of 
  552. the client it is addressed to. 
  553.  
  554. The Mlocal line in sendmail.cf allows additional arguments to be passed to the 
  555. endmailer.  For OS2PopS we pass the endmailer the OS2PopS root directory, the 
  556. user name that the mail item is addressed to, and the address that the mail is 
  557. arriving from as arguments. The OS2PopS root directory is a hard coded value 
  558. that is inserted on the Mlocal line in sendmail.cf. 
  559.  
  560. As mentioned above, you will want to make sure sendmail is being started by 
  561. TCPSTART.  You also need to make sure that it is using sendmail.cf and not 
  562. sendmail.uml (the sendmail configuration for the UltiMail product).  The 
  563. easiest way to find out which sendmail configuration is being used is to edit 
  564. the TCPSTART.CMD file you'll find in your \tcpip\bin directory. If you have 
  565. TCPSTART starting sendmail you should see a line like this: 
  566.  
  567. start sendmail -bd -q30m -CD:\mptn\etc\sendmail.uml
  568.  
  569. What is wrong with the example above is that the sendmail configuration program 
  570. that will be used is sendmail.uml and not sendmail.cf.  You may either change 
  571. sendmail.uml to sendmail.cf or remove the -C parameter completely.  By default 
  572. sendmail will look for and read sendmail.cf in the etc directory. 
  573.  
  574. You'll find more information about the OS2PopS endmailer PopSMail here. 
  575.  
  576.  
  577. ΓòÉΓòÉΓòÉ 6.6. sendmail.cf ΓòÉΓòÉΓòÉ
  578.  
  579. CAUTION:
  580. Always make a backup copy of sendmail.cf before you attempt to modify it. 
  581. After modifying sendmail.cf compare its size to the backup copy you made.  They 
  582. should be within a dozen or so bytes of each other (+/- 25%). 
  583.  
  584. Warning: The sendmail.cf file contains embedded tab characters.  Do NOT use an 
  585. editor that will expand tabs or you will render sendmail.cf useless. 
  586.  
  587. Warning: Running the TCP/IP configuration program may overwrite your 
  588. sendmail.cf file.  Always make a backup copy of sendmail.cf before opening the 
  589. TCP/IP configuration program. 
  590.  
  591. Note:  The "E" editor, not EPM, should edit sendmail.cf without modifying the 
  592. tab characters. 
  593.  
  594. The sendmail.cf file can be very intimidating at first glance.  The sendmail 
  595. program is very powerful and a lot of its flexability is controlled by 
  596. sendmail.cf.  The only part of sendmail.cf we will discuss here is the Mlocal 
  597. line since every sendmail.cf file will have one. 
  598.  
  599. As we have already mentioned, the PopSMail endmailer is specified on the Mlocal 
  600. line in sendmail.cf.  The Mlocal line needs the full path to where it will find 
  601. PopSMail in order for things to work. 
  602.  
  603. This is the working Mlocal line from the sendmail.cf file that we use: 
  604.  
  605. Mlocal, P=f:\os2pops\popsmail.exe, F=lsDFP, S=10, R=20, A=f:\os2pops $u $f
  606.  
  607. In order for sendmail to find the PopSMail endmailer the full path to PopSMail 
  608. along with PopSMail.exe must be specified immediately following the P= as shown 
  609. above.  The 3 pieces of information that PopSMail needs in order to function 
  610. properly are the OS2PopS root directory, the user name the mail is destined 
  611. for, and the address the mail was received from. 
  612.  
  613. The letters following F= are flags that tell sendmail what kind of endmailer 
  614. PopSMail is along with other things.  You will probably want to use the letters 
  615. as shown in the example.  For the purposes of this document you may ignore the 
  616. S= and R= portions of the Mlocal line. 
  617.  
  618. The data after the A= are the parameters that are passed to the endmailer 
  619. (PopSMail in our case).  As you can see, the first parameter is the location of 
  620. the OS2PopS root directory.  The 2nd parameter, the user name the mail is 
  621. destined for, is passed with $u which is a sendmail variable that will contain 
  622. the user name the mail is destined for. 
  623.  
  624. The 3rd and final parameter is the address the mail was received from.  This is 
  625. passed to PopSMail by using the $f sendmail variable.  The 2 sendmail 
  626. variables, $u and $f, should be found in just about every sendmail.cf file.  If 
  627. the $f variable is not set for some reason it will not cause PopSMail any 
  628. problems. 
  629.  
  630.  
  631. ΓòÉΓòÉΓòÉ 6.7. PopSMail ΓòÉΓòÉΓòÉ
  632.  
  633. PopSMail is the OS2PopS endmailer that receives the mail from sendmail and 
  634. delivers it to the correct client directory for retrieval by the client.  Since 
  635. PopSMail does not "speak" SMTP it is very simple.  PopSMail only requires 3 
  636. things in order for it to function correctly.  The 3 things are: 
  637.  
  638.       The OS2PopS root directory 
  639.       The user name the mail is destined for 
  640.       The address the mail was received from 
  641.  
  642.  These parameters are passed to it by sendmail. 
  643.  
  644.  With the user name and OS2PopS root directory PopSMail can find the OS2PopS 
  645.  user file, examine it, and make sure the user name is a known POP client.  If 
  646.  the user is a POP client the mail that PopSMail received is placed into the 
  647.  proper directory.  If the user is NOT a POP client the mail is deposited in 
  648.  the mail directory for the default POP client known as nobody. 
  649.  
  650.  Each file that PopSMail creates will have a unique name.  The file name is the 
  651.  date, in yyyymmdd format, that the mail was received and processed by 
  652.  PopSMail.  The file extension is the time in hhmmssuu which almost guarantees 
  653.  that every file received will have a unique file name.  A file name created by 
  654.  PopSMail might look like this: 
  655.  
  656.    19950521.07353903
  657.  
  658.  
  659. ΓòÉΓòÉΓòÉ 6.8. Why is HPFS required? ΓòÉΓòÉΓòÉ
  660.  
  661. The OS2PopS POP server must be installed on an HPFS formatted drive for 2 
  662. primary reasons. 
  663.  
  664.      Performance 
  665.  
  666.      Easier file naming 
  667.  
  668.  Performance is the main reason HPFS is required.  Due to the "sparse" nature 
  669.  of files in HPFS the read/write head in the disk drive usually doesn't need to 
  670.  travel as far to read or write a given amount of information.  For a POP 
  671.  server that may be receiving data while delivering data to multiple clients 
  672.  this speed "boost" is essential. The FAT file system on the other hand 
  673.  requires the read/write head to travel to a specific area of the disk every 
  674.  time a file is written, read, or erased.  This additional movement can cause a 
  675.  noticeable difference on a POP server. 
  676.  
  677.  Keep in mind that OS2PopS will be receiving and delivering hundreds, if not 
  678.  thousands, of mail items every day all day.  Each of those operations involves 
  679.  at least several disk accesses.  Without HPFS the additional overhead of FAT 
  680.  makes it impractical for a POP server. 
  681.  
  682.  Easier file naming simply means that OS2PopS can create file names for mail 
  683.  items that are received with long names that uniquely identify each piece of 
  684.  mail for each client.  It also allows the logging and accounting files that 
  685.  OS2PopS maintains to have file extensions that correspond to the date the 
  686.  logging or accounting takes place. 
  687.  
  688.  On the "back end" these naming schemes allow data to be gathered easily and a 
  689.  variety of reports to be built detailing every facet of your OS2PopS POP 
  690.  server installation. 
  691.  
  692.  One additional benefit for received mail is that the naming scheme inserts 
  693.  mail items into a clients directory so they will always be delivered to the 
  694.  client in the order they were received. 
  695.  
  696.  
  697. ΓòÉΓòÉΓòÉ 7. Day-to-Day operation of OS2PopS ΓòÉΓòÉΓòÉ
  698.  
  699. We think you will find that OS2PopS pretty much takes care of itself.  There is 
  700. nothing you have to do with it on a daily basis.  If you run with it minmized 
  701. you may even forget that it is running! 
  702.  
  703. Most of the administrative interaction with OS2PopS will be adding, modifying, 
  704. and deleting clients and OS2PopS provides a simple, easy to use, graphical 
  705. interface for those tasks.  We have broken each of the functions available into 
  706. separate sections to make it easier to find what you are looking for. 
  707.  
  708. The OS2PopS Main Control panel 
  709.  
  710. Client Maintenance 
  711.  
  712. The OS2PopS Main Control panel pulldown menus 
  713.  
  714. The OS2PopS Status window 
  715.  
  716.  
  717. ΓòÉΓòÉΓòÉ 7.1. The OS2PopS Main Control panel ΓòÉΓòÉΓòÉ
  718.  
  719. This is the main control panel for OS2PopS.  With this panel alone you may 
  720. easily monitor, on an ongoing basis, the status of your OS2PopS POP server. 
  721.  
  722.  After explaining what you'll find available on the main control panel we'll 
  723. provide the details on each of the options available on the pulldown menus in 
  724. the next section. 
  725.  
  726.       Server Is - Will contain the word Active when OS2PopS is listening for 
  727.       client connections on port 110.  When the server is stopped the border 
  728.       will be red and Active will read Halted. When the server is halted no 
  729.       clients will be able to connect and retrieve mail. 
  730.  
  731.       Clicking on the word Active or Halted will toggle the state of the 
  732.       server. 
  733.  
  734.       Clients Connected - This is the actual number of clients that are 
  735.       currently having a "conversation" with the OS2PopS POP server. 
  736.  
  737.       The "slider" under the Clients Connected heading will graphically show 
  738.       you how many clients are connected to the OS2PopS POP server at any 
  739.       instant.  When there are 1-14 clients connected the display will be 
  740.       green.  When there are 15-19 clients connected the display will be 
  741.       yellow.  If there are 20 or more clients connected at the same time the 
  742.       display will be red. 
  743.  
  744.       Mail Items Delivered - How many individual pieces of mail have been 
  745.       delivered to all clients since the last time OS2PopS was started. 
  746.       Overall totals are safely stored in log files. 
  747.  
  748.       Client Maintenance - Brings up the Client Maintenance window which allows 
  749.       you to add, delete, or modify your clients information. 
  750.  
  751.  
  752. ΓòÉΓòÉΓòÉ 7.2. Client Maintenance ΓòÉΓòÉΓòÉ
  753.  
  754. When the Client Maint button is pushed on the OS2PopS main control panel the 
  755. panel shown below will be displayed. 
  756.  
  757. From this panel you may add new clients, modify existing clients, and delete 
  758. clients. When a client is selected modify will allow you to change the password 
  759. for that client as well as the comment field associated with that client. 
  760.  
  761. You will not be able to delete the nobody or postmaster entries but any other 
  762. client that is selected may be deleted by pressing the Delete button.  You will 
  763. be asked to confirm that you want to delete the client before the directory, 
  764. and any mail that may have been waiting, for the client is deleted and the 
  765. client entry removed from the user file. 
  766.  
  767. Whether you are adding a new client or modifying an existing client the client 
  768. details window will be displayed after the Modify or Add button is pressed. 
  769.  
  770. The fields and buttons on the client details panel should be pretty self 
  771. explanatory.  If the cancel button is pressed no changes are made to the client 
  772. entry (or a new client is not added).  The modify (or add) button will cause an 
  773. update to be made as required. 
  774.  
  775. Once you modify/add a client or cancel this panel you will be returned to the 
  776. client maintenance panel. 
  777.  
  778.  
  779. ΓòÉΓòÉΓòÉ 7.3. The OS2PopS Main Control panel pulldown menus ΓòÉΓòÉΓòÉ
  780.  
  781. Shown below are the pulldown menus available on the main control panel. 
  782.  
  783. The Options pulldown menu 
  784.  
  785. The Control pulldown menu 
  786.  
  787. The Help pulldown menu 
  788.  
  789.  
  790. ΓòÉΓòÉΓòÉ 7.3.1. The Options pulldown menu ΓòÉΓòÉΓòÉ
  791.  
  792.       Save Control Window Position - selecting this option will store the 
  793.       current position of the control window.  The next time OS2PopS is started 
  794.       the control window will be restored to this position. 
  795.  
  796.       Settings - selecting this option will display the settings notebook which 
  797.       allows you to define what options you'd like OS2PopS to use.  You may 
  798.       select a notebook page below for mores details. 
  799.  
  800.       Logging Options 
  801.       Display Options 
  802.       Pruning Options 
  803.       Miscellaneous Options 
  804.       Remote Admin Options 
  805.  
  806.       Run Reports - This option will start the PopSRptr program to allow you to 
  807.       run reports detailing information about your OS2PopS POP server. 
  808.  
  809.       Exit - Kills any client threads that may be active and stops OS2PopS. 
  810.       Unlike the Active/Halted button on the Main Control Panel Exit will 
  811.       disconnect any clients that may be connected and exit the OS2PopS 
  812.       program. 
  813.  
  814.  
  815. ΓòÉΓòÉΓòÉ 7.3.1.1. Logging Options Notebook Page ΓòÉΓòÉΓòÉ
  816.  
  817. The logging options notebook page allows you to select the amount of detailed 
  818. information OS2PopS should log.  By default the maximum amount of logging is 
  819. enabled. 
  820.  
  821.  
  822. ΓòÉΓòÉΓòÉ 7.3.1.2. Display Options Notebook Page ΓòÉΓòÉΓòÉ
  823.  
  824. The display options allow you to control how much detail is shown in the status 
  825. window.  By default only client connections will be shown in the status window. 
  826.  
  827.  
  828. ΓòÉΓòÉΓòÉ 7.3.1.3. Pruning Options Notebook Page ΓòÉΓòÉΓòÉ
  829.  
  830. The pruning options page allows you to select how long information that has 
  831. been logged should be retained. 
  832.  
  833. Pruning has not been enabled yet. 
  834.  
  835.  
  836. ΓòÉΓòÉΓòÉ 7.3.1.4. Misellaneous Options Notebook Page ΓòÉΓòÉΓòÉ
  837.  
  838.       Clear Status Window - allows you to specify how much time, in minutes, 
  839.       between status window clears.  Possible values are 5, 10, 15, 20, 30, 45, 
  840.       60, 90, 120, 150, 180 minutes. 
  841.  
  842.       Enforce Minimum Password Length - allows enforcement of a minimum 
  843.       password length when adding or modifying clients directly on the server. 
  844.       Values between 1 and 50 are allowed.  Enforcement of the minimum length 
  845.       is NOT available with remote administration. 
  846.  
  847.       TCP/IP host name of this machine - for remote admin and support for the 
  848.       APOP client command to work OS2PopS must be able to determine its own 
  849.       TCP/IP host name.  If, for some reason, it is unable to determine the 
  850.       name using standard TCP/IP calls completing this field will allow remote 
  851.       admin and APOP support to still function. 
  852.  
  853.       The fully qualified host name should be entered as shown in the example. 
  854.  
  855.  
  856. ΓòÉΓòÉΓòÉ 7.3.1.5. Remote Admin Notebook Page ΓòÉΓòÉΓòÉ
  857.  
  858.       Enable remote administration - when this checkbox is selected remote 
  859.       administration will be enabled.  At least one remote administrator must 
  860.       be defined for remote administration to work. 
  861.  
  862.       Add - selecting Add allows you to define a new remote administrator ID 
  863.  
  864.       Modify - selecting Modify allows you to modify the password or general 
  865.       information associated with a remote administrator ID that is already 
  866.       defined 
  867.  
  868.       Delete - selecting Delete will remove the selected remote administrator 
  869.       ID 
  870.  
  871.  
  872. ΓòÉΓòÉΓòÉ 7.3.2. The Control pulldown menu ΓòÉΓòÉΓòÉ
  873.  
  874.       Start Server - This option will be enabled when OS2PopS has been stopped. 
  875.       Otherwise it will be disabled.  When enabled Start Server will cause 
  876.       OS2PopS to start listening on POP port 110.  This means that clients will 
  877.       be able to connect to OS2PopS 
  878.  
  879.       Stop Server - This option will be enabled when OS2PopS is running 
  880.       (started).  Otherwise it will be disabled.  When enabled Stop Server will 
  881.       cause OS2PopS to stop listening on POP port 110.  This means that no 
  882.       clients will be able to connect to OS2PopS 
  883.  
  884.       Reset Counters - Resets the "Mail Items Delivered" counter on the main 
  885.       control panel to zero.  This does not affect what data will be available 
  886.       for reporting. 
  887.  
  888.       Show Client Count - OS2PopS will display the number of clients defined in 
  889.       the status window. 
  890.  
  891.  
  892. ΓòÉΓòÉΓòÉ 7.3.3. The Help pulldown menu ΓòÉΓòÉΓòÉ
  893.  
  894.       Help - Displays this INF file. 
  895.  
  896.       Product Information - Shows the IBM Corporation address where you may 
  897.       contact us along with the copyright statement.  This is what the Product 
  898.       Information panel looks like: 
  899.  
  900.  
  901. ΓòÉΓòÉΓòÉ 7.4. The OS2PopS Status window ΓòÉΓòÉΓòÉ
  902.  
  903. The OS2PopS status window is a simple MLE (multi line entry field) that is 
  904. write protected.  The OS2PopS POP server will display various messages in this 
  905. window as clients connect and disconnect.  Unexpected conditions, such as a 
  906. client disconnecting in the middle of a conversation, will also be displayed. 
  907.  
  908. By default the status window will be cleared every 30 minutes.  When the status 
  909. window is cleared the IBM Corporation copyright will be displayed followed by 
  910. the version number of OS2PopS that is being used and then a count of how many 
  911. clients have been defined. 
  912.  
  913. The status window clearing delay may be changed on the Miscellaneous Options 
  914. page of the Settings notebook.  The background and foreground colors as well as 
  915. the font used in the status window may be changed by pressing the RMB anywhere 
  916. in the Status window. 
  917.  
  918. When the RMB is pressed the options available as shown below. 
  919.  
  920.       Change Font - This option will show you the standard font selection 
  921.       window where you may choose any font you'd like for the Status window. 
  922.       Changes to the Status window are made if you select "OK" in the font 
  923.       window. 
  924.  
  925.       Here is what the font selection window looks like: 
  926.  
  927.       Change Colors - This option will display a window that will let you 
  928.       choose the background and foreground colors of the Status window.  The 
  929.       color change window allows you to save the color changes or to cancel 
  930.       them. If you save the changes they will be used the next time OS2PopS is 
  931.       started. 
  932.  
  933.       Here is what the color change window looks like: 
  934.  
  935.       Save Window Position - Once you have positioned and sized the status 
  936.       window to where you want it on the desktop, select this option to save 
  937.       its position.  The saved position will be used the next time OS2PopS is 
  938.       started. 
  939.  
  940.       Clear Status Window - Immediately clears the status window and displays 
  941.       the IBM Corporation copyright as well as how many clients are defined. 
  942.  
  943.       Show Client Count - Adds a line to the status window showing how many 
  944.       clients are defined to OS2PopS. 
  945.  
  946.  
  947. ΓòÉΓòÉΓòÉ 8. Problem determination ΓòÉΓòÉΓòÉ
  948.  
  949. We don't think you will run into any problems with OS2PopS itself but you may 
  950. be contacted when one of your clients has a problem.  The most common problem 
  951. will probably be confusion about a password.  It is important to remember that 
  952. passwords are case sensitive.  Abc is not the same as ABC when it is used as a 
  953. password. 
  954.  
  955. There really isn't much more to add here.  If you run into problems that you 
  956. think other people might too, please drop us a line and we'll update this 
  957. section as needed. 
  958.  
  959.  
  960. ΓòÉΓòÉΓòÉ 9. Security ΓòÉΓòÉΓòÉ
  961.  
  962. The OS2PopS POP server maintains security for client connections as outlined in 
  963. RFC1725 which describes how a POP server must handle client connections.  There 
  964. is no limit to the number of attempts a client may make with an invalid 
  965. password so there is a chance someone could "hack" into a mailbox.  Which leads 
  966. to the next point. 
  967.  
  968. You should encourage your clients to choose passwords that are both long and 
  969. contain upper and lower case letters.  Another good choice is a combination of 
  970. letters and numbers.  Although OS2PopS does not require a minimum length for 
  971. passwords, at least 6 letters and/or numbers should be considered a minimum. 
  972.  
  973. The client passwords are stored as plain text in the OS2POPS.Users file in the 
  974. UserInfo directory under the OS2PopS root directory.  You should take great 
  975. care to restrict both logical and physical access to the machine that OS2PopS 
  976. is running on. 
  977.  
  978. Logical access includes, but is not limited to, ftp, telnet, net use, mount, 
  979. etc.  Most access methods, including the ones listed, provide some sort of 
  980. mechanism for limiting access.  The one exception is telnet, on OS/2, which 
  981. does not provide a way to limit access.  If someone can telnet into the machine 
  982. running OS2PopS they may do anything to the system. 
  983.  
  984.  
  985. ΓòÉΓòÉΓòÉ 10. OS2PopS Reports ΓòÉΓòÉΓòÉ
  986.  
  987. The PopSRptR reporting program may be used to generate informational reports 
  988. that detail the activity of your OS2PopS POP server.  The following reports are 
  989. currently available: 
  990.  
  991.       Data delivered analysis - summarizes how many files and bytes of data 
  992.       have been delivered to your clients on a daily basis.  The average size 
  993.       of the data delivered is also included. 
  994.  
  995.       Active client analysis - summarizies activity for active clients (clients 
  996.       that have received data from the OS2PopS POP server during the reporting 
  997.       period selected). 
  998.  
  999.       Inactive client analysis - summarizes clients who have NOT received any 
  1000.       data at all from the OS2PopS POP server during the reporting period 
  1001.       selected.  This report may be used to identify clients who are not 
  1002.       actively using your OS2PopS POP server. 
  1003.  
  1004.  Report output destination - You may have the report that is built displayed 
  1005.  with the E editor or saved in a file. If you select "Display report in 
  1006.  editor", the report will be generated and displayed using the E editor.  The 
  1007.  reporting program will be halted until you exit the E editor. 
  1008.  
  1009.  If you select "Save report in a file", you will be prompted to select a 
  1010.  location for the file as well as the file name.  By default OS2PopS reporting 
  1011.  will store the report in the \OS2POPS\Reports directory.  The default file 
  1012.  name will be: 
  1013.  
  1014.      For Data delivered analysis - Sent.Data.Report.StartDate.EndDate 
  1015.  
  1016.      For Active client analysis - Active.Clients.Report.StartDate.EndDate 
  1017.  
  1018.      For Inactive client analysis - Inactive.Clients.Report.StartDate.EndDate 
  1019.  
  1020.  All dates will be in the format yyyymmdd (year month day). 
  1021.  
  1022.  We'd like to get your ideas for the types of reports you would find useful 
  1023.  along with how you would like to see the data presented.  Some possibilities 
  1024.  include: 
  1025.  
  1026.      Client connection activity - how often are clients checking for mail 
  1027.  
  1028.      Delivered data analysis - are any of your clients getting large data 
  1029.       items on a regular basis - what is the peak time of data for data arrival 
  1030.  
  1031.  Anything else you can think of will be considered.  Just drop us a note with 
  1032.  the details and, if possible, how you would like to see the information 
  1033.  presented. 
  1034.  
  1035.  
  1036. ΓòÉΓòÉΓòÉ 11. Commands OS2PopS supports ΓòÉΓòÉΓòÉ
  1037.  
  1038. OS2PopS supports the following commands: 
  1039.  
  1040.       APOP 
  1041.       QUIT 
  1042.       USER 
  1043.       PASS 
  1044.       STAT 
  1045.       LIST 
  1046.       RETR 
  1047.       DELE 
  1048.       NOOP 
  1049.       RSET 
  1050.       TOP 
  1051.       UIDL 
  1052.       HELP 
  1053.  
  1054.  OS2PopS also supports the following commands which are NOT part of the RFCs 
  1055.  for a POP server.  They were added to support remote administration of 
  1056.  OS2PopS. 
  1057.  
  1058.       ADDCLIENT - define new client 
  1059.       DELCLIENT - delete a client 
  1060.       MODCLIENT - modify a client 
  1061.       QUIT    - end session 
  1062.       RADMIN   - admin user ID 
  1063.       USERDATA  - retrieve user data 
  1064.  
  1065.  Details on the remote administration commands may be found in the Remote 
  1066.  Administration Commands section that follows. 
  1067.  
  1068.  
  1069. ΓòÉΓòÉΓòÉ 12. Remote Administration Commands ΓòÉΓòÉΓòÉ
  1070.  
  1071. You will not find any of the commands for remote administration listed in any 
  1072. of the RFCs.  These commands are sent to the OS2PopS server by the remote 
  1073. administration client.  They are detailed here for your information. 
  1074.  
  1075. All commands sent to the OS2PopS server are terminated by a CRLF (carriage 
  1076. return/line feed - '0D0A'x).  If a command requires data, such as the ADDCLIENT 
  1077. command, the data is sent in the same packet as the command itself with a 
  1078. single blank between the command and the data the command requires. 
  1079.  
  1080. As an example, to retrieve information about a client user ID of joeuser the 
  1081. following command would be sent to the OS2PopS POP server: 
  1082.  
  1083. USERDATA joeuser <CRLF>
  1084.  
  1085. Responses from the OS2PopS POP server 
  1086.  
  1087. If a command sent to a OS2PopS POP server succeeds the OS2PopS POP server will 
  1088. return +OK which is the normal POP3 positive response.  If the command does not 
  1089. succeed the OS2PopS POP server will return -ERR which is the normal POP3 
  1090. negative response. 
  1091.  
  1092. In the examples the hex01 is the value '01'x.  This is the value that is used 
  1093. to delimit data that some commands require. 
  1094.  
  1095.      ADDCLIENT - to define a new client to the OS2PopS POP server a single 
  1096.       line of data is sent to it.  The single line contains exactly the 
  1097.       contents of an entry in the OS2PopS users file. 
  1098.  
  1099.       Specifically, it must contain: 
  1100.  
  1101.             hex01UserIDhex01PassW1hex01Commenthex01
  1102.  
  1103.       Any agent that is adding clients to the OS2PopS POP server should use the 
  1104.       USERDATA command to verify that the client user ID that will be added 
  1105.       does not conflict with an existing user ID. 
  1106.  
  1107.       The user ID may not be longer than 50 characters and may NOT contain 
  1108.       blanks.  The password may also be up to 50 characters in length and may 
  1109.       NOT contain blanks.  The comment may contain up to 200 characters and 
  1110.       blanks are permitted. 
  1111.  
  1112.       For example, to add a client user ID of joeuser to the OS2PopS POP server 
  1113.       the following command would be sent to the OS2PopS POP server: 
  1114.  
  1115.             ADDCLIENT hex01joeuserhex01joespasswordhex01This is Joe Users commenthex01 <CRLF>
  1116.  
  1117.      DELCLIENT - to delete an existing OS2PopS POP server client user ID the 
  1118.       user ID to be deleted is sent to the OS2PopS POP server.  For example, to 
  1119.       delete the client user ID joeuser the following command would be sent to 
  1120.       the OS2PopS POP server: 
  1121.  
  1122.             DELCLIENT joeuser <CRLF>
  1123.  
  1124.      MODCLIENT - used to modify an existing clients password or comments 
  1125.       field.  The data that is sent to the server is exactly the same as the 
  1126.       ADDCLIENT command. 
  1127.  
  1128.       For example, to modify the joeuser user ID on the OS2PopS POP server the 
  1129.       following command would be sent to the OS2PopS POP server: 
  1130.  
  1131.             MODCLIENT hex01joeuserhex01joesnewpasswordhex01This is Joe Users new commenthex01 <CRLF>
  1132.  
  1133.      QUIT    - ends the session between the remote administration client and 
  1134.       the OS2PopS POP server.  This is a "clean" break and should be used after 
  1135.       every command is sent to the OS2PopS POP server. 
  1136.  
  1137.             QUIT <CRLF>
  1138.  
  1139.      RADMIN   - initial command sent to the OS2PopS POP server by the remote 
  1140.       client to establish a connection with the OS2PopS POP server.  The RADMIN 
  1141.       command works exactly like the APOP command for POP clients and requires 
  1142.       access to code that can build an MD5 digest string. 
  1143.  
  1144.       The initial greeting presented by the OS2PopS POP server when a remote 
  1145.       administration client connects includes a unique string that the remote 
  1146.       administration client must use to compute the MD5 string that is used 
  1147.       with the RADMIN command. 
  1148.  
  1149.       Rather than repeat all of the details about how the APOP command works, 
  1150.       I'll refer you to RFC1939 which contains all of the details. After the 
  1151.       remote administration client has computed the necessary MD5 digest value, 
  1152.       the RADMIN command is sent to the OS2PopS POP server to establish the 
  1153.       connection. 
  1154.  
  1155.             RADMIN adminuserid md5_digest_value_using_the_admins_password
  1156.  
  1157.      USERDATA  - is used to retrieve details about a specific client user ID 
  1158.       or a list of all client user IDs that are defined to the OS2PopS POP 
  1159.       server.  When information about a specific client is required, the client 
  1160.       user ID that remote administration wants the details about is passed as 
  1161.       the first and only argument. 
  1162.  
  1163.       For example, to retrieve all of the details about client user ID joeuser 
  1164.       the following command would be sent to the OS2PopS POP server: 
  1165.  
  1166.             USERDATA joeuser <crlf>
  1167.  
  1168.       To retrieve a list of all of the client user IDs defined to the OS2PopS 
  1169.       POP server the value *all* is sent to the OS2PopS POP server. 
  1170.  
  1171.             USERDATA *all* <crlf>
  1172.  
  1173.       The difference between the 2 formats of the command is what is returned 
  1174.       to the remote administration client.  For the first case, retrieving data 
  1175.       for a specific client, the OS2PopS POP server will return +OK <crlf> 
  1176.       followed by a single line of data that contains the client user ID 
  1177.       details. 
  1178.  
  1179.       The client information will be terminated by an End Of Data (EOD) string 
  1180.       which consists of <crlf>.<crlf> (that's a period between the CRLF pairs). 
  1181.       This happens to be the same EOD string that is used when OS2PopS is 
  1182.       delivering mail to clients as documented in RFC1939. 
  1183.  
  1184.       The string of data with client details matches exactly what is stored in 
  1185.       the user file on the OS2PopS POP server.  It will consist of: 
  1186.  
  1187.             hex01joeuserhex01joespasswordhex01This is Joe Users commenthex01
  1188.  
  1189.       It is easily broken up into individual parts by using: 
  1190.  
  1191.             parse var datain (hex01) userid (hex01) userpw (hex01) usercomment (hex01) .
  1192.  
  1193.       The 2nd form of the command, to retrieve a list of all defined user IDs, 
  1194.       only returns a list of user IDs delimited by a <CRLF> between them (no 
  1195.       password or comment data is returned).  The list of defined client user 
  1196.       IDs is terminated by the EOD string so remote administration knows when 
  1197.       the list of IDs is complete. 
  1198.  
  1199.  A sample CMD file that we have used to register clients to our OS2PopS POP 
  1200.  servers via a Web page is included in the OS2PopS ZIP file as 
  1201.  WebReg.CMDSample. It illustrates the use of all of the commands shown above 
  1202.  and may be modified and used if you so desire. 
  1203.  
  1204.  The sample is, necessarily, modified slightly from the version we actually use 
  1205.  and has NOT been extensively tested.  Modify and use at your own risk. 
  1206.  
  1207.  
  1208. ΓòÉΓòÉΓòÉ 13. The OS2PopS directory structure ΓòÉΓòÉΓòÉ
  1209.  
  1210. The directory where the OS2PopS main program is installed is known as the root 
  1211. directory for OS2PopS.  All other directories are below this directory 
  1212. including the client mail store.  At installation time OS2PopS will create the 
  1213. following directories (we'll assume an installation on the "D" drive): 
  1214.  
  1215.  D:\OS2POPS
  1216.            \Accounting
  1217.            \LogFiles
  1218.            \MailRoot
  1219.                     \nobody
  1220.                     \postmaster
  1221.                     \....
  1222.            \OutBound
  1223.            \Reports
  1224.            \UserInfo
  1225.            \Work
  1226.  
  1227.      Accounting - the files in this directory maintain a running log of client 
  1228.       connects and disconnets 
  1229.  
  1230.      LogFiles - all OS2PopS activity is logged in various files in this 
  1231.       directory 
  1232.  
  1233.      MailRoot - each client defined to OS2PopS has a directory below this one 
  1234.       - nobody and postmaster are the default clients that are created during 
  1235.       the installation of OS2PopS 
  1236.  
  1237.      OutBound - files sent from clients using the XMIT command are stored here 
  1238.       until they are sent 
  1239.  
  1240.      Reports - if any reports are generated this is the default directory 
  1241.       OS2PopS will write them to 
  1242.  
  1243.      UserInfo - this is where the file that contains client information 
  1244.       resides 
  1245.  
  1246.      Work - a temporary area for OS2PopS 
  1247.  
  1248.  The The files that OS2PopS creates section provides details on the files that 
  1249.  will be found in each directory. 
  1250.  
  1251.  
  1252. ΓòÉΓòÉΓòÉ 14. The files that OS2PopS creates ΓòÉΓòÉΓòÉ
  1253.  
  1254. Detailed here are the files, and their formats, that OS2PopS creates in the 
  1255. various directories.  All of the log files have a file extension that is 
  1256. composed of the year, month, and day in the format yyyymmdd.  Each line within 
  1257. the log files starts with the date in yyyymmdd format followed by the time in 
  1258. hh:mm:ss format.  Beyond that, the contents of the line are different for each 
  1259. type of log file. 
  1260.  
  1261.      Accounting - the only file name created in this directory is Accounting. 
  1262.       Following the date and time is a single word that will be ON or OFF 
  1263.       followed by the client ID that logged ON or disconnected (OFF).  Here's 
  1264.       an example of what a line might look like: 
  1265.  
  1266.              19960625 02:33:13 OFF nobody
  1267.  
  1268.      LogFiles - several types of logging may be done by OS2PopS.  All of the 
  1269.       logging is done into files in this directory.  Each type of logging 
  1270.       activity uses a different file name. 
  1271.  
  1272.         -  Data - this log file details data that has been delivered to 
  1273.            clients.  In addition to the date and time, each line contains the 
  1274.            number of bytes delivered to the client, how long it took OS2PopS to 
  1275.            deliver that data, and the client user ID the data was delivered to. 
  1276.            Here's an example of what a line might look like: 
  1277.  
  1278.                        19960506 01:56:53    1216    0.03 nobody
  1279.  
  1280.            In this example 1216 bytes of data were delivered to client ID 
  1281.            nobody in 0.03 seconds. 
  1282.  
  1283.         -  Errors - this log file details unexpected errors that will occurr 
  1284.            while clients are connected to OS2PopS.  Generally speaking, what is 
  1285.            logged here may not necessarily be an error.  It is usually simply 
  1286.            an indication that a client disconnected abnormally.  Following the 
  1287.            date and time in the file is the error message generated by OS2PopS. 
  1288.            This message will usually contain the socket number the client was 
  1289.            using as well as the error from TCP/IP itself if any.  Here's what 
  1290.            an entry might look like: 
  1291.  
  1292.                        19960505 16:09:33 Client using socket 652 disconnected during conversation
  1293.  
  1294.         -  Info - this log file details general information type messages.  The 
  1295.            most common is the initial client connection message which includes 
  1296.            the address the client is connecting from as well as the socket they 
  1297.            used when they connected.  Here's what an entry might look like: 
  1298.  
  1299.                        19960504 00:01:23 Connect from 1.127.0.0 using socket 2039
  1300.  
  1301.         -  Received - this log file details mail items that are received via 
  1302.            sendmail and processed by the PopSMail endmailer.  Following the 
  1303.            date and time each line contains the client ID on the OS2PopS POP 
  1304.            server that the file was destined for, the number of bytes received, 
  1305.            and the address that the file was from.  Here's what an entry might 
  1306.            look like: 
  1307.  
  1308.                        19960511 00:12:34 nobody 1017 nobody@nowhere.com
  1309.  
  1310.            In this example client nobody received 1017 bytes of data from 
  1311.            nobody@nowhere.com. 
  1312.  
  1313.         -  Trace - this log file details the "conversation" between OS2PopS and 
  1314.            its clients.  Following the date and time is either Sent or Received 
  1315.            to indicate if data was sent to a client or received from a client. 
  1316.            After that the actual data that was sent or received is logged. 
  1317.            Here's what a couple of entries might look like: 
  1318.  
  1319.                       19960503 06:58:43 Received USER nobody
  1320.                       19960503 06:58:43 Received PASS somepw
  1321.                       19960503 06:58:43 Received STAT
  1322.                       19960503 06:58:43 Sent 6 10328215
  1323.                       19960503 06:58:43 Received UIDL
  1324.                       19960503 06:58:44 Received RETR 1
  1325.                       19960503 06:58:44 Received DELE 1
  1326.  
  1327.            As you might anticipate, the trace log files can grow very quickly. 
  1328.            It only needs to be enabled if a particular client is having a 
  1329.            problem and you need to see what the client and server are sending 
  1330.            each other. 
  1331.  
  1332.      MailRoot - no files are stored in the MailRoot directory itself.  Instead 
  1333.       you will see a directory beneath MailRoot for every client you have 
  1334.       defined. 
  1335.  
  1336.         -  Client directories - as mail is received the PopSMail endmailer 
  1337.            deposits it into the appropriate client directory.  One file for 
  1338.            each mail item received is created.  Each file will have a unique 
  1339.            name and extension which is based on the date and time received.  A 
  1340.            file name might look like this: 
  1341.  
  1342.                        19950521.07353903
  1343.  
  1344.            The file name is the date in yyyymmdd format.  The file extension is 
  1345.            the time in hhmmssuu which almost guarantees that every file 
  1346.            received will have a unique file name. 
  1347.  
  1348.      OutBound - this directory is used as a temporary storage area for files 
  1349.       that clients send via the OS2PopS POP server using the client XMIT 
  1350.       command. 
  1351.  
  1352.      Reports - this is the default directory where OS2PopS will write reports 
  1353.       that are generated.  When reports are generated you will be given a 
  1354.       chance to change the location and name of the report file if you don't 
  1355.       want to have it created in this directory. 
  1356.  
  1357.      UserInfo - this is where the file with all of the information about your 
  1358.       defined clients is stored.  The primary user file name is OS2POPS.Users. 
  1359.       As you add, modify, or delete clients you will notice that 10 generations 
  1360.       of the user file are maintained for backup should something happen and 
  1361.       you need to undo an update.  There is also one additional backup copy of 
  1362.       the main file that is created immediately before the main file is updated 
  1363.       for any reason. 
  1364.  
  1365.         -  OS2POPS.Users - this is it.  All of the information about your 
  1366.            clients is stored in this file.  For the most part this file is 
  1367.            plain text so you may view it if necessary but be careful.  A value 
  1368.            of "01"x (hex 01) is used to separate the components of each line 
  1369.            and they are absolutely critical for the proper operation of 
  1370.            OS2PopS. 
  1371.  
  1372.            Don't update this file manually because OS2PopS won't see any 
  1373.            changes you make.  And if you should update, add, or delete a client 
  1374.            any manual changes you may have made will be lost.  Each line of the 
  1375.            file consists of 3 things each of which is surrounded by hex 01. 
  1376.  
  1377.            The 3 elements are: 
  1378.  
  1379.                 client user ID 
  1380.  
  1381.                 client password 
  1382.  
  1383.                 comments (freeform) 
  1384.  
  1385.            The client user ID will always be lower case but the client password 
  1386.            is case sensitive.  The comments may contain anything at all.  We 
  1387.            store our clients real name in the comments section. 
  1388.  
  1389.      Work - this directory is used by OS2PopS from time to time to store 
  1390.       temporary files. 
  1391.  
  1392.  
  1393. ΓòÉΓòÉΓòÉ 15. The OS2PopS INI file ΓòÉΓòÉΓòÉ
  1394.  
  1395. The OS2PopS INI file is used to hold several pieces of information that are 
  1396. used by various components of OS2PopS.  There is only 1 application name used 
  1397. in the OS2PopS INI file and that name is OS2PopS.  All of the keys that have 
  1398. more than 1 value have the values separated by a semi-colon ";".  If a key is 
  1399. identified as having "binary flags" the value(s) will always be a zero or a 
  1400. one.  The following keys are defined: 
  1401.  
  1402.      CDetailsPos - 2 values for the position of the Client Details window - 
  1403.       left side, top 
  1404.  
  1405.      CMaintPos - 2 values for the position of the Client Maintenance window - 
  1406.       left side, top 
  1407.  
  1408.      DisplayOptions - 3 binary flags - info messgaes, warning messages, error 
  1409.       messages 
  1410.  
  1411.      LogOptions - 3 binary flags - info logging, trace logging, receive 
  1412.       logging 
  1413.  
  1414.      MainPos - 2 values for the position of the main control panel on the 
  1415.       desktop - left side, top 
  1416.  
  1417.      MiscOptions - 1 binary flag and 1 numeric value - remote administration 
  1418.       enabled and number of minutes to delay status window clearing 
  1419.  
  1420.      POPSRoot - 1 value - complete path to OS2PopS root directory (includes 
  1421.       trailing \) 
  1422.  
  1423.      PruneOptions - 2 values for log file pruning - info and trace 
  1424.  
  1425.      Registration - 3 values - registered name, client limit, key 
  1426.  
  1427.      StatLooks - 3 values for appearance of status window - background color, 
  1428.       foreground color, font 
  1429.  
  1430.      StatPos - 4 values for position of status window on the desktop - height, 
  1431.       left side, top, width 
  1432.  
  1433.  
  1434. ΓòÉΓòÉΓòÉ 16. Contacting IBM ΓòÉΓòÉΓòÉ
  1435.  
  1436. This program was written by Dave Martin of IBM Corporation in Research Triangle 
  1437. Park North Carolina USA.  You may reach Dave by sending E-Mail to: 
  1438. djm@raleigh.ibm.com 
  1439.  
  1440. The latest version of OS2PopS and all of the latest news may be found on the 
  1441. Web at http://www.raleigh.ibm.com/misc/os2pops 
  1442.  
  1443. A mailing list run by MajorDomo is available for OS2PopS questions, 
  1444. suggestions, and bug reports. A Web interface to MajorDomo is available on the 
  1445. Web at http://www.raleigh.ibm.com/maillists 
  1446.  
  1447. You may also contact the MajorDomo server by E-Mail.  To subscribe send mail to 
  1448. majordomo@raleigh.ibm.com and include a single line in the body of the note 
  1449. that contains: 
  1450.  
  1451. subscribe os2pops
  1452.  
  1453. If you wish to unsubscribe from the list send a note to the same address and 
  1454. include a single line in the body of the note that contains: 
  1455.  
  1456. unsubscribe os2pops
  1457.