included best practices of using coll. metadata APIs (#4018)

1 files changed, 14 insertions, 4 deletions

diff --git a/HDF5Examples/C/H5PAR/ph5_filtered_writes.c b/HDF5Examples/C/H5PAR/ph5_filtered_writes.c
index 104704a..34ed2fb 100644
--- a/HDF5Examples/C/H5PAR/ph5_filtered_writes.c
+++ b/HDF5Examples/C/H5PAR/ph5_filtered_writes.c
@@ -377,14 +377,24 @@ main(int argc, char **argv)
     H5Pset_fapl_mpio(fapl_id, comm, info);
 
     /*
-     * OPTIONAL: Set collective metadata reads on FAPL to allow
-     *           parallel writes to filtered datasets to perform
-     *           better at scale. While not strictly necessary,
-     *           this is generally recommended.
+     * OPTIONAL: It is generally recommended to set collective
+     *           metadata reads on FAPL to perform metadata reads
+     *           collectively, which usually allows filtered datasets
+     *           to perform better at scale, although it is not
+     *           strictly necessary.
      */
     H5Pset_all_coll_metadata_ops(fapl_id, true);
 
     /*
+     * OPTIONAL: It is generally recommended to set collective
+     *           metadata writes on FAPL to perform metadata writes
+     *           collectively, which usually allows filtered datasets
+     *           to perform better at scale, although it is not
+     *           strictly necessary.
+     */
+    H5Pset_coll_metadata_write(fapl_id, true);
+
+    /*
      * OPTIONAL: Set the latest file format version for HDF5 in
      *           order to gain access to different dataset chunk
      *           index types and better data encoding methods.