home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / hswtch06.zip / HSWITCH.TXT < prev   
Text File  |  1995-02-06  |  11KB  |  283 lines
  1. DISCLAIMER
  2. ==========
  3.  
  4.  
  5. I allow you to use and distribute HSWITCH freely under the
  6. condition that I am in no way responsible for any damage or
  7. loss you may suffer. 
  8.  
  9.  
  10. Henk Kelder, Fidonet 2:280/801.339
  11.  
  12. Notes about HSWITCH:
  13. ====================
  14.  
  15. HSWITCH is a program that allows you to switch sessions on OS/2 2.x and
  16. above from within full screen sessions. Note that for OS/2 2.0 you'll
  17. must have the first service pack (from way back) installed.
  18.  
  19. HSWITCH is a dual mode program. The .exe file actually contains TWO
  20. programs: A OS/2 program AND a TSR program for DOS.
  21.  
  22. HSWITCH will not work if Presention Manager is not loaded. 
  23. HSWITCH needs the taskmanager from PM.
  24.  
  25. General Installation for OS/2
  26. =============================
  27.  
  28. There are two ways to install HSWITCH:
  29.  
  30. 1. Add a "RUN=[path]HSWITCH.EXE [options] in your CONFIG.SYS
  31.  
  32. 2. Enter "DETACH [path]HSWITCH [options]" at a OS/2 command prompt
  33.  
  34. Valid options are:
  35.  
  36.         /Fnn : nn is first session number to monitor (default 4)
  37.         /Lnn : nn is last session number to monitor  (default 15)
  38.  
  39.         For all specified sessions numbers HSWITCH creates a seperate 
  40.         threat (or a subtask) that monitors incomming keys.
  41.         Since OS/2 has a maximum of 12 full screen OS/2 session the
  42.         range of sessions 4 to 15 is the normal range for all posible
  43.         OS/2 Full Screen sessions. But since almost nobody has 12 open
  44.         OS/2 Full Screens at the same time the upper limit can be 
  45.         set at a lower value.
  46.         
  47.         /Hnn : nn is the scancode of the HOTKEY. The default value for the 
  48.                hotkey is 53, being the forward slash.
  49.  
  50.         Note that this hotkey must always be an ALT-combination.
  51.         'nn' must be a valid DECIMAL keyboard SCAN code. Only minimal
  52.         checking is done on this number.
  53.  
  54.         Not all keys can be used. Some (e.g. the numeric keys and 
  55.         the tab key) simply don't work. Most alphabetic keys however work.
  56.         Just try it. 
  57.         
  58.         Should you use this parameter make sure you specify the /H 
  59.         parameter both for the OS/2 version as for the DOS version 
  60.         equally. 
  61.         There is a small difference between the way hotkeys are handled
  62.         in OS/2 session and in DOS sessions. Each key has a scancode of
  63.         its own but when any shift key (ctrl, alt, shift) is pressed in
  64.         combination with a key a scancode can change to a logical scancode.
  65.         The DOS version of HSWITCH always looks at the hardware scancodes, 
  66.         or actually, the make and break key values as returned by the
  67.         hardware.
  68.         The OS/2 version of HSWITCH looks at the logical scancode. For 
  69.         some keys these values are different. Just one example:
  70.  
  71.         The TAB key has scancode 15 when no addition keys are pressed.
  72.         When Alt-TAB is pressed the logical scancode becomes 165.
  73.         Should you wanne use alt-Tab as hotkey you should specify
  74.         /H165 for the OS/2 version, but /H15 for the DOS version.
  75.  
  76.         You'll find scancodes in your PC's manual.
  77.  
  78.         /O   : Always popup using (the VioPopUp attribute) OPAQUE. 
  79.                OPAQUE means that HSWITCH will always create a popup screen
  80.                with dimensions 25x80 and that underlying screen will not
  81.                be visible.
  82.                This argument is usefull for users working with SVGA
  83.                cards and using more than 80 columns on the screen.
  84.                Popping up HSWITCH will make spaghetti of the
  85.                screen.
  86.  
  87.         /Cbf  : Specify colors for HSWITCH. 'b' is the background color and
  88.                 'f' is the foreground color. Both are a hexadecimal value.
  89.  
  90.                 0 Black          8 Bright black
  91.                 1 Blue           9 Bright blue
  92.                 2 Green          A Bright green
  93.                 3 Cyan           B Bright Cyan
  94.                 4 Red            C Bright red
  95.                 5 Purple         D Bright purple
  96.                 6 Brown          E Yellow
  97.                 7 Gray           F White
  98.                
  99.                 e.g. /CE1 is a yellow background and a blue foreground.
  100.  
  101.                 On the rightside of the messagebar the current color value
  102.                 is always shown when HSWITCH is visible.
  103.                
  104.  
  105. Installation in a DOS box
  106. =========================
  107.  
  108. Simply run HSWITCH in a DOS (VDM or VMB) session, or better install in
  109. in your AUTOEXEC.BAT.
  110. It will install itself as an TSR program that will take round 9Kb of 
  111. RAM space.
  112. If the OS/2 version is not installed, the DOS version will NOT install.
  113.  
  114. When activated by its hotkey, HSWITCH will send a signal (via a named pipe)
  115. to the OS/2 counterpart that will actually show the switchlist. 
  116.  
  117. Since the OS/2 program has no way to determine which DOS session has send 
  118. the signal the DOS program changes its session title for some moments to 
  119. "DOSSWITCH" so the OS/2 program can recoqnize the proper DOS session.
  120. The default duration of this title-change is 500 milliseconds which is
  121. sufficient for a 33 mHz 486 on normal operation.
  122. If HSWITCH never checkmarks the current DOS session when activated from DOS
  123. you could try to increase this value. Please note that the DOS program is
  124. blocked for the specified duration.
  125.  
  126. Note: HSWITCH can also be loaded in a DOS window. Pressing 
  127. the hotkey there will have no effect.
  128.  
  129. HSWITCH does not work (the tasklist will not appear) while using WIN-OS/2,
  130. or from a PM program.
  131.  
  132. Syntax :
  133.         [path]HSWITCH [options]
  134.  
  135. Valid options are:
  136.  
  137.         /Hnn : nn is the scancode of the HOTKEY. The default value for the 
  138.                hotkey is 53, being the forward slash in combination with
  139.                the ALT key.
  140.  
  141.                This options only has effect when specified while installing
  142.  
  143.         /Tnn : Specify the title-change duration in milliseconds. 
  144.                The default duration is 500 milliseconds. 
  145.  
  146.         /R   : When already installed, removes itself from memory
  147.  
  148. Activating
  149. ==========
  150.  
  151. To activate HSWITCH press the hot-key. This hot-key consist of two keys:
  152. Press and hold the <ALT> key en press the forward slash or the user
  153. specified hotkey.
  154.  
  155. This keystroke causes a task list window to appear over the current
  156. screen. At the bottom of the screen a messagebar appears.
  157. A session can be selected by using the arrow keys, or by
  158. entering the first character in the session title.
  159.  
  160. Once a session has been selected, you can enter any of the following
  161. keys:
  162.  
  163. <ENTER> - switches you to the highlighted session
  164. <ESC>   - places you back in the session you started in
  165. <ALT-X> - Removes the detached HSWITCH OS/2 background program
  166. <ALT-B> - Change the background color
  167. <ALT-F> - Change the foreground color
  168. <DEL>   - Kill or Close the current selected session.
  169.  
  170. If a session is a PM session AND multiple windows appear with
  171. the same session and process id HSWITCH will try to close any
  172. of these session by posting a WM_CLOSE message. HSWITCH will ask
  173. confirmation as 'Close ... ?'
  174.  
  175. When the above is not the case the session is killed via DosKillProcess.
  176. HSWITCH ill then ask confirmation as 'Terminate ...?'.
  177.  
  178. Please note that you can also close the Desktop this way.
  179.  
  180. <ALT-A> - Toggle all/only selectable sessions.
  181.  
  182. By default HSWITCH only shows normal OS/2 session, these are sessions one 
  183. can jump to.
  184. By pressing Alt-A HSWITCH will show all tasks. Non jumpable tasks are placed
  185. between brackets [no jump task]. Although one cannot jump to these task, one
  186. can (try) to close/kill the task.
  187.  
  188.  
  189. Known bugs/limitations
  190. ======================
  191.  
  192. - HSWITCH may not become active from within an OS/2 session if you have more
  193.   than 20 or so sessions. OS/2 can however only handle 12 full screen OS/2
  194.   sessions.
  195.  
  196. - When you activate HSWITCH from an DOS session the current session is
  197.   not always marked by the highlighted bar. Instead the first session might
  198.   highlighted while no session is check-marked. (See notes on version 1.4)
  199.  
  200. - On Version of OS/2 where only the initial release of OS/2 is installed
  201.   (GA) there are reports of traps when the DOS HSWITCH is used.
  202.  
  203. - HSWITCH uses box drawing characters to display itself and assumes you are
  204.   using codepage 437. If you are not using this Codepage some incorrect
  205.   characters might be used.
  206.  
  207. - When HSWITCH is activated from a DOS session, and the session is at a 
  208.   COMMAND Prompt, HSWITCH will show 'Current DOS' instead of the normal 
  209.   title. (feature, no bug).
  210.  
  211.  
  212.  
  213. Credits
  214. =======
  215.  
  216. The OS/2 Part of HSWITCH is based on the public domain "VSWITCH" program 
  217. by Scott Dudley. The DOS part is of my own hand.
  218.  
  219. VSWITCH is in turn based on a public domain program call "HOTKEY" by
  220. Peter Fitzsimmons and Dave Burton.  
  221.  
  222. HSWITCH is also public domain. The OS/2 code was compiled with 
  223. IBM CSet/2 compiler for OS/2 2.x. The DOS code was compiled with
  224. the Microsoft C version 6.0a compiler.
  225.  
  226.  
  227. =========================== HISTORY =======================================
  228. Notes on version 1.3:
  229.  
  230. o       You can now specify the first and last session that hswitch
  231.         monitors.
  232.  
  233. o       When the DOS HSWITCH is used and the screen is not set on
  234.         25 lines, the screen background is cleared before the program
  235.         will popup.
  236.  
  237. o       If you run HSWITCH in the foreground it will show messages about
  238.         whats happening (debug messages mainly).
  239.  
  240.  
  241. Notes on version 1.4:
  242.  
  243. o       You can now specify the HOTKEY that HSWITCH uses.
  244.  
  245. o       The tasklist is shown in reversed order now. This normally matches
  246.         the order in the standard PM tasklist.
  247.  
  248. o       HSWITCH now tries to select the proper session when activated from
  249.         a DOS session. 
  250.  
  251.         However when it works, and the DOS session is at a COMMAND Prompt,
  252.         HSWITCH will show 'Current DOS' instead of the normal title. 
  253.         (feature, no bug).
  254.  
  255. o       When the DOS version was installed in upper memory using LH the
  256.         upper memory was not freed when the DOS version was deinstalled.
  257.         This has been corrected.
  258.  
  259.  
  260. Notes on version 1.5
  261.  
  262. o       Added the /O option. This option will make HSWITCH to use
  263.         the VioPopUp API call with the VP_OPAQUE flag instead of the
  264.         VP_TRANSPARENT flag. The flag will cause VioPopUp to always create
  265.         a clear 25 by 80 characters popup screen.
  266.         This option may be usefull for people with some SVGA adapters where
  267.         using HSWITCH will make spaghetti of the screen.
  268.  
  269.        
  270. Notes on version 1.6
  271.  
  272. o       Added support for colors in HSWITCH.
  273.  
  274. o       Added support for closing/killing an session.
  275.  
  276. o       Added a messagebar at the bottom of the screen.
  277.  
  278. Notes on version 1.7
  279.  
  280. o       Disabled HSWITCH from a DOS windowed session.
  281.  
  282.  
  283.