home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 24 DOS / 24-DOS.zip / ostsr12i.zip / OS2TITLE.DOC < prev    next >
Text File  |  1995-01-11  |  4KB  |  110 lines
  1.  
  2.                 OS2TITLE version 1.0 Copyright 1994 by Jay Clegg
  3.  
  4.    OS2TITLE is intended to work with OS/2 version 2.x or higher.  It has
  5.    been tested with OS/2 versions 2.1 and 3.0 (Warp).
  6.  
  7.    OS2TITLE is copyrighted free-ware, which means you can use it as you see
  8.    fit (free of charge) as long as you do not modify the program in any way.
  9.    Please do not distribute it without this documentation file.
  10.  
  11.                                   -------
  12.  
  13.    OS2TITLE is a OS/2 utility for DOS batch files.  What it does, in a
  14.    nutshell, is allow you to change the title bar for the DOS *window* that
  15.    the batch file is running in.  Normally, when running a batch file, the
  16.    title bar will contain the name of the batch file, but not the name of
  17.    the programs called by that batch file.  This can sometimes be a
  18.    nuisance.  Using OS2TITLE, you can change the title bar to either:
  19.  
  20.         a) any name you specify up to 12 characters
  21.         b) the name of the first executable to run after OS2TITLE
  22.         c) the default title name (such as "DOS session")
  23.  
  24.    Obviously, this program is of no use for full screen sessions.
  25.    Also, this program will ONLY work when executed in a batch file.
  26.  
  27.    OS2TITLE may be invoked as follows:
  28.  
  29.  
  30.         OS2TITLE Hello World!
  31.  
  32.    This will change the title bar to read "Hello World!".  You may use any
  33.    string that you wish, but only the first 12 characters will be used. This
  34.    is a constriction of the VDM API that this program uses. Note that the
  35.    title bar will keep this name until the batch file terminates, or until
  36.    you run OS2TITLE again.
  37.  
  38.  
  39.  
  40.         OS2TITLE
  41.  
  42.    Running OS2TITLE with no options will execute a function called "Enable
  43.    Automatic Title Switch".  This will change the title bar to the name of
  44.    the next executed program, when that program starts. The title bar will
  45.    keep this title until the batch file terminates, or until you run
  46.    OS2TITLE again.
  47.  
  48.  
  49.  
  50.         OS2TITLE/
  51.  
  52.    Running OS2TITLE with a slash causes the title bar to change to the
  53.    default session name (such as "DOS session"). Take note: do not use a
  54.    space before the slash.  The title bar will keep this title until the
  55.    batch file terminates, or until you run OS2TITLE again.
  56.  
  57.    Let me illustrate the use of OS2TITLE with some batch files that I use to
  58.    compile certain programs. Normally the batch file (COM.BAT) might look
  59.    something like this:
  60.  
  61.         Batch file line:                     Title bar reads:
  62.  
  63.         TASM %1                                 "COM.BAT"
  64.         TLINK /t %1                             "COM.BAT"
  65.  
  66.    When invoked from a OS/2 DOS prompt, the title bar will change to
  67.    "COM.BAT" until the batch file completes.  I can alter the behavior as
  68.    follows:
  69.  
  70.         Batch file line:                     Title bar reads:
  71.  
  72.         OS2TITLE
  73.         TASM %1                                 "TASM.EXE"
  74.         OS2TITLE
  75.         TLINK /t %1                             "TLINK.EXE"
  76.  
  77.     Alternately I could use this method:
  78.  
  79.         OS2TITLE Compiling..                    "Compiling.."
  80.         TASM %1
  81.         OS2TITLE Linking..                      "Linking.."
  82.         TLINK /t %1
  83.  
  84.  
  85.     Or simply put OS2TITLE at the beginning of the batch file and use the
  86.     the name of my choice for the duration of the batch file. Or put %1
  87.     after OS2TITLE and have the name of the program I am compiling come up
  88.     on the title bar.
  89.  
  90.     I'm sure you batch file guru's will find a more practical use for this
  91.     utility....Enjoy!
  92.  
  93.                                   -------
  94.  
  95.    Warranty: There is no warranty, period.
  96.    Full Legalese follows:
  97.  
  98.                                 DISCLAIMER
  99.  
  100.    Jay Clegg makes no warranty, either express or implied, including but not
  101.    limited to implied warranties of merchantability and fitness for a parti-
  102.    cular purpose with respect to this software.
  103.  
  104.    IN NO EVENT SHALL JAY CLEGG OR ANY OF HIS ASSOCIATES BE LIABLE FOR ANY
  105.    DAMAGES, INCLUDING DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS
  106.    INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR OTHER PECUNIARY LOSS
  107.    ARISING OUT OF THE USE OF OR INABILITY TO USE THIS PROGRAM, EVEN IF
  108.    JAY CLEGG HAS BEEN ADVISED OF THE POSSIBILITY OF DAMAGES.
  109.  
  110.