Main window fields:

- Application:
  Enter the full path to the mpi application and any arguments. This can be a local or shared location. The local path must be valid on all the nodes.
  eg "c:\temp\myapp.exe arg1 arg2" or "\\myserver\myshare\myapp.exe arg1 arg2".
- Number of processes:
  Select the number of processes you want to launch.
- Run:
  Launch the mpich application.
- Break:
  Kill the running application
- Any hosts:
  Choose hosts from the list in a round robin fashion.
- Hosts:
  Choose only the highlighted hosts from the list
- V button:
  Add a host name to the list
- reset:
  Reset the list of hosts to the list selected by MPIConfig
- Output:
  The output of the application shows up here. Ctrl+C will copy the output. You can also enter input here that will be sent to the root process.

Advanced Options:

- No color output:
  The output will not be color coded according to the rank of the process
- No mpi:
  Launch multiple processes that are not mpi applications - they never make any MPI calls.
- Don't clear output on Run:
  The output in the output window does not get erased when the Run button is clicked
- Always prompt for password:
  Don't use the saved account, prompt for user credentials every time Run is selected.
- Redirect output to file:
  Redirect the output of the mpi application to the specified file. The contents of the file will be deleted each time Run is selected.
- Slave process:
  Specify the path to a second executable to be launched for every process except the root process. This is a quick way to launch a master/slave application without using a configuration file.
- Environment: var1=val1|var2=val2|var3=val3|...varn=valn
  This will set the environment variables specified in the string before each process is launched.
- Working directory: drive:\some\path
  Set the working directory for the launched processes. If this option is not specified the current directory is used.
- Drive mappings: drive:\\host\share
  This option will map a drive on the hosts where the processes are launched. The mappings are removed after the processes exit. This option can be repeated multiple times separated by semi-colons. example: y:\\myserver\myapps;z:\\myserver\myhome
- Use configuration file:
  Select a configuration file to specify more complicated launching preferences

Configuration files.

The config file format is as follows:

>     exe c:\somepath\myapp.exe
>      OR \\host\share\somepath\myapp.exe
>     [args arg1 arg2 arg3 ...]
>     [env VAR1=VAL1|VAR2=VAL2|...|VARn=VALn]
>     [dir drive:\some\path]
>     [map drive:\\host\share]
>     hosts
>     hostA [num_procs] [path\myapp.exe]
>     hostB [num_procs] [\\host\share\somepath\myapp2.exe]
>     hostC [num_procs]
>     ...

Bracketed lines are optional. The # character will comment out a line. You may specify a path to an executable on each host line, thus enabling MPMD programming. If you do not specify a path, then the default is used from the exe line.

Here are two sample configuration files:

>     exe c:\temp\myapp.exe
>     hosts
>     fry 1
>     jazz 2

This one shows a more complicated scenario:

>     exe c:\temp\slave.exe
>     env MINX=0|MAXX=2|MINY=0|MAXY=2
>     args -i c:\temp\cool.points
>     hosts
>     fry 1 c:\temp\master.exe
>     fry 1
>     #light 1
>     jazz 2