home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / pidsrv.zip / readme.txt < prev    next >
Text File  |  1996-07-10  |  6KB  |  153 lines
  1.                                       PID Server    
  2.                                       v1.00
  3.  
  4. July 5 ,1996
  5.  
  6. With the combination of the two included REXX programs PID Server
  7. (PIDSRV.CMD) and PID Client (PIDCLNT.CMD) you can monitor running 
  8. programs on a remote computer connected through a LAN using names
  9. pipes. After the client program gets the list of running programs you are 
  10. given the option to remotly send a kill command to that system for the 
  11. process ID number you specify. This is useful in recovering from a 
  12. locked que.
  13. ******************************************************
  14.  
  15.  
  16.                                      SET-UP for PID Server
  17.  
  18. For the machine you wish to protect you need to have it always run PID 
  19. Server. To do this copy the included *.DLL files into x:\os2\DLL so 
  20. that OS/2 can find them. NOTE: This needs to be done on every 
  21. machine you intend to run either (or both) programs on.
  22.  
  23.  
  24. Copy the PIDSRV.CMD file where ever you want it to go.
  25.  
  26. Then simply open up an OS/2 FULLSCREEN session and change to the 
  27. directory containing the PIDSRV.CMD file and run it by entering it's 
  28. name. That's it. Now if that machine locks up (or you just want to see 
  29. what is running on it) goto another machine and run the PID Client.
  30.  
  31. ******************************************************
  32.  
  33.                                     SET-UP for PID Client
  34.  
  35. Make sure to copy the *.DLL files into x:\os2\dll directory. Put the 
  36. PIDCLNT.CMD file where ever you want to keep it then just run it by 
  37. typing it's name. 
  38.  
  39. ******************************************************
  40.  
  41.                                   USING PID CLIENT
  42. When you run PIDCLNT.CMD:
  43.  
  44. It will ask you for the machine name of the Server that is running PID 
  45. Server that you wish to connect to. NOTE: This is the network name of 
  46. the machine...not anything that needs to be setup in these programs. 
  47.  
  48.  
  49. After you enter the name the PID Client will request a Task List from 
  50. the PID Server. Each process running on the machine (including hidden 
  51. stuff) will be displayed along with the PID number. Each process will 
  52. have a '****' at the end to help keep them seperate.
  53.  
  54. You then have the option of pressing 'L', a PID # or just enter to quit.
  55.  
  56. If you press 'L' then enter the PID Client will request another Task List 
  57. from the Server.
  58.  
  59. If you enter the PID number of a process then hit enter you will send a 
  60. request for the PID Server to kill that process. PID Server will then 
  61. report back to you the status of that process. NOTE: Even if it reports 
  62. back KILLED it can take a minute or two for the process to go away.
  63.  
  64.  
  65. Keep in mind that any process you kill will NOT save any work in 
  66. progress so use with care. If you kill the DESKTOP it should restart 
  67. itself.
  68.  
  69. *******************************************************
  70.  
  71.                             PROBLEMS and UNKNOWNS
  72.  
  73. The only problem I have seen is sometimes the PID Server won't
  74. exit when you press Ctrl+C if it is trying to reset the pipe. Try 
  75. hitting Ctrl+C a couple of times and it should exit.
  76.  
  77. If it doesn't you have two choices you can reboot the machine or you
  78. can just run PID Client on another machine and use it to kill the 
  79. PID Server.
  80.  
  81. NOTE: When the PID Server refuses to shut down it doesn't lock the
  82.         que....it just won't go away. This doesn't happen much anyway
  83.         but I thought I would mention it.
  84.  
  85.  
  86.  
  87. The unknowns are what LANs this will work on. I can only test it on a 
  88. Lantastic for OS/2 peer to peer network with both machines being 
  89. Servers. If it works on other networks please let me know.
  90.  
  91. The other being I thought I had a little bit of weirdness on this program
  92. running it under OBJECT REXX but I changed something slightly and
  93. it seemed to fix it. If you can only connect to a PID Server once
  94. without resetting the PID Server please let me know.
  95.  
  96.  
  97.  
  98. ********************************************************
  99.             End Remarks
  100.  
  101. Hopefully these programs will come in handy to someone 
  102. somewhere.<G>
  103.  
  104. For personal use this package is freeware with the added clause that 
  105. if you want to send me any contributions I would gladly take them. ;)
  106. As a bonus if you do send me a contribution I will keep you notified of 
  107. any updates to this program via e-mail as well as others I wrote. 
  108. (If you want them that is)
  109.  
  110. For Corporate use I am asking for $10 per machine that runs 
  111. PID Server.
  112.  
  113. Keep in mind that if you do register you will still be running the
  114. same code you are currently running. I didn't bother to put any
  115. timeouts into the code and I kept from making it an *.exe file
  116. so it could perhaps help someone to learn REXX.
  117.  
  118. All registering is going to give you is peace of mind, notification
  119. via e-mail of updates and help me to continue to produce new programs.
  120.  
  121. If you have any problems or questions with these programs send
  122. me e-mail at
  123.  
  124. SFOGG@IBM.NET
  125.  
  126. and if you do decide to register (THANK YOU!!!) you can sent that to
  127. me at
  128.  
  129. Shawn Fogg
  130. P.O. Box 89
  131. Slocum, RI 02877
  132.  
  133. Feel free to distribute this package in it's original form including this readme.txt as you like.
  134.  
  135. ***************************************************
  136.  
  137. Potential changes:
  138.  
  139.           GUI for PID Client
  140.  
  141.           Process accounting for PID Client in that it keeps a record
  142.           of what programs were running when on a certain machine
  143.           at a given interval. (This is a pretty massive change so it
  144.                                  might become a seperate program that
  145.                                  also works with the PID Server)
  146.  
  147.           Hooks to control upcoming Process Commander by SDS
  148.  
  149.           Ability to start programs running on a remote machine.
  150.  
  151. Let me know what else you might want and I will see what I can do.
  152.  
  153.