Provided by: mpi-doc_1.2.7-9.1ubuntu1_all bug

NAME

       MPE_CaptureFile  -   Sets the base filename used to capture output from
       updates

SYNOPSIS

       #include "mpe.h"
       int MPE_CaptureFile( handle, fname, freq )
       MPE_XGraph handle;
       char       *fname;
       int        freq;

INPUT PARAMETERS

       handle - MPE graphics handle
       fname  - base file name (see below)
       freq   - Frequency of updates

RETURN VALUES

       MPE_ERR_LOW_MEM
              - malloc for copy of the filename (fname) failed
       MPE_ERR_BAD_ARGS
              - handle parameter is bad
       MPE_SUCCESS
              - success

NOTES

       The output is written in xwd format to fname%d , where %d is the number
       of the file (starting from zero).

NOTES FOR FORTRAN INTERFACE

       The  Fortran  interface  to  this  routine  is  different  from  its  C
       counterpart and it has an additional argument, ierr, at the end of  the
       argument  list,  i.e. the returned function value (the error code) in C
       interface is returned as the additional argument in Fortran  interface.
       The Fortran interface is invoked with the CALL statement.

       All  MPI  and  MPE  objects, MPI_Comm, MPE_XGraph and MPE_Color, are of
       type INTEGER in Fortran.

ADDITIONAL NOTES FOR FORTRAN INTERFACE

       The trailing blanks  in  Fortran  CHARACTER  string  argument  will  be
       ignored.

LOCATION

       mpe_graphics.c

                                   12/6/2001                MPE_CaptureFile(4)