home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / JUMP.ZIP / README.DOC < prev   
Text File  |  1991-09-19  |  3KB  |  93 lines
  1. DISCLAIMER
  2. ----------
  3. The Program is supplied "AS IS" without any warranty of any kind,
  4. either expressed or  implied,  including, but not limited to, the
  5. implied warranties of merchantability and fitness for a particular
  6. purpose.
  7.  
  8. In  no  event  shall Robert Mahoney be liable for any damages, either
  9. direct or  consequential,  caused by the use, or inability to use,
  10. this program, even  if Robert Mahoney has been advised of the
  11. possibility of such damages.
  12.  
  13.  
  14. INTRODUCTION
  15. ------------
  16. I originally came from a DOS workstation running the 3270 workstation
  17. and then went to OS/2 v1.1 EE.  Both of these had the neat feature
  18. of pressing Alt-Pageup to switch between sessions.  I was crushed when
  19. OS/2 v1.2 EE came out and didn't have that feature.  Using the mouse
  20. or Crtl-Esc and selecting from the task manager just didn't cut it,
  21. so when I finally got ahold of the v1.2 EHLLAPI documents and an
  22. example of system hooks (thanks to Mike Jones and the IdleNews staff)
  23. I wrote this system hook program to intercept the Alt-Pageup
  24. messages and maximize the 3270 sessions one-by-one.
  25.  
  26.  
  27. INSTRUCTIONS
  28. ------------
  29. The Session Jumper comprises of 3 programs:
  30.   JUMPLDR.EXE
  31.   JUMP.EXE
  32.   JUMPHOOK.DLL
  33.  
  34.   Place JUMPLDR.EXE and JUMP.EXE on your PATH.  Place JUMPHOOK.DLL
  35.   on your LIBPATH.  At a command prompt type "start JUMPLDR"
  36.   or put JUMPLDR.EXE as an entry in one of your groups.
  37.  
  38.  
  39. DETAILS
  40. ------------
  41.    Some technical info about the 3 programs - see the source
  42.    for more comments.
  43.  
  44. Jumpldr.exe
  45. -----------
  46.    This program is the hook loader and visual notification that
  47.    the hook is active.  It loads JUMPHOOK.DLL and sets the hook.
  48.    The checkbox indicates whether the hook is active.  If the hook
  49.    is inactive then Alt-Pageup will not maximize the 3270 session.
  50.    It also starts JUMP.EXE and creates and sets the JUMP semaphore
  51.    and DIE semaphore.
  52.  
  53. Jump.exe
  54. --------
  55.    This program is started detached and runs invisibly.  It is
  56.    triggered by semaphores.  The JUMP semaphore is set in JUMPLDR
  57.    and so is the DIE semaphore.  JUMP.EXE waits for the JUMP
  58.    semaphore to be cleared and then checks the DIE semaphore
  59.    if it is not to die then it does the maximizing it then sets
  60.    the JUMP semaphore and loops back to wait.
  61.  
  62. Jumphook.dll
  63. ------------
  64.    This intercepts all input queue messages.  When it sees an Alt-Pageup
  65.    it clears the JUMP semaphore.
  66.  
  67. The reason I took a 3 tiered approach rather than a 2 tiered is
  68. that I was unable to get the EHLLAPI PM Window services calls
  69. working under PM or in the hook DLL.  If you can do this then
  70. please let me know how.
  71.  
  72. BUGS
  73. ----
  74. I have a crude workaround for the only bug I know of.  Sometimes
  75. when exiting the JUMPLDR the JUMP semaphore would not be closed
  76. and if you run the program again, it was unable to create
  77. the semaphore (already exists). So now if the create fails, I just
  78. open the semaphore.  Pretty lame, but damned if I could find where
  79. the problem lay.  Probably a timing problem and the best solution
  80. is probably not to use a DIE semaphore but for JUMP.EXE to place its
  81. PID in shared memory and have JUMPLDR kill it upon exit.
  82.  
  83.         I can be reached on:
  84.  
  85.    Fidonet OS/2 echos:  OS/2 Shareware  (1:109/347)
  86.                         703-385-0931 (HST DS)
  87.                         703-385-4325 (HST DS)
  88.    BIX as RMAHONEY
  89.  
  90.         Robert Mahoney
  91.         27 East Jackson Ave
  92.         Babylon, New York 11702
  93.