home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 262.lha / ArpDoc_v1.3 / ARun < prev    next >
Text File  |  1989-07-01  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4.      ARun(V1.3)              ARP User's Manual              ARun(V1.3)
  5.  
  6.  
  7.  
  8.      NAME
  9.           ARun - Run a process in the background without a shell.
  10.  
  11.      SYNOPSIS
  12.           ARun Program_CommandLine/... </k >/k NOIO/s STACK/k PRI/k
  13.  
  14.      DESCRIPTION
  15.           ARun starts up a background process, but does not use a
  16.           shell to do so. (Compare this with the manual page for Run).
  17.           This incurs much less overhead, since the shell/cli uses
  18.           additional memory not required by many processes.  However,
  19.           if you require the facilities of the shell (such as Aliasing
  20.           or Scripting), you should use the Run command instead.
  21.  
  22.           Although the V1.3 ARun will handle all commands (including
  23.           the Commodore BCPL distribution) it is probably best used
  24.           to start background processes that will run for your entire
  25.           session, for example, a hot-key utility.  ARun makes it
  26.           simple to get the environment you want with as little
  27.           overhead as possible.
  28.  
  29.      OPTIONS
  30.           < >  These set the default input and output files for the
  31.                background process. Note that you must separate the
  32.                bracket characters from the filename by at least one
  33.                space.
  34.  
  35.           NOIO This runs the background process with no default output
  36.                channels.  This is useful for spawning a process from a
  37.                CLI which you will want to close later, but still have
  38.                the background process running. Without the NOIO
  39.                option, the CLI window will not close until the last
  40.                process launched from that CLI has terminated.  Care
  41.                must be used with this option, since many programs need
  42.                default file handles to operate correctly.
  43.  
  44.           STACK
  45.                Sets the stack for the process.  If the program file
  46.                begins with an ARP Resident Header, this will be
  47.                ignored.
  48.  
  49.           PRI  Sets the process priority.
  50.  
  51.      EXAMPLE
  52.           Launch a program with priority -5, stacksize of 2000 and
  53.           noio:
  54.  
  55.             ARun Funkeys NOIO STACKSIZE 2000 PRI -5
  56.  
  57.           The same process under AmigaDOS would be accomplished in
  58.           this way:
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/28/89)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      ARun(V1.3)              ARP User's Manual              ARun(V1.3)
  71.  
  72.  
  73.  
  74.           Stack 4000       ; set the stack ... not safe below 4000!
  75.           ChangeTaskPri -5 ; set the priority, things slow down here!
  76.           Run <NIL: >NIL: MyProgram Mycommands ; launch
  77.           ChangeTaskPri 0  ; reset the priority
  78.           Stack 10240      ; reset the stack.
  79.  
  80.  
  81.      CAUTIONS
  82.           Don't try to start execute scripts with ARun, it won't work.
  83.       These need a shell, so you must use Run with Execute.
  84.  
  85.           Due to the use of the argument parser in ARun (but not in
  86.           Run), you may sometimes need to escape quoted arguments for
  87.           the child.  Here is an example:
  88.  
  89.              ARun Command "\"Quoted Arg\""
  90.  
  91.           Where the \ represents the current escape character (see
  92.           Set for a discussion of the escape character).  The outer
  93.       quotes are for ARun, and the Escaped Quotes tell ARun (or
  94.       the argument parser) to send the argument to the subprocess
  95.       as a quoted string.
  96.  
  97.      SEE ALSO
  98.           Run Set
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/28/89)
  130.  
  131.  
  132.  
  133.