home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: OtherApp / OtherApp.zip / ellie03.zip / seti.txt < prev    next >
Text File  |  1999-07-06  |  3KB  |  75 lines
  1. SETI.EXE, a way of providing mutex semaphoring for setihome when launched
  2. by setihome monitors or other methods.  It also provides a means for GUI
  3. applications to configure SETIHOME sessions along with definable process to
  4. execute before and after each client session.
  5.  
  6. Run seti.exe from the command line for usage, for example:
  7.  
  8. SETI.EXE v.12 (0201570699) (c) AiG (UK)[ch/Ellie].
  9. This program is designed to be run and controlled by supported SETIHOME.EXE
  10. monitoring applications to provide crude mutex support for client sessions.
  11. To ensure reducing the risk of having multiple copies of setihome.exe running,
  12. please use this 'wrapper' program. For more information on enabling your
  13. program to utilize its features, or suggestions to improve on it please
  14. contact: ellie@Cee3.demon.co.uk.
  15.  
  16. Usage:
  17.  seti.exe
  18.         │
  19.         └─/VIO/parameters/owner/preprocess/postprocess/logfile/
  20.             │       │       │       │       │           │
  21.             │       │       │       │       │           └─ session logfile
  22.             │       │       │       │       └─ process to run after client
  23.             │       │       │       └─ process to run before client
  24.             │       │       └─ owner app of this session
  25.             │       └─ standard command line parameters for setihome.exe
  26.             └─ VIO screen attributes
  27. Example:
  28.  
  29.  seti.exe /NORMAL/-nice 1/ELLIE/BackupLog.cmd/NONE/setisession.log/
  30.  
  31.  
  32.  
  33. Notes:
  34.  
  35. VIO -   currently NORMAL or MINIVIO.  The seticlient.exe detects the presence
  36.     of 4OS2 and subsequent versions will offer increased functionality with
  37.     this in mind (like choosing where SETIHOME will display, how big,
  38.     with/without title bars etc etc...)
  39.  
  40. Pre/Postprocess processes MUST be VIO mode programs.  Furthermore, these
  41. programs MUST NOT 'return' or 'EXIT'.  I had a version which allowed PM
  42. programs to be 'START'ed and allowed for return codes to be returned.
  43. Seems to have gone astray!
  44.  
  45. The mutex mechanism is a simply by means of a file (SETIHOME.MUX in the SETI
  46. directory) held open for the course of the session which is then closed.
  47. This is a lot faster than creating/deleting files for seticlient.exe and
  48. for third party apps checking the mutex.  Furthermore, there is no need to
  49. tidy up orphaned mutex files at startup as OS/2 will close (and thus release)
  50. the mutex on shutdown.
  51.  
  52.  
  53. LESETI v1.  Command line tool to start and stop an Ellie S@H object
  54.             with Object title message support.
  55. LESETI START or STOP [Message]
  56.         │        │     └─ Optional message for desktop object
  57.         │        └─ to stop Ellie's s@h client and update desktop object
  58.         └─ to start Ellie's s@h client and update desktop object
  59.  
  60. LESETI returns:    0 for successful completion
  61.                    2 Unable to locate Ellie components
  62.                    3 Unable to find SETIHOME.MUX mutex sem4 file
  63.                    4 Unable to find kill component in Ellie directory
  64.  
  65.  
  66.  
  67.  
  68. Feedback welcome..
  69.  
  70. Clive (et@Cee3.demon.co.uk)
  71.  
  72.  
  73.  
  74.  
  75.