Synchronize a scope

ss_scope_synchronize is a function defined in ssscope.c.

Synopsis:

herr_t ss_scope_synchronize(ss_scope_t *scope, unsigned tableidx, ss_prop_t *props)

Formal Arguments:

  • scope: A link to an open scope that should be synchronized.
  • tableidx: Magic number to define which table to synchronize. If tableidx is SS_TABLE_ALL then all tables of the scope will be synchronized.
  • props: See *Synchronization Properties*

Description: Various scope modifying operations that would normally be collective across the scope’s communicator can be carried out locally. When this happens the various tasks of the scope’s communicator may store differing information for the scope. This function is intended to synchronize the various tables of a particular scope across all the MPI tasks that “own” that scope. See *Synchronization Algorithm* for more details.

Return Value: Returns non-negative on success; negative on failure. It is an error to attempt to synchronize a scope that is not open.

Parallel Notes: Collective across the scope’s communicator. Substantial communication may be required.

See Also:

  • Scopes: Introduction for current chapter