HP-MPI User's Guide (11th Edition)

Understanding HP-MPI
Running applications on HP-UX and Linux
Chapter 378
Creating an appfile The format of entries in an appfile is line oriented. Lines
that end with the backslash (\) character are continued on the next line, forming
a single logical line. A logical line starting with the pound (#) character is treated
as a comment. Each program, along with its arguments, is listed on a separate
logical line.
The general form of an appfile entry is:
[-h remote_host] [-e var[=val] [...]] [-l user] [-sp paths]
[-np #] program [args]
where
-h remote_host Specifies the remote host where a remote executable file is
stored. The default is to search the local host. remote_host is
either a host name or an IP address.
-e var=val Sets the environment variable var for the program and gives
it the value val. The default is not to set environment
variables. When you use -e with the -h option, the
environment variable is set to val on the remote host.
-l user Specifies the user name on the target host. The default is the
current user name.
-sp paths Sets the target shell PATH environment variable to paths.
Search paths are separated by a colon. Both -sp path and -e
PATH=path do the same thing. If both are specified, the -e
PATH=path setting is used.
-np # Specifies the number of processes to run. The default value
for # is 1.
program Specifies the name of the executable to run. mpirun searches
for the executable in the paths defined in the PATH
environment variable.
args Specifies command line arguments to the program. Options
following a program name in your appfile are treated as
program arguments and are not processed by mpirun.
Adding program arguments to your appfile When you invoke mpirun using
an appfile, arguments for your program are supplied on each line of your
appfile—Refer to “Creating an appfile” on page 78. HP-MPI also provides an
option on your mpirun command line to provide additional program arguments to
those in your appfile. This is useful if you wish to specify extra arguments for
each program listed in your appfile, but do not wish to edit your appfile.
To use an appfile when you invoke mpirun, use one of the following as described
in “mpirun” on page 74: