Last modified: 18 March 2016

Signature:

herr_t H5Pset_coll_metadata_write(
              hid_t fapl_id,
              hbool_t is_collective
        )

Purpose:

Sets metadata write mode to collective or independent (default).

Description:

H5Pset_coll_metadata_write tells the HDF5 Library whether to perform metadata writes collectively (TRUE) or independently (FALSE).

If collective access is selected, then on a flush of the metadata cache, all processes will divide the metadata cache entries to be flushed evenly among themselves and issue a single MPI-IO collective write operation. This is the preferred method when the size of the metadata created by the application is large.

If independent access is selected, the library uses the default method for doing metadata I/O either from process zero or independently from each process.

Parameters:

`hid_t fapl_id`		IN: File access propery list identifier
`hbool_t is_collective`		IN: Boolean value indicating whether metadata writes are collective (`TRUE`) or independent (`FALSE`) Default mode: Independent (`FALSE`)

Returns:

Returns a non-negative value if successful; otherwise returns a negative value.

Fortran Interface: h5pset_coll_metadata_write_f

See Also:

H5Pget_coll_metadata_write

History:

Release	Change
1.10.0	C function and Fortran wrapper introduced with this release.