home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / appwait.zip / AppWait.txt < prev    next >
Text File  |  1996-11-01  |  8KB  |  252 lines
  1.  
  2.  AppWait Readme                  Copyright 1996, Darren V. Croft 
  3.  
  4.  Version 1.0                                          (10/30/96) 
  5.  ================================================================ 
  6.  
  7.  
  8.  Description 
  9.  ----------- 
  10.  AppWait allows applications stored on a network drive to be 
  11.  placed in the OS/2 startup folder. Until the executable and 
  12.  working directory drive letters are available, AppWait presents 
  13.  a dialog that displays, "Waiting for X:". 
  14.  
  15.  Program icons set up with AppWait behave just like normal 
  16.  program icons. For instance, if the application is minimized, 
  17.  double clicking on the icon brings the application to the 
  18.  foreground. 
  19.  
  20.  
  21.  Shareware version 
  22.  ----------------- 
  23.  There are only visual differences between the shareware version 
  24.  and the version you will receive upon registration. 
  25.  
  26.  On the shareware version the waiting dialog displays the 
  27.  following additional words: 
  28.  
  29.  "Unregistered shareware" 
  30.  "dvc@ibm.net" 
  31.  
  32.  You may use the shareware version only for evaluation purposes. 
  33.  At the conclusion of your evaluation please register as detailed 
  34.  in Register.txt ($10 personal license, $100 site license). 
  35.  
  36.  
  37.  Limitations 
  38.  ----------- 
  39.  OS/2 executables work very well with AppWait. OS/2 command files 
  40.  and DOS and Windows executables currently have some limitations. 
  41.  
  42.  There is no way to specify DOS or Windows Settings -- the 
  43.  defaults are always used. 
  44.  
  45.  Windows applications, DOS .bat files, and OS/2 .cmd files wait 
  46.  only for the working directory drive. This is fine if the 
  47.  executable is on a local drive or on the same drive as the 
  48.  working directory you specify. 
  49.  
  50.  
  51.  How does it work? 
  52.  ----------------- 
  53.  AppWait is a small PM program. It takes as parameters the 
  54.  information needed to run your application. 
  55.  
  56.  Simply create a program object for AppWait with the application 
  57.  info, put it in the startup folder, and you're done. 
  58.  
  59.  
  60.  AppWait Useage 
  61.  -------------- 
  62.  OS/2 or DOS executable: 
  63.     AppWait  APP_NAME  APP_WORKING_DIRECTORY  PARAMETERS_FOR_APP 
  64.  
  65.  OS/2 .cmd file: 
  66.     AppWait cmd.exe WORK_DIRECTORY /cCMD_NAME PARAMS_FOR_CMD 
  67.  
  68.  DOS .bat file: 
  69.     AppWait command.com WORK_DIRECTORY /cBAT_NAME PARAMS_FOR_BAT 
  70.  
  71.  Windows programs: 
  72.     AppWait winos2.com WORK_DIRECTORY APP_NAME PARAMS_FOR_APP 
  73.  
  74.     (if this doesn't work on Warp red spine, try win.com 
  75.      instead of winos2.com) 
  76.  
  77.  
  78.  The following are step by step instructions to set up a program 
  79.  object with AppWait: 
  80.  
  81.  1. Create a new program object 
  82.  
  83.     You can drag a program object off the Program template 
  84.     in the templates folder 
  85.  
  86.     You can click on a program object and type create another. 
  87.  
  88.     Or, you can modify a program object you already have for your 
  89.     app. 
  90.  
  91.  2. On the program page of the object, fill in the path and file 
  92.     name field with AppWait.exe 
  93.  
  94.     If you haven't installed AppWait to a directory on your path, 
  95.     you must enter the full path name. (For instance, if you have 
  96.     Appwait in c:\utilities, enter c:\utilities\appwait.exe) 
  97.  
  98.  3. In the parameters field, supply information about your 
  99.     app. 
  100.  
  101.     For OS/2 or DOS executables, this information should be 
  102.     entered in the following order: 
  103.     a. Full path to the executable 
  104.     b. Full path of the working directory 
  105.     c. Parameters for your app 
  106.  
  107.     For OS/2 .cmd files, enter the following in the parameters 
  108.     field: 
  109.     a. cmd.exe 
  110.     b. Full path of the working directory 
  111.     c. /cFILENAME.CMD  where FILENAME.CMD is the name of your 
  112.        command file. (You can include the path if needed.) 
  113.     d. Parameters for your command file. 
  114.  
  115.     For DOS.bat files, enter the following in the parameters 
  116.     field: 
  117.     a. command.com 
  118.     b. Full path of the working directory 
  119.     c. /cFILENAME.BAT  where FILENAME.BAT is the name of your 
  120.        batch file. (You can include the path if needed.) 
  121.     d. Parameters for your batch file 
  122.  
  123.     For Windows programs, enter the following in the parameters 
  124.     field: 
  125.     a. winos2.com  (try win.com if this doesn't work) 
  126.     b. Full path of the working directory 
  127.     c. The executable name. (You can include the path if needed.) 
  128.     d. Parameters for your app 
  129.  
  130.  
  131.  4. The working directory field of the AppWait object can be left 
  132.     blank. It is overidden by the working directory passed to 
  133.     appwait. 
  134.  
  135.  5. Set the icon for the program object. 
  136.  
  137.     This can be done in several ways. Here is one method: 
  138.     a. Open the settings of an object that has the correct icon. 
  139.     b. Change to the general page. 
  140.     c. Press the edit button and the icon editor should open. 
  141.     d. Choose File Save, and enter a temporary name. 
  142.     e. Use the drives object to open the folder where you 
  143.        temporarily saved the icon. 
  144.     f. Change to the general page of the AppWait object you are 
  145.        creating, and drag and drop the icon from the folder onto 
  146.        the icon area of the general page. 
  147.  
  148.  
  149.  Useage Examples 
  150.  --------------- 
  151.  The following examples assume you have AppWait.exe in the 
  152.  c:\util directory, and the c:\util directory is not in your 
  153.  path. 
  154.  
  155.  ** Example: OS/2 executable ** 
  156.  A program object with the following settings will start Describe 
  157.  from the h: drive with a default directory of c:\describe. The 
  158.  file name c:\describe\data\todo will be passed as a parameter. 
  159.  
  160.  Path and file name field: 
  161.   c:\util\appwait.exe 
  162.  
  163.  Parameters field: 
  164.   h:\describe\describe.exe c:\describe c:\describe\data\todo 
  165.  
  166.  Working directory field: 
  167.  
  168.  
  169.  
  170.  ** Example: DOS executable ** 
  171.  A program object with the following settings will start 
  172.  Wordperfect from the h: drive with a default directory of 
  173.  h:\wpData, and the file name h:\WpData\todo will be passed as a 
  174.  parameter. 
  175.  
  176.  Path and file name field: 
  177.   c:\util\appwait.exe 
  178.  
  179.  Parameters field: 
  180.   h:\wp51\wp.exe h:\wpData h:\WpData\todo 
  181.  
  182.  Working directory field: 
  183.  
  184.  
  185.  
  186.  ** Example: OS/2 command file ** 
  187.  A program object with the following settings will run the 
  188.  command file copyNew.cmd with a working directory of 
  189.  f:\newfiles, and pass c:\latest as a parameter. 
  190.  
  191.  Path and file name field: 
  192.   c:\util\appwait.exe 
  193.  
  194.  Parameters field: 
  195.   cmd.exe f:\newfiles /ccopyNew.cmd c:\latest 
  196.  
  197.  Working directory field: 
  198.  
  199.  
  200.  
  201.  ** Example: DOS batch file ** 
  202.  A program object with the following settings will run the batch  
  203.  file copyNew.bat with a working directory of f:\newfiles, and 
  204.  pass c:\latest as a parameter. 
  205.  
  206.  Path and file name field: 
  207.   c:\util\appwait.exe 
  208.  
  209.  Parameters field: 
  210.   command.com f:\newfiles /ccopyNew.bat c:\latest 
  211.  
  212.  Working directory field: 
  213.  
  214.  
  215.  
  216.  ** Example: Windows Program ** 
  217.  A program object with the following settings will run America 
  218.  Online with a working directory of m:\aol30. 
  219.  
  220.  Path and file name field: 
  221.   c:\util\appwait.exe 
  222.  
  223.  Parameters field: 
  224.   winos2.com m:\aol30\aol.exe m:\aol30 
  225.  
  226.  Working directory field: 
  227.  
  228.  
  229.  
  230.  Possible Enhancements 
  231.  --------------------- 
  232.  The following enhancements will be considered if there is enough 
  233.  demand. 
  234.  
  235.  1. Specify DOS and Windows program settings.
  236.  2. Wait on the the drive where the command file, batch file, or
  237.     Windows program resides (when different from working drive).
  238.  3. Execute a specific command file or other program when a
  239.     drive isn't available (With this capability, you could have
  240.     an object that would NET USE the drives if needed.)
  241.  4. Wait on other drives in addition to the executable and
  242.     working directory drive.
  243.  5. Have an application wait for another specific application in
  244.     addition to waiting for the network drives (In this way you
  245.     could enforce startup order for network apps.)
  246.  6. A new WPS class that would create a "Network Program"
  247.     Object providing ExeWait functionality and a settings page
  248.     to control it.
  249.  
  250.  
  251.  Please let me know your needs by sending email to dvc@ibm.net 
  252.