MPLOADER                             SysV                             MPLOADER


NAME
     mploader - multiprocessor program loader

SYNOPSIS
     mploader [option] ... filename

DESCRIPTION
     mploader loads filename for execution on a multiprocessor machine, where
     filename is a FORTRAN program that has been compiled under HP Concurrent
     FORTRAN (HPCF).

OPTIONS
     -pn       Execute filename on n processors, where n is a single-digit
               number in the range 1 - 4.  You can use the MPNPROCS environ-
               ment variable instead of this option to set the number of pro-
               cessors.

     -Ms[k|m]  Allocate s bytes of shared heap storage for large local arrays.
               You can optionally specify that s is in units of kilobytes or
               megabytes with the k or m suffix.  If you omit the -M option,
               the default is 1 MB.  You can use the MPMALLOC environment
               variable instead of this option to allocate shared heap
               storage.

     -Vm[k|m]  Allocate m bytes of vector temporary memory.  You can option-
               ally specify that s is in units of kilobytes or megabytes with
               the k or m suffix.  If you omit the -V option, the default is
               32 KB.  You can use the MPVTEMP environment variable instead of
               this option to allocate vector temporary memory.

     -ln       Set the lower boundary for the process priority to be assigned
               to the filename, where n is in the range 1 - 16 inclusive.  The
               default is 3.

     -hn       Set the upper boundary for the process priority to be assigned
               to the filename, where n is in the range 1 - 16 inclusive.  The
               default is 14.

     -H        Display a one-line usage message.

     -i        Display dates and version numbers for both mploader and the
               parallel libraries that were linked with filename.

EXAMPLE
     The following example command line loads the program a.out for execution
     on two processors and allocates two mebabytes of shared heap storage and
     512 kilobytes of vector temporary memory.  The program a.out is a binary
     image generated by HPCF.

         $ /usr/apollo/bin/mploader -p2 -M2m -V512k a.out

DIAGNOSTICS
     The diagnostics produced by mploader itself are intended to be self-
     explanatory.

NOTES
     If the number of processors you specify with the -pn option is greater
     than the number of processors you specified when compiling the program,
     the superfluous processors will enter an idle state.  The same waste of
     resources occurs if you specify more than one processor with the -pn
     option for a program compiled for serial execution.

SEE ALSO
     f77(1).
     HP Concurrent FORTRAN User's Guide
     Domain FORTRAN Language Reference