home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 3: The Continuation / 17-Bit_The_Continuation_Disc.iso / amigan / amigan 15 / runback / runback.doc < prev    next >
Encoding:
Text File  |  1994-01-27  |  3.2 KB  |  69 lines
  1.                         DOCUMENT FILE FOR RUNBACK
  2.  
  3. This is an old program, originally called Runbackground and originally
  4. written by Rob Peck, taken from one of the Fred Fish disks and modified by
  5. several programmers whose names were not included on the disk sent to us.
  6. It will load a program into the Amiga and run it in the background, without
  7. its being attached to the CLI where it was started.
  8.  
  9. Do NOT use it with any program which requires a CLI window for any user
  10. choices or input. Similarly, do NOT use it with any program which already
  11. runs in the background, such as ConMan, BlitzFonts, Heliosmouse,
  12. ClicktoFront, or the latest versions of PopCli (PopCli III). In particular,
  13. don't use it with any program compiled with CBack.o to run in the
  14. background.
  15.  
  16. Now for what it WILL do: it will run in the background any program which
  17. demands no CLI window. Many early utilities (such as POPCLI II), if run in
  18. a CLI, used and tied up that CLI until the end of a session. Such utilities
  19. can be run with RUNBACK; they free themselves from the CLI window, which
  20. can be ended or closed any time thereafter--while the program remains
  21. active.
  22.  
  23. RunBack can be used from CLI or in a startup script thus:
  24.  
  25.       1> runback df1:myprog   [where myprog is the one to load and use]
  26.  
  27.       1> runback -snnnn df1:myprog [where -snnnn is the stack size wanted]
  28.  
  29. More options are available. See the docs below, furnished by Rob Peck, on
  30. his original RunBackGround. This program seems to follow Rob's description.
  31. ***************************************************************************
  32.  
  33. Users have commented that it is not possible to start a process going
  34. from the startup script and then cause the initial CLI to go away.
  35. Here is the solution to that problem, named appropriately:
  36.  
  37.         RUNBACKGROUND
  38.  
  39. which starts and runs a background task.  This does indeed allow you to
  40. create a startup script that will set up your Workbench running any
  41. programs you might wish, removing the initial CLI in the process.
  42.  
  43. Your startup-sequence can contain lines such as the following:
  44.  
  45.         RUNBACKGROUND -3 clock
  46.         RUNBACKGROUND utilities/calculator
  47.         RUNBACKGROUND -5 utilities/notepad
  48.  
  49. where RUNBACKGROUND is the command and the second parameter is the filename
  50. which may be preceded by a flag-variable that specifies an optional delay
  51. time.  The delay can be from 0 to 9, for the number of seconds that
  52. the startup script should sleep while allowing the background task to
  53. load and start.  I've put that in to minimize thrashing of the disk as it
  54. tries to load several projects at once.
  55.  
  56. LIMITATIONS:
  57.  
  58.     The program that you run cannot require any input from an interactive
  59. CLI that starts it.  Additionally, you cannot specify any file redirection
  60. in the command line since this program provides the redirection for you
  61. already.  If you need to use redirection for your command, you can modify
  62. the source code where shown, thus allowing the redirection to become one of
  63. the parameters passed through to your program.
  64.  
  65.     RUNBACKGROUND does pass your command line parameters to the program you
  66. wish to start, but limits the total length of your command string to 227
  67. (255 minus the 28 characters for "RUN >NIL: <NIL: " preceding your own file
  68. pathname and ">NIL: < NIL: " following it.)
  69.