home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / CLIPPER / MISC / AIWAIT10.ZIP / AIWAIT.DOC next >
Encoding:
Text File  |  1990-12-18  |  5.1 KB  |  149 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.         A       I       W       A       I       T
  22.  
  23.  
  24.         Artificial Intelligence File Detection Delay
  25.  
  26.  
  27.         Release 1.0         12/20/90
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.        From: PHANTASM Software
  35.        By: Keith Luken
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.        (C)opyright 1990 PHANTASM Software
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54. SUMMARY
  55.  
  56.         AIWAIT is a utility that has many uses. In its basic form AIWAIT will
  57.         periodically check foe the existence of a file you pass to it. Upon
  58.         detection of the file AIWAIT will proceed to do whichever function you
  59.         have told it to perform. AIWAIT is ideal in BBS and or LAN enviornments
  60.         where one system is waiting for an indication from another that it is ok
  61.         to proceed. AIWAIT is flexible in that you tell it what to do if the
  62.         file is found and what to do if it not. You also tell AIWAIT how often
  63.         to look for the target file and or the maximum time to look for it.
  64.         AIWAIT works with options you pass it as command line switches. The
  65.         following switches provide the following functions and will be explained
  66.         in deatil.
  67.  
  68.         /F:     The path/file to check for
  69.         /R:     The command to be executed if the check file is found (Optioanl)
  70.         /C:     The command to be executed if check file is NOT found (Optional)
  71.         /D:     Number of seconds between file checks  (Optional)
  72.         /M:     Maximum number of minutes to keep checking (Optional)
  73.  
  74.         All but the FILE to check for are optional. If the /R: and /C: switches
  75.         are not included then AIWAIT just ends when file is or isn't found, thus
  76.         it would be ideal for ending a batch file. If /D: is not included then
  77.         the default will be 30 seconds. IF /M: is not included then AIWAIT will
  78.         not time out and will continue checking until found or any key is hit.
  79.  
  80.  
  81.         Examples:
  82.  
  83.         AIWAIT /F:alldone.txt /D:10 /R:reboot.com /M:15
  84.                 AIWAIT will check every 10 seconds for a file call ALLDONE.TXT
  85.                 and when found will execute REBOOT.COM. If the file is not found
  86.                 in 15 minutes then AIWAIT will end.
  87.  
  88.         AIWAIT /F:c:\alldone.txt /D:60 /R:reboot.com /C:event.bat /M:10
  89.                 AIWAIT will check every 60 seconds for a file C:\ALLDONE.TXT for
  90.                 up to 10 minutes and if found will execute /R:reboot.com and if
  91.                 NOT found then EVENT.BAT will be run.
  92.  
  93.         AIWAIT /F:alldone.txt /C:event.bat /M:20
  94.                 AIWAIT will check every 30 seconds(DEFAULT) for file ALLDONE.TXT
  95.                 for up to 20 minutes and if found will just end. If file is NOT
  96.                 found in 20 minutes then EVENT.BAT will execute.
  97.  
  98.         AIWAIT /F:alldone.txt /R:reboot.com
  99.                 AIWAIT will check every 30 seconds(DEFAULT) for file ALLDONE.TXT
  100.                 and when found will execute REBOOT.COM. AIWAIT will wait forever
  101.                 unless a key is hit unless the file is found.
  102.  
  103.  
  104.                                                      (C)1990 PHANTASM Software
  105.  
  106.  
  107.  
  108. USAGE
  109.         Upon exiting AIWAIT the DOS ERRORLEVEL is set based on AIWAITS outcome
  110.         as follows:
  111.                 1       User aborted
  112.                 2       Check file NOT found within timeout period
  113.                 3       Check file found
  114.                 4       Check file name not provided, AIWAIT aborted
  115.  
  116.         Hitting any key while AIWAIT is running will cause it to end the next
  117.         time it checks for the file. AIWAIT executes the commands you tell it to
  118.         by stuffing the keyboard buffer upon termination. This is important
  119.         since if you call AIWAIT from within a batch file then the what it try
  120.         to execute will not occur until after the batch file that called it.
  121.         Also if you have it set up to just end then if it was called from within
  122.         a batch file then that batch file will continue. AIWAIT also clears the
  123.         keyboard buffer when it runs thus anything you type ahead will be lost.
  124.         I wrote this utitlity to help rebooting my 3 system BBS LAN more
  125.         flexible during it's daily event. I think I included enough options to
  126.         make everyone happy to allow batch files to be even more flexible, if I
  127.         get some demand for it.
  128.  
  129. DISCLAIMER
  130.         The usual legal stuff here, the author CAN NOT and WILL NOT be liable
  131.         for any damge caused by the USE or MISUSE of this software. Not warranty
  132.         is either expressed or implied.
  133.  
  134. SUPPORT
  135.         I provide this utility FREE of charge and only ask that if you use it
  136.         and find it helpful that you pass it along and tell people about my BBS.
  137.         The latest copy of this and other helpful utilties can be found on
  138.         PHANTASM BBS 908-291-2302(USR DUAL) or 908-291-4134(HAYES ULTRA).
  139.         If you have any comments(good or bad) on this software I would like to
  140.         hear them so please call! If you have any problems using it feel free to
  141.         call my BBS and ask for help!
  142.  
  143.  
  144.  
  145.  
  146.  
  147.                                                 (C)1990 PHANTASM Software
  148.  
  149.