home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / hstart05.zip / hwait.txt < prev    next >
Text File  |  1993-10-25  |  3KB  |  103 lines
  1.                       === DISCLAIMER ===
  2.  
  3.  
  4. I allow you to use and distribute HWAIT 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 HWAIT
  12. ===============
  13.  
  14. HWAIT is a program that makes it possible to synchronize events in different
  15. sessions. You can do this by starting HWAIT with a parameter that tells 
  16. HWAIT to wait for a named signal from another session.
  17. In the other session you can start HWAIT with another parameter to send a
  18. named signal.
  19.  
  20. Without parameters HWAIT assumes you have used HSTART in a DOS session with
  21. the /WAIT parameter, and the program sends the default signal to HSTART.
  22.  
  23. HWAIT will only work on OS/2 2.1. (Both OS/2 and DOS sessions)
  24.  
  25.  
  26. USING HWAIT
  27. ============
  28.  
  29. Before HWAIT can be used make sure you have placed the file 'SEMFUNCS.DLL'
  30. in a directory that is included in your 'LIBPATH' statement from your
  31. config.sys.
  32.  
  33.  
  34.  
  35.         HWAIT [options]
  36.  
  37.         Valid options are:
  38.  
  39.         HWAIT /W:xxxxx          Wait for a signal with xxxxx as name.
  40.  
  41.         HWAIT /S:xxxxx          Send named signal with xxxxx as name.
  42.  
  43.         HWAIT /?                Show the help screen
  44.  
  45.         The last two options are mutually exclusive.
  46.  
  47.         Without any parameters HWAIT assumes you have used HSTART in a 
  48.         DOS session with the /WAIT parameter and sends the default signal.
  49.  
  50.    
  51. A signal can only be send if in another session HSTART or HWAIT are waiting
  52. for it, otherwise HWAIT will give an error message.
  53.  
  54.  
  55. HISTORY
  56. =======
  57.  
  58. Version 0.9: Initial release
  59.  
  60.  
  61. EXAMPLE 1:  using hstart with /WAIT from a dos session
  62. ==========
  63.  
  64.         HSTART "Binkley term" /fs /wait e:\binkley\bink1.cmd
  65.  
  66.         contents of 'bink2.cmd':
  67.         ------------------
  68.         E:
  69.         CD \BINKLEY
  70.         BTP
  71.         E:\OS2TOOLS\HWAIT <- default: signals to hstart to continue
  72.         -----------------
  73.  
  74. EXAMPLE 2:  using hstart & hwait as seperate programs
  75. ==========
  76.  
  77.         contents of 'bink.bat'
  78.         -------------------------
  79.         HSTART "Binkley term" /FS e:\binkley\bink2.cmd
  80.         HWAIT /W:BINK2             <- wait for signal BINK2
  81.         -------------------------
  82.  
  83.         contents of 'bink2.cmd
  84.         -------------------------
  85.         E:
  86.         CD \BINKLEY
  87.         BTP
  88.         E:\OS2TOOLS\HWAIT /S:BINK2 <- send signal 'BINK2'
  89.         -------------------------
  90.  
  91. Note: In the two examples above a DOS and a OS/2 session is being used.
  92.       This could also be signaling between DOS/DOS or OS/2/OS2 sessions.
  93.  
  94.       Also, in the 2nd example HSTART is being used, this could of 
  95.       course also be another program like OS/2's START or STARTD.
  96.         
  97.  
  98.  
  99.  
  100.         
  101.         
  102.  
  103.