**fScan Reference Manual, Chapter 2 (CmdLineOptions): run**
===== Run -- Execute a series of fScan interactive commands =====
**usage:**\\
 %%-run mode [flag] string%%\\
 %%-run%%\\
 %%:%%
===== =====
With no arguments, this command just forces everything before it in the command line to be processed before processing other options. A colon (surrounded by blank space) is a shorthand equivalent to the **-run** command with no arguments. It simply forces execution of all command options preceding it.

With arguments, this loads interactive command strings.

MODE:
  * 1 - interpret STRING as a sequence of interactive commands (default). This sets [[jvs:fscan:manual:chapter4:peekstr|peekstr]] to STRING.
  * 2 - run contents of file STRING as a sequence of interactive commands
  * 3 - STRING is the name of a menu; ITEM is the number of an item within that menu (1=first). If STRING="funckey", ITEM is Funckey number. The menu item is run as though it had been selected interactively. Multiple pairs of [MENUNAME ITEM] can be combined in the same '-run 3' command.
  * 4 - set contents of file STRING to run when fScan terminates (sets [[jvs:fscan:manual:chapter4:quitstr|quitstr]])
  * 5 - run STRING and following arguments as an [[jvs:fscan:manual:chapter3:winkeys:exec|EXEC]] command (like interactive cmd: 'STRING',flag E)
  * 6 - run contents of file STRING as a sequence of fScan command-line commands
  * 7 - run STRING as a sequence of fScan command-line commands

Examples:
<code>
  fscan infile -e + 100   -e x 4 -D           # add and multiply together (one result window)
  fscan infile -e + 100 : -e x 4 -D           # add and multiply separately (show both results) 
  fscan infile -run "3C4d" -D                 # load data, switch to 3-plane view and reduce intensity
  fscan infile -run 2 myview -D               # load data and run interactive commands in file "myview"
  fscan infile -run 3 display 3 -D            # load data and run icon 3 from taskbar 'Display'
  fscan -run 5 run_fslmc infile 9 -v 0        # run the shell script as: "csh run_fslmc INFILE 9"
</code>               
**Note:**\\
RUN is a command-line command designed for running sequences of interactive fScan commands.\\
[[jvs:fscan:manual:chapter2:options|OPTIONS]] is a command-line command designed for running sequences of command-line commands.\\
The '[[jvs:fscan:manual:chapter3:winkeys:go|G]]' interactive command is designed to run sequences of command-line commands interactively.\\
Combining and embedding RUN, OPTIONS, and 'G' commands provides a lot of programming flexibility, but can be a bit confusing.\\
When in doubt, insert ':' (or '-run') into command-line sequences to group sub-sequences into separate processing stages. 

**See Also:**\\
[[jvs:fscan:manual:chapter3:winkeys:exec|EXEC]], 
[[jvs:fscan:manual:chapter2:options|OPTIONS]],
[[jvs:fscan:manual:chapter3:winkeys:go|GO]]

[[jvs:fscan|fScan Home]], 
[[jvs:fscan:manual|fScan Manual]], 
[[jvs:fscan:manual:chapter2|CmdLineOptions]], 
[[jvs:fscan:manual:help|Manual Help]]