home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / de102.zip / de.doc < prev    next >
Text File  |  1994-02-11  |  11KB  |  240 lines
  1. 1.02.00
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  ╥──┐ ╥──┐ ╓─╥─┐ ╥──┐ ╓──┐ ╓─╥─┐    │    ╥──┐ ─╖ ┌ ╥──┐ ╓──┐ ╥  ┬ ╓─╥─┐ ╥──┐
  14.  ║  │ ╟─     ║   ╟─   ║      ║    ┌─┼──  ╟─   ╓╨┬┘ ╟─   ║    ║  │   ║   ╟─
  15.  ╨──┘ ╨──┘   ╨   ╨──┘ ╙──┘   ╨    └─┘    ╨──┘ ╜ └─ ╨──┘ ╙──┘ ╙──┘   ╨   ╨──┘
  16.  
  17.                            Detect & Execute for OS/2
  18.                                  Version 1.02
  19.                (c) Copyright 1993, 94 Simon & Pat Board, Simon Ma
  20.                          (fidonet address 6:700/443.0)
  21.                               All rights reserved
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                                                          Some notes
  34.                                                          ----------
  35.  
  36.         * Should problems occur, or you find bugs, please report it
  37.           in netmail, stating the system you have, programs you are 
  38.           running, and  error  message  the  program  printed  out.
  39.           Please  don't try  to report  or complain  anything about 
  40.           this product in the  echomail, if  you use it, it implies 
  41.           that you respect and obey to these rules.
  42.  
  43.         * The author  bear no responsibilty for any damages on your
  44.           system originated from using this product.  If  you agree 
  45.           to use this program, you are already imply that you agree
  46.           to this term.
  47.                        
  48.                                                          Disclaimer
  49.                                                          ----------
  50.  
  51.         The  Using of Detect & Execute is subject to the  following  
  52.         license terms and conditions.
  53.  
  54.         The  Detect & Execute package is  supplied  as  it  is. The  
  55.         author  disclaims  all warranties,  expressed  or  implied, 
  56.         including,   without    limitation,  the   warranties    of 
  57.         merchantability  and  of  fitness  for   any  purpose.  The  
  58.         author   assumes   no  liability  for  damages,  direct  or  
  59.         consequential,  which may result  from the use  of the this
  60.         package.
  61.  
  62.         This package is  a "freeware program"  and  is provided and 
  63.         used at no charge to the user for  evaluation. Feel free to
  64.         share it with  your friends, but please do not give it away
  65.         altered  or  as  part of  another  system.  The essence  of
  66.         "user-supported"  software is  to provide personal computer
  67.         users with  quality software without  high prices, and  yet
  68.         to  provide   incentive  for  programmers  to  continue  to
  69.         develop new products.
  70.  
  71.         This package,  all programs,  the  documentation  and other
  72.         support files are  copyrighted 1994 by Simon Ma. All rights 
  73.         are  reserved.   You  may  copy  this  package  for  backup 
  74.         purposes. You may also copy and share unmodified copies  of
  75.         the whole package,  providing that the copyright notice  is
  76.         reproduced and included on all copies.
  77.  
  78.         You may not  sell the  product for a fee  and/or distribute
  79.         the product  along  with  other  products  without  written
  80.         permission,  nor may  you modify  or  remove the  Copyright
  81.         Notices from the programs or the  documentation files. User
  82.         clubs, if they  are NOT  commercial, are allowed  to ask  a
  83.         small amount  of money  for distribution  and storage  when
  84.         they want to share this package amongst their members.
  85.  
  86.         It  is  forbidden  to  modify,  adapt,  translate,  reverse
  87.         engineer, decompile and/or disassemble the software in this
  88.         package.   Patching   the  medium   at  places  that  carry
  89.         the software  is  seen  as a  program  change and  is  also
  90.         forbidden.
  91.                        
  92.                                             Contents of the archive 
  93.                                             -----------------------
  94.  
  95.         DE.EXE        - Detect & Execute v1.02 Executable File
  96.         DE.DOC        - Documentation of DE, you are reading it now
  97.         DE.ICO        - 16 color VGA resolution icon for DE.EXE
  98.         README.1ST    - Read it before running the program
  99.         WHATSNEW.102  - What's new in this version
  100.                        
  101.                                          What is Detect & Execute ?
  102.                                          --------------------------
  103.  
  104.         Detect & Execute is a very simple utility that allow you to 
  105.         detect whether an application is running (that exist in the
  106.         PID list) or dead, if the application is not found, DE will
  107.         start it over again. There will be 2 chance given to DE to
  108.         detect the application, where the time between the 2 detect
  109.         can be defined in command line.
  110.  
  111.         Since  Detect & Execute  is using  the native  functions of
  112.         OS/2,  there won't  be DOS version  nor Windows  version (I 
  113.         don't  interested  in develop it either)  available.  Don't
  114.         blame me if you can't run it in DOS.
  115.                               
  116.         This  program is especially useful for  use with BBS system
  117.         to detect whether the BBS is downed or not.  You can use it
  118.         together with  the  ALARM (tm) from OS/2 package so DE will
  119.         be executed, say,  every hour to detect whether your BBS is
  120.         "killed" and need to start all over.
  121.  
  122.                                                            Features
  123.                                                            --------
  124.  
  125.         For details of additional functionality,  please refer back 
  126.         to WHATSNEW.102 for further reference.
  127.  
  128.                                                 System Requirements
  129.                                                 -------------------
  130.  
  131.         -   IBM  or  IBM  clones (80x86  CPU) with 100%  compatible
  132.         -   XGA-2/VGA/EGA/CGA/MGA compatible  graphic display  card
  133.         -   At least 256K RAM.
  134.         -   IBM OS/2 2.X preferred.
  135.         -   Hard disk is optional
  136.  
  137.  
  138.                                                Command Line Options
  139.                                                --------------------
  140.  
  141.         DE.EXE <option 1> <option 2> <option 3>
  142.  
  143.         where Option 1 stands for path+filename to detect
  144.               Option 2 stands for path+filename  to  execute   when
  145.                                   option 1 not found
  146.               Option 3 stands for seconds between 2 search
  147.  
  148.                                                         Errorlevels
  149.                                                         -----------
  150.  
  151.         Program will return ERRORLEVEL back  to OS/2 Command Prompt
  152.         whenever exiting, respective values stands :
  153.  
  154.         0       Normal Exit
  155.         1       Invalid Command Options
  156.         2       Unrecoverable Application Errors
  157.                                                         
  158.                                                        Restrictions
  159.                                                        ------------
  160.  
  161.         -   On some system, DE.EXE cannot be run under OS/2 Windows
  162.             but in Full Screen OS/2 Prompt, this bug is confined to
  163.             only a few system,  most system should run this without
  164.             problems
  165.                                                        
  166.                                                      Report of bugs
  167.                                                      --------------
  168.  
  169.         If   you  want   to  report  a  bug,   or  any  suggestions  
  170.         (highly   recommended),  please  do  it  either  in  OS2BBS 
  171.         fidonet  echo (be  careful  of mail loss) or  in netmail to 
  172.         6:700/443.0@fidonet.org. In the content, please include the 
  173.         following informations :
  174.  
  175.           -  Versions of OS/2 you are running (e.g. 2.1GA, OS/2 for 
  176.              Windows)
  177.           -  The  program  you  use   DE.EXE  with,  if  available,  
  178.              include its versions. 
  179.           -  Versions  of  4OS2 (or CMD.EXE),  with the information 
  180.              generated by the SYSLEVEL.EXE command.
  181.           -  Any other information you think useful.
  182.  
  183.                                                           Copyright
  184.                                                           ---------
  185.  
  186.         All brand  and product names  are copyrighted (c) material,
  187.         Trademarks (tm)  and  Registered (R)  Trademarks  of  their
  188.         respective holders :
  189.  
  190.         IBM, PC-DOS, OS/2     International Business Machines Corp.
  191.                                                         
  192.                                                            Warranty
  193.                                                            --------
  194.  
  195.         Of  course,  I  DON'T  guarantee any  kind  of loss of data 
  196.         because of the use of DE.EXE (even you are sure or not),  I 
  197.         can  ONLY  guarantee it occupies  a certain  amount of disk 
  198.         space. DON'T BLAME ME. 
  199.                                                        
  200.                                                             Credits
  201.                                                             -------
  202.  
  203.         Many thanks to all the beta testers for their contributions
  204.         the time they spent testing the programs, reporting problem
  205.         and  making  suggestions. This  is really  a  cliche, but I 
  206.         really couldn't have done it  without time.  Listing all of 
  207.         them here would tak too much space,  but I would especially 
  208.         like  to  thank  to  the  following  people,  listed  in no 
  209.         particular order.
  210.  
  211.                                           How to contact the Author
  212.                                           -------------------------
  213.  
  214.         If you want to contact the author for  any reasons,  OS2BBS 
  215.         fidonet echo or netmail to 6:700/443.0@fidonet.org (or fax, 
  216.         if you like) is the way to  go.  Netmail is the fastest way 
  217.         to go  since my  hub doesn't  always  receive  OS2BBS  echo 
  218.         stably.  So if you don't receive my reply in fidonet OS2BBS 
  219.         echo don't be angry.  The mail may probably get lost on the 
  220.         way.
  221.                                                        
  222.                                            Version Numbering Scheme
  223.                                            ------------------------
  224.  
  225.         Version number are determined using the following schemes :
  226.  
  227.                 X.XX
  228.                 │ ││
  229.                 │ ││
  230.                 │ ││
  231.                 │ │└──────── Incremented on bug fixes/minor feature
  232.                 │ └───────── Incremented on major feature updates
  233.                 └─────────── Incremented on major revisions
  234.  
  235.  
  236.  
  237.  
  238.  
  239. REF: DE.DOC/Rev021194
  240.