home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / hstart05.zip / hstart.txt < prev    next >
Text File  |  1995-05-31  |  7KB  |  180 lines
  1.                       === DISCLAIMER ===
  2.  
  3.  
  4. I allow you to use and distribute HSTART freely under the condition that 
  5. I am in no way responsible for any damage or loss you may suffer. 
  6.  
  7.  
  8. Henk Kelder, 2:280/801.339@fidonet.org
  9.  
  10.  
  11. Notes on HSTART
  12. ===============
  13.  
  14. HSTART.EXE is an alternative program for the START command embedded in
  15. OS/2. HSTART will however only work on OS/2 2.1.
  16.  
  17. Compared with the START command it has two advantages:
  18.  
  19. -       HSTART can be used from DOS sessions 
  20.         From  OS/2's own DOS, called a Virtual Dos Machine (VDM), as
  21.         an other version of DOS started from an boot diskette or an
  22.         image file, called a Virtual Machine Boot (VMB).
  23.  
  24. -       HSTART allows DOS Settings for a DOS session to be specified in a 
  25.         text file.
  26.  
  27.  
  28. USING HSTART
  29. ============
  30.  
  31. The syntax of HSTART is mainly the same as the syntax of the START command:
  32. (type 'HELP START' on a command line for more details on the various 
  33. parameters)
  34.  
  35.   HSTART ["Title"] [options] [program] [parameters]
  36.  
  37.   Valid options are:
  38.  
  39.   /DOS    - start a dos session
  40.   /PM     - start a presentation manager session
  41.  
  42.   /FS     - start a fullscreen session
  43.   /WIN    - start a windowed session
  44.  
  45.   /F      - start session in the foreground
  46.             (This is default when /PM, /FS, /DOS or /WIN is specified)
  47.   /B      - start session in the background
  48.             (This is default when /PM, /FS, /DOS and /WIN are not specified)
  49.  
  50.   /MAX    - starts session maximized (if windowed)
  51.   /MIN    - starts session minimized (if windowed)
  52.  
  53.   /C      - start via command processor. Terminate session when program ends
  54.   /K      - start via command processor. Keep session when program ends
  55.             (This is the default for non-PM programs)
  56.   /N      - start program directly (bypass command processor)
  57.             (This is the default for PM programs)
  58.  
  59.   /S:file - Specify File containing settings for DOS sessions
  60.             See SETTINGS.TXT for more details on DOS settings.
  61.  
  62.   /WAIT   - Wait for session to finish 
  63.             (Works with restrictions, see below)
  64.  
  65.   Remarks:
  66.  
  67.   -     The /I parameter is not implemented in HSTART. It doesn't seem to
  68.         work properly for the START command anyway.
  69.  
  70.   -     You cannot combine the /DOS parameter with the /N parameter.
  71.  
  72.   -     When you specify /DOS and do not specify a /S:file parameter
  73.         a default setting file is used. This default file is searched for in
  74.         the same directory as HSTART is located. The name of this default
  75.         file is HSTART.CFG.
  76.  
  77.   -     You cannot specify a /S:file parameter if no /DOS parameter is 
  78.         specified. 
  79.  
  80.   -     When used on a system without PM do not use the /MIN or /MAX
  81.         options. Hstart will not work then.
  82.  
  83. KNOWN PROBLEMS/RESTRICTIONS:
  84. ============================
  85.  
  86. -       When HSTART is used from DOS, the new session does not have the
  87.         same current directory as the session HSTART was issued from.
  88.         Instead the new session starts from the root directory of drive
  89.         OS/2 boots from. 
  90.  
  91.         You could use the '&' to combine several commands
  92.         to get to the requested subdir
  93.  
  94.             e.g.: HSTART "BinkleyTerm" /fs e:&cd \binkley&btp
  95.  
  96.         or use a .bat/.cmd file.
  97.  
  98. -       When a DOS session is started in the background switching to this
  99.         new session and then switching back to the desktop seems to distore
  100.         the graphical display. 
  101.         (Only when SET VIDEO_8514A_XGA_IOTRAP=0; is in the DOS settings file)
  102.  
  103. -       On some SVGA systems, starting a DOS session in the background, and
  104.         switching to it shows a complete black screen. The DOS session seems 
  105.         to hang. (Possibly also related to VIDEO_8514A_XGA_IOTRAP ?)
  106.  
  107.         Should this occur, switch back to the desktop and close the DOS 
  108.         session using the tasklist.
  109.  
  110.  
  111. -       When the /N parameter is used, please specify the full program name,
  112.         including the extension.
  113.  
  114. -       The /WAIT parameter only works directly when used from a OS/2
  115.         sesssion.
  116.         Please note that if you start a (program in a) command session,
  117.         HSTART will stop waiting after the session itself is closed. 
  118.         Use the /C parameter if needed.
  119.  
  120.         When this option is used from a DOS session, please use HWAIT
  121.         (without options) to signal hstart it may continue, or better, stop
  122.         waiting. Please note that this will only function properly when only
  123.         one DOS session is waiting. When multiple DOS sessions are waiting
  124.         they will all continue after HWAIT is run.
  125.         A better solution when from multiple DOS sessions programs need to 
  126.         be started with a wait option is not to use the /WAIT option from 
  127.         HSTART but use HWAIT both for waiting and signaling.
  128.  
  129.         See 'HWAIT.TXT' for more details.
  130.  
  131.  
  132. FILES
  133. =====
  134.  
  135. HSTART.EXE   : the main program
  136.  
  137. HWAIT.EXE    : A program that sends a signal to a DOS version of HSTART.
  138.  
  139. SEMFUNCS.DLL : Needed for HWAIT to work in OS/2 sessions. Make sure this
  140.                file is located in a location pointed at by the LIBPATH=
  141.                from your CONFIG.SYS.
  142.  
  143.  
  144. HISTORY
  145. =======
  146.  
  147. Version 0.8: Initial release.
  148.  
  149. Version 0.9: /WAIT option added
  150.              HWAIT.EXE added.
  151.  
  152.  
  153. Version 1.0: Changed the program so it works when using CSHELL.
  154.              You should not use /MAX or /MIN options then.
  155.  
  156. Version 1.1: Corrected a problem that occured when from a foreground session
  157.              was tried to be started from a OS/2 background session. 
  158.              OS/2 will then return a errorcode indicating that it was unable
  159.              to start the session in the foreground and the session is started
  160.              in the background. The problem only occured when HSTART was
  161.              used the /WAIT option. Due to the errorcode HSTART would terminate
  162.              itself without waiting and by terminating itself also terminate
  163.              the started session. Now HSTART will continue to wait if 
  164.              this error occurs.
  165.  
  166. Version 1.2: Oops, just noticed that the version number in the program itself
  167.              was not updated to 1.1. Now it is 1.2.
  168.  
  169.              Corrected a problem when HSTART was used more then once from an 
  170.              OS/2 session with the /WAIT option. The problem was that HSTART
  171.              needs to create a queue for the /WAIT option to function, and
  172.              HSTART did not use unique queue names per instance. Now HSTART
  173.              uses unique queue names.
  174.  
  175.              When HSTART is used from a DOS session to start any other session
  176.              HSTART creates a named semaphore to realise the /WAIT function.
  177.              I have not found a way to let HWAIT (which is needed to signal
  178.              the waiting DOS session to continue) know which semaphore name
  179.              to signal. 
  180.