NAME

       shmem_quiet(3)  -  Waits  for  completion  of  all  outstanding  remote writes issued by a
       processing element (PE).

SYNOPSIS

       C or C++:
       #include <mpp/shmem.h>

       void shmem_quiet(void);

       Fortran:
       CALL SHMEM_QUIET

DESCRIPTION

       shmem_quiet ensures ordering of put (remote write) operations. All put  operations  issued
       to  any  processing  element  (PE)  prior  to the call to shmem_quiet are guaranteed to be
       visible to all other PEs no later than any subsequent memory load or store, remote put  or
       get, or synchronization operations that follow the call to shmem_quiet.

NOTES

       shmem_quiet  is  most  useful  as  a  way  of ensuring ordering of delivery of several put
       operations. For example, you might use shmem_quiet to await delivery of a  block  of  data
       before issuing another put, which sets a completion flag on another PE.
       shmem_quiet  is not usually needed if shmem_barrier_all(3) or shmem_barrier(3) are called.
       The barrier routines all wait for the completion of outstanding remote writes (puts).

EXAMPLES

       PROGRAM COMPFLAG
         INCLUDE "mpp/shmem.fh"

         INTEGER FLAG_VAR, ARRAY(100), RECEIVER, SENDER
         COMMON/FLAG/FLAG_VAR
         COMMON/DATA/ARRAY
         INTRINSIC MY_PE

         FLAG_VAR = 0
         CALL SHMEM_BARRIER_ALL ! wait for FLAG_VAR to be initialized
         SENDER = 0                        ! PE 0 sends the data
         RECEIVER = 1                      ! PE 1 receives the data

         IF (MY_PE() .EQ. 0) THEN
           ARRAY = 33
           CALL SHMEM_PUT(ARRAY, ARRAY, 100, RECEIVER) ! start sending data
           CALL SHMEM_QUIET                ! wait for delivery
           CALL SHMEM_PUT(FLAG_VAR, 1, 1, RECEIVER) ! send completion flag
         ELSE IF (MY_PE() .EQ. RECEIVER) THEN
           CALL SHMEM_UDCFLUSH
           CALL SHMEM_WAIT(FLAG_VAR, 0)
           PRINT *,ARRAY                       ! ARRAY has been delivered
         ENDIF
       END

SEE ALSO

       intro_shmem(3),  shmem_barrier(3),  shmem_barrier_all(3),  shmem_fence(3),   shmem_put(3),
       shmem_wait(3)