home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 1 / GoldFishApril1994_CD1.img / d1xx / d161 / nag / runback.doc < prev    next >
Text File  |  1988-10-02  |  4KB  |  101 lines
  1. ReadMe for "RunBack"
  2.  
  3. RunBack is a program that allows you to start another program which is
  4. independant of the CLI window.  This is particularly useful if you want
  5. to start a program in you Startup-Sequence and then load the WorkBench,
  6. closing the initial CLI.  Without RunBack, the original CLI window cannot
  7. be closed until the programs Run from that CLI have terminated.
  8.  
  9. This program is being distributed as a service to owners of FastFonts,
  10. as RunBack is particularly useful with the FunKeys hotkey program included
  11. with FastFonts.  This program, source and ReadMe are Copyright 1987,
  12. Microsmiths Inc and may only be distributed together in their original
  13. unmodified state. Bug reports will be appreciated.
  14.  
  15. FastFonts owners, please be sure to send in your registration cards!  We
  16. will be sending a notice of a *FREE* update for owners of FastFonts V1.0
  17. that fixes some minor bugs and adds a few enhancements to the various
  18. programs included with FastFonts.  Notices will be sent early in April '87
  19. to registered FastFonts owners.
  20.  
  21.     Microsmiths, Inc, PO Box 561, Cambridge, MA 02140
  22.     (617) 354-1224    BIX: cheath  Compuserve: 74216,2117
  23.  
  24. RunBack was inspired by the "C" program RunBackground written by *Rob Peck*
  25. of Amiga.  RunBack also allows you to specify the stack size for the
  26. program being started.  Also, RunBack is about 1/4 the size of the original
  27. RunBackground as it is written in assembler.
  28.  
  29. The following description comes from the original runbackground.c:
  30.  
  31. ***************************************************************************
  32. --------------
  33. runbackground.c  
  34. ---------------
  35.  
  36. SUMMARY:  A Workbench Disk can be used to autostart an application
  37.       through the use of the startup script and close the startup CLI.
  38.  
  39.  
  40. Users have commented that it is not possible to start a process going 
  41. from the startup script and then cause the initial CLI to go away.   
  42. Here is the solution to that problem, named appropriately:
  43.  
  44.     RUNBACKGROUND
  45.  
  46. which starts and runs a background task.  This does indeed allow you to
  47. create a startup script that will set up your workbench running any
  48. programs you might wish, removing the initial CLI in the process.
  49.  
  50. Your s/startup-sequence can contain lines such as the following:
  51.  
  52.     RUNBACKGROUND -3 clock
  53.     RUNBACKGROUND utilities/calculator
  54.     RUNBACKGROUND -5 utilities/notepad
  55.  
  56. where RUNBACKGROUND is the command and the second parameter is the filename
  57. which may be preceded by a flag-variable that specifies an optional delay 
  58. time.  The delay can be from 0 to 9, for the number of seconds that 
  59. the startup script should sleep while allowing the background task to 
  60. load and start.  I've put that in to minimize thrashing of the disk as it
  61. tries to load several projects at once.
  62.  
  63.  
  64. LIMITATIONS:
  65.  
  66.     The program that you run cannot require any input from an interactive
  67.     CLI that starts it.    Additionally, you cannot specify any file 
  68.     redirection in the command line since this program provides the
  69.     redirection for you already.  If you need to use redirection for
  70.     your command, you can modify the source code where shown, thus
  71.     allowing the redirection to become one of the parameters passed
  72.     through to your program.
  73.  
  74.     RUNBACKGROUND does pass your command line parameters to the program
  75.     you wish to start, but limits the total length of your command
  76.     string to 227 (255 minus the 28 characters for "RUN >NIL: <NIL: " 
  77.     preceding your own file pathname and ">NIL: < NIL: " following it.)
  78.  
  79.  
  80. **********************************************************************
  81.  
  82. The command line for RunBack is the same as RunBackground, with the
  83. addition of a Stack parameter -Snnnn.  This will allow you to adjust
  84. the size of the stack for the program being started.
  85. For example, the command:
  86.  
  87.     1> RunBack -S2000 FunKeys
  88.  
  89. will start FunKeys with a stack size of 2000.
  90.  
  91. As with the original RunBackground, you must be careful not to try run
  92. a non-executable file or AmigaDOS will cause a GURU.  However, it is safe
  93. to use RunBack if the command does not exist.  Just be careful not to
  94. accidentally RunBack a data file.  Since you normally would use RunBack
  95. in your Startup-Sequence, this shouldn't be a problem.
  96.  
  97. To start FunKeys in your Startup-Sequence, assuming you have copied FunKeys
  98. into your C: directory, use:
  99.  
  100. 1> RunBack -S2000 c:FunKeys [your FunKeys preferences]
  101.