home *** CD-ROM | disk | FTP | other *** search
/ Windoware / WINDOWARE_1_6.iso / winutil / utl106 / exitw.doc < prev    next >
Text File  |  1991-02-05  |  5KB  |  174 lines
  1. ExitW Copyright (c) 1990, 1991 Dragons Eye Software
  2. Last Updated: 02/05/91    Version 2.2
  3.  
  4. ----------------------------------------------------------------------------
  5.  
  6. If you have any questions or comments please contact Dragons Eye
  7. Software at the following address and phone number:
  8.  
  9. Dragons Eye Software
  10. P.O. Box 200262
  11. Arlington, TX  76006-0262
  12.  
  13. (817) 265-5619 8am to 10pm CDT 7 days a week
  14.  
  15. Compuserve: 76057,101
  16.  
  17. ----------------------------------------------------------------------------
  18.  
  19. ExitW includes the following features:
  20.  
  21.  o  ExitW can display a message before exiting to DOS that has both an Ok
  22.     and Cancel button so the user can cancel or continue the exit process.
  23.  
  24.  o  Using ExitW, the user can pass back an errorlevel code to DOS.
  25.  
  26.  o  The user can also set a specific DOS environment string.
  27.  
  28.  
  29. A new program called EXITWDOS.EXE is used to parse the parameters
  30. that are included on the ExitW command line, once control is
  31. returned to DOS.  Either an errorlevel code or environment strings
  32. may be set using the unique combination of ExitW and ExitWDOS.
  33.  
  34.  
  35. ----------------------------------------------------------------------------
  36.  
  37.  
  38. Command line parameters for EXITW.EXE:
  39.  
  40.  
  41.   The following command line parameters should be used when running ExitW:
  42.  
  43.   Execute ExitW as: exitw <command> <command> <command>    ...
  44.  
  45.   (several commands may be specified on the same ExitW command line).
  46.  
  47.   Each command should be preceeded by a dash "-" character.
  48.  
  49.  
  50.   M <message>
  51.  
  52.     where <message> is a string contained within quotes that you want
  53.     displayed to the user before exiting windows.
  54.     The Messagebox that will be displayed to the user will have
  55.     both Cancel and Ok buttons.  If the user presses Cancel, then
  56.     ExitW will NOT shut down Windows.
  57.     
  58.     Note that quotes are required for the message text to be displayed
  59.     properly.  Example: EXITW -M "Now running Autocad - Click on Cancel
  60.     to abort"
  61.     Quotes are required so that the command line dashes may be included
  62.     in the message text.
  63.  
  64.  
  65.   E <num>
  66.  
  67.     Where <num> is the errorlevel number that should be returned to DOS
  68.     when the program EXITWDOS.EXE is executed.  This number should fall
  69.     between 1 and 200 (an errorlevel code of 200 is used by EXITWDOS to
  70.     indicate a data file error).
  71.     Example: EXITW -E 10
  72.  
  73.   S <string>
  74.  
  75.     where string is an environment variable string that should be added
  76.     to or changed within the set of current MS-DOS environment settings.
  77.     An example would be: EXITW -S PATH=C:\;C:\DOS
  78.     so that when you run EXITWDOS.EXE, it would set your path to equal
  79.     C:\;C:\DOS.
  80.  
  81.  
  82.  
  83. *** If no parameters are given on the ExitW command line then ExitW
  84.     will not create a data file.  It will merely cause Windows to exit
  85.     to DOS.
  86.  
  87.  
  88. ----------------------------------------------------------------------------
  89.  
  90.  
  91. WIN.INI entry for EXITW.EXE
  92.  
  93.   The following two lines should be present in the WIN.INI file for ExitW
  94.   to operate properly:
  95.  
  96.   [ExitW]
  97.     Filename=<path>
  98.  
  99.  
  100.   where <path> is a full pathname a file where ExitW will store the commmand
  101.   line parameters.  (EG. Filename=C:\WINDOWS\EXITW.DAT).
  102.  
  103.   If this entry is not found, then ExitW will save the parameters to a file
  104.   called EXITW.DAT in the root directory of the current drive.
  105.  
  106.   A file: EXITW.INI is included that contains the parameters so that
  107.   you may use your favorite text editor to copy them to the WIN.INI
  108.   file.
  109.  
  110. ----------------------------------------------------------------------------
  111.  
  112.   
  113. Running Example:
  114.  
  115.       Calling ExitW with the following command line:
  116.  
  117.       EXITW -M "Exiting Windows" -S PATH=C:\ -E 10
  118.  
  119.     Would cause ExitW to write to disk the options:
  120.  
  121.       -S PATH=C:\
  122.       -E 10
  123.  
  124.     When EXITWDOS is executed, it will parse the data file created by
  125.     EXITW and change the path to equal "C:\" and will return and errorlevel
  126.     code of 10.
  127.  
  128.  
  129. ***** IMPORTANT *****
  130.  
  131. When executing EXITWDOS, you MUST specify the location and name of the file
  132. created by EXITW.  Without this specification, EXITWDOS will not know where
  133. to find the file.
  134.  
  135. For example:
  136.  
  137.   EXITWDOS C:\WINDOWS\EXITW.DAT
  138.  
  139. will cause EXITWDOS to look in the directory \WINDOWS on drive C: for the file
  140. EXITW.DAT.  If this file exists, EXITWDOS will parse the file and return the
  141. information contained within it.
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149. Revision History
  150. ----------------
  151.  
  152. Version 2.2    - 02/05/91
  153.     Streamlined for faster loading and a smaller .EXE
  154.  
  155.  
  156. Version 2.1    - 01/27/91
  157.     Added a cancel button to the MessageBox and fixed the bug where
  158.     ExitWDos was adding a space to the end of the environment variables.
  159.     Also changed the code so that dashes "-" may be used within messagebox
  160.     strings.
  161.  
  162.  
  163. Version 2.0    - 01/13/91
  164.     ExitW has been expanded to allow the user to: display a message before
  165.     exiting to DOS, to set the specific errorlevel code that should be
  166.     passed back and to set a specific environment string.
  167.  
  168.  
  169. Version 1.0    - 06/20/90
  170.     Released
  171.  
  172.  
  173.  
  174.