home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Misc / CBMDevKit2.dms / CBMDevKit2.adf / DevTools / DevTools.lha / Devtools / DOCS / EndRun.doc < prev    next >
Encoding:
Text File  |  1993-05-13  |  2.0 KB  |  60 lines
  1. TABLE OF CONTENTS
  2.  
  3. EndRun
  4. EndRun                                                                 EndRun
  5.  
  6.    NAME
  7.     EndRun
  8.  
  9.    SYNOPSIS
  10.     EndRun [command] - Execute a given command with Workbench closed
  11.  
  12.    FUNCTION
  13.     EndRun closes the initial CLI window and Workbench screen,
  14.     then executes the given command.  Runing with the screen closed
  15.     saves memory space.  EndRun is the *only* officially supported way
  16.     to run with a closed Workbench screen under both 1.3 and 2.0
  17.     Kickstarts.
  18.  
  19.    INPUTS
  20.     [command] is the command line to be executed.  The first
  21.     word in the command will be the load file as passed to LoadSeg().
  22.     If no command line is given, EndRun will simply halt.
  23.  
  24.    RESULTS
  25.     The given command is run with the Workbench screen closed.
  26.  
  27.    EXAMPLE
  28.     ; startup-sequence for SnakePit
  29.     EndRun SnakePit datafile
  30.     ; Note that we run the snakepit program with the
  31.     ; argument "datafile" which is passed to the program.
  32.  
  33.    NOTES
  34.     EndRun exists because programmers have used a variety of
  35.     unsupportable tricks to recover the memory used by the Workbench
  36.     screen.  EndRun is guaranteed to continue functioning in future
  37.     releases.
  38.  
  39.     Note that 2.0-specific programs don't need EndRun.  Disks
  40.     installed with 2.0 install are set to "silent" mode.  The
  41.     Workbench screen remains closed until the first output.  Simply
  42.     ensure that all output is redirected to >NIL: <NIL:, and the
  43.     Workbench screen will never open.
  44.  
  45.     The [command] will not have any functioning stdin/stdout.
  46.     stdin/stdout will be connected to NIL:
  47.  
  48.     EndRUN *MUST* have V1.2 or greater kickstart.  It also *MUST*
  49.     be executed from a CLI (usually from the startup-sequence).
  50.  
  51.     EndRun has a maximum COMMAND name (first word in the command line)
  52.     of 64 characters.  It will not work correctly with more.
  53.     The rest of the command line can be as long as you wish.
  54.  
  55.     When the program exits, EndRun will just halt.  It will go
  56.     into a dead loop.  However, applications run with EndRun
  57.     are usually of the type the user uses with a reboot as this
  58.     utility is design for use in startup sequences.
  59.  
  60.