MPIFilewriteorderedbegin(3OpenMPI) MPIFilewriteorderedbegin(3OpenMPI)

NAME
       MMPPIIFFiilleewwrriitteeoorrddeerreeddbbeeggiinn - Writes a file at a location specified by
       a shared file pointer; beginning part of  a  split  collective  routine
       (nonblocking).


SSYYNNTTAAXX
       C Syntax
           #include 
           int MPIFilewriteorderedbegin(MPIFile fh, void *buf,
                  int count, MPIDatatype datatype)

       Fortran Syntax
           INCLUDE 'mpif.h'
           MPIFILEWRITEORDEREDBEGIN(FH, BUF, COUNT, DATATYPE, IERROR)
                          BUF(*)
                 INTEGER        FH, COUNT, DATATYPE, IERROR


CC++++ SSyynnttaaxx
       #include 
       void MPI::File::Writeorderedbegin(const void* buf, int count,
            const MPI::Datatype& datatype)


IINNPPUUTT//OOUUTTPPUUTT PPAARRAAMMEETTEERR
       fh        File handle (handle).


IINNPPUUTT PPAARRAAMMEETTEERRSS
       buf       Initial address of buffer (choice).

       count     Number of elements in buffer (integer).

       datatype  Data type of each buffer element (handle).


OOUUTTPPUUTT PPAARRAAMMEETTEERR
       IERROR    Fortran only: Error status (integer).


DESCRIPTION
       MPIFilewriteorderedbegin  is  the beginning part of a split collec-
       tive, nonblocking routine that must be called by all processes  in  the
       communicator  group  associated  with the file handle fh.  Each process
       may pass different argument values for the  datatype  and  count  argu-
       ments.  After  all  processes of the group have issued their respective
       calls, each process attempts to write, into the  file  associated  with
       fh,  a  total number of count data items having datatype type contained
       in the user's buffer buf.  For each process, the location in  the  file
       at  which  data  is  written  is  the position at which the shared file
       pointer would be after all processes whose ranks within the  group  are
       less than that of this process had written their data.


NNOOTTEESS
       All  the  nonblocking  collective  routines for data access are "split"
       into two routines, each with begin or end as a  suffix.  These  split
       collective routines are subject to the semantic rules described in Sec-
       tion 9.4.5 of the MPI-2 standard.


EERRRROORRSS
       Almost all MPI routines return an error value; C routines as the  value
       of  the  function  and Fortran routines in the last argument. C++ func-
       tions do not return errors. If the default  error  handler  is  set  to
       MPI::ERRORSTHROWEXCEPTIONS, then on error the C++ exception mechanism
       will be used to throw an MPI:Exception object.

       Before the error value is returned, the current MPI  error  handler  is
       called.  For  MPI I/O function errors, the default error handler is set
       to  MPIERRORSRETURN.  The  error  handler   may   be   changed   with
       MPIFileseterrhandler;      the      predefined     error     handler
       MPIERRORSAREFATAL may be used to make I/O errors  fatal.  Note  that
       MPI  does not guarantee that an MPI program can continue past an error.




Open MPI 1.2                    SeptemberMP2I00F6ilewriteorderedbegin(3OpenMPI)