=== DISCLAIMER ===


I allow you to use and distribute HSWITCH freely under the
condition that I am in no way responsible for any damage or
loss you may suffer. 


Henk Kelder, Fidonet 2:280/801.339

Notes about HSWITCH version 1.0
===============================

HSWITCH is a program that allows you to switch sessions on OS/2 2.0 from
within full screen sessions.
 
HSWITCH is a dual mode program. The .exe file actually contains TWO
programs: A OS/2 program AND a TSR program for DOS.


General Installation for OS/2
=============================

There are two ways to install HSWITCH:

1. Add a "RUN=[path]HSWITCH.EXE in your CONFIG.SYS

2. Enter "DETACH [PATH]HSWITCH" at a OS/2 command prompt


Installation in a DOS box
=========================

Simply run HSWITCH in a DOS session. It will install itself as an TSR
program that will take round 8Kb of RAM space.
When activated by its hotkey, HSWITCH will send a signal to the 
OS/2 counterpart that will actually show the switchlist.
If the OS/2 version is not installed, the DOS version will NOT install.

You can remove the DOS version by typing HSWITCH /R. 

Note: HSWITCH can also be loaded and activated in a DOS window. Pressing 
the hotkey there will however result in switching to full screen before the
switchlist is displayed. 

HSWITCH does not work (the tasklist will not appear) while using WIN-OS/2.


Activating
==========

To activate HSWITCH press the hot-key. This hot-key consist of two keys:
Press and hold the right <ALT> key en press the forward shash.

This keystroke causes a task list window to appear over the current
screen.  A session can be selected by using the arrow keys, or by
entering the first letter in the session title.

Once a session has been selected, you can enter any of the following
keys:

<ENTER> - switches you to the highlighted session
<ESC>   - places you back in the session you started in
<ALT-X> - Removes the detached HSWITCH OS/2 background program


Known bugs/limitations
======================

- HSWITCH may not become active from within an OS/2 session if you have more
  than 20 or so sessions.

- When you activate HSWITCH from an DOS session the current session is
  not marked by the highlighted bar. Instead the first session is
  highlighted.

- On Version of OS/2 where only the initial release of OS/2 is installed
  (GA) there are reports of traps when the DOS VSWITCH is used.


Credits
=======

The OS/2 Part of HSWITCH is based on the public domain "VSWITCH" program 
by Scott Dudley. The DOS part is off my own hand.

VSWITCH is in turn based on a public domain program call "HOTKEY" by
Peter Fitzsimmons and Dave Burton.  

HSWITCH is also public domain. The OS/2 code was compiled with 
IBM C/2 Set 32 Bits compiler for OS/2 2.0. The DOS code was compiled with
the Microsoft C version 6.0a compiler.


Notes on version 1.3:

o       You can now specify the first and last session that hswitch
        monitors. The syntax is:

            run=[d:\path\]hswitch.exe /Fff /Lll (in the config.sys)
                        or
            detach [d:\path\]hswitch.exe /Fff /Lll (from the command line)

            where ff is the first session id and
                  ll is the last session id.

        The defaults are 4 until 15.                
        

o       When the DOS VSWITCH is used and the screen is not set on
        25 lines, the screen background is cleared before the program
        will popup.

o       If you run HSWITCH in the foreground it will show messages about
        whats happening.