mpxlf
 
 
  NAME
 
  mpxlf - Invokes a shell script to compile Fortran programs.
 
 
  SYNOPSIS
 
  mpxlf [xlf_flags]... program.f
 
  The mpxlf shell script compiles Fortran programs while linking in the
  Partition Manager, Message Passing Interface (MPI), and/or Message
  Passing Library (MPL).
 
 
  FLAGS
 
  Any of the compiler flags normally accepted by the xlf command can
  also be used on mpxlf.  For a complete listing of these flag options,
  refer to the manual page for the xlf command.  Typical options to
  mpxlf include:
 
  -v             causes a "verbose" output listing of the shell script.
 
  -g             Produces an object file with symbol table references.
                 This object file is needed for debugging with the pdbx
                 and pedb debuggers, and is also needed by the Source
                 Code view of the Visualization Tool.
 
  -o             names the executable.
 
  -l (lower-case L)
                 names additional libraries to be searched.  Several
                 libraries are automatically included, and are listed
                 below in the FILES section.
 
  -I (upper-case i)
                 names directories for additional includes.  The
                 directory /usr/lpp/ppe.poe/include is automatically
                 included.
 
  -p             enables profiling with the prof command.  For more
                 information, see the appendix on "Profiling Programs"
                 in IBM Parallel Environment for AIX: Operation and Use,
                 Volume 2, Tools Reference.
 
  -pg            enables profiling with the xprofiler and gprof
                 commands.  For more information, see the "Xprofiler"
                 chapter and the appendix on "Profiling Programs" in IBM
                 Parallel Environment for AIX: Operation and Use, Volume
                 2, Tools Reference.
 
 
  DESCRIPTION
 
  The mpxlf shell script calls the xlf compiler.  In addition, the
  Partition Manager and message passing interface are automatically
  linked in.  The script creates an executable that dynamically binds
  with the message passing libraries.  If you wish to create a
  statically bound application, use the instructions in "Creating a
  Static Executable" in IBM Parallel Environment for AIX: Operation
  and Use, Volume 1, Using the Parallel Operating Environment in place
  of this script.
 
  Flags are passed by mpxlf to the xlf command, so any of the xlf
  options can be used on the mpxlf shell script.  The communication
  subsystem library implementation is dynamically linked when you invoke
  the executable using the poe command.  The value specified by the
  MP_EUILIB environment variable or the -euilib flag will then determine
  which communication subsystem library implementation is dynamically
  linked.
 
 
  ENVIRONMENT VARIABLES
 
  MP_PREFIX           sets an alternate path to the scripts library.  If
                      not set or NULL, the standard path
                      /usr/lpp/ppe.poe is used.  If this environment
                      variable is set, then all libraries are prefixed
                      by $MP_PREFIX/ppe.poe.
 
 
  EXAMPLES
 
  To compile a Fortran program, enter:
 
    mpxlf program.f -o program
 
 
  FILES
 
  When you compile a program using mpxlf, the following libraries are
  automatically selected:
 
      /usr/lpp/ppe.poe/lib/libmpi.a  (Message passing interface,
      collective communication routines)
 
      /usr/lpp/ppe.poe/lib/libvtd.a  (VT tracing subsystem)
 
      /usr/lpp/ppe.poe/lib/libppe.a  (PE common routines)
 
      /usr/lpp/ppe.poe/lib/libc.a  (POE version of libc.a)
 
  Note:  If Fortran Version 2 is used, the scripts statically link
         /usr/lib/libxlf.a(shr.o) into the executable.  If Fortran
         Version 3 is used, the scripts statically link
         /usr/lib/libxlf.a(shr.o) and /usr/lib/libxlf90.a(io.o) into the
         executable.
 
 
  RELATED INFORMATION
 
  Commands:  mpcc(1), xlf(1), pdbx(1), pedb(1), vt(1), xprofiler(1)