OS2TITLE version 1.0 Copyright 1994 by Jay Clegg

   OS2TITLE is intended to work with OS/2 version 2.x or higher.  It has
   been tested with OS/2 versions 2.1 and 3.0 (Warp).

   OS2TITLE is copyrighted free-ware, which means you can use it as you see
   fit (free of charge) as long as you do not modify the program in any way.
   Please do not distribute it without this documentation file.

                                  -------

   OS2TITLE is a OS/2 utility for DOS batch files.  What it does, in a
   nutshell, is allow you to change the title bar for the DOS *window* that
   the batch file is running in.  Normally, when running a batch file, the
   title bar will contain the name of the batch file, but not the name of
   the programs called by that batch file.  This can sometimes be a
   nuisance.  Using OS2TITLE, you can change the title bar to either:

        a) any name you specify up to 12 characters
        b) the name of the first executable to run after OS2TITLE
        c) the default title name (such as "DOS session")

   Obviously, this program is of no use for full screen sessions.
   Also, this program will ONLY work when executed in a batch file.

   OS2TITLE may be invoked as follows:


        OS2TITLE Hello World!

   This will change the title bar to read "Hello World!".  You may use any
   string that you wish, but only the first 12 characters will be used. This
   is a constriction of the VDM API that this program uses. Note that the
   title bar will keep this name until the batch file terminates, or until
   you run OS2TITLE again.



        OS2TITLE

   Running OS2TITLE with no options will execute a function called "Enable
   Automatic Title Switch".  This will change the title bar to the name of
   the next executed program, when that program starts. The title bar will
   keep this title until the batch file terminates, or until you run
   OS2TITLE again.



        OS2TITLE/

   Running OS2TITLE with a slash causes the title bar to change to the
   default session name (such as "DOS session"). Take note: do not use a
   space before the slash.  The title bar will keep this title until the
   batch file terminates, or until you run OS2TITLE again.

   Let me illustrate the use of OS2TITLE with some batch files that I use to
   compile certain programs. Normally the batch file (COM.BAT) might look
   something like this:

        Batch file line:                     Title bar reads:

        TASM %1                                 "COM.BAT"
        TLINK /t %1                             "COM.BAT"

   When invoked from a OS/2 DOS prompt, the title bar will change to
   "COM.BAT" until the batch file completes.  I can alter the behavior as
   follows:

        Batch file line:                     Title bar reads:

        OS2TITLE
        TASM %1                                 "TASM.EXE"
        OS2TITLE
        TLINK /t %1                             "TLINK.EXE"

    Alternately I could use this method:

        OS2TITLE Compiling..                    "Compiling.."
        TASM %1
        OS2TITLE Linking..                      "Linking.."
        TLINK /t %1


    Or simply put OS2TITLE at the beginning of the batch file and use the
    the name of my choice for the duration of the batch file. Or put %1
    after OS2TITLE and have the name of the program I am compiling come up
    on the title bar.

    I'm sure you batch file guru's will find a more practical use for this
    utility....Enjoy!

                                  -------

   Warranty: There is no warranty, period.
   Full Legalese follows:

                                DISCLAIMER

   Jay Clegg makes no warranty, either express or implied, including but not
   limited to implied warranties of merchantability and fitness for a parti-
   cular purpose with respect to this software.

   IN NO EVENT SHALL JAY CLEGG OR ANY OF HIS ASSOCIATES BE LIABLE FOR ANY
   DAMAGES, INCLUDING DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS
   INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR OTHER PECUNIARY LOSS
   ARISING OUT OF THE USE OF OR INABILITY TO USE THIS PROGRAM, EVEN IF
   JAY CLEGG HAS BEEN ADVISED OF THE POSSIBILITY OF DAMAGES.