Page tree

 

JAVA

FORTRAN

C++

C

 

Link

H5P_GET_MPIO_ACTUAL_CHUNK_OPT_MODE

Retrieves the type of chunk optimization that HDF5 actually performed on the last parallel I/O call (not necessarily the type requested)

Procedure:

H5P_GET_MPIO_ACTUAL_CHUNK_OPT_MODE ( dxpl_id, actual_chunk_opt_mode )

Signature:

herr_t H5Pget_mpio_actual_chunk_opt_mode(
            hid_t dxpl_id,
            H5D_mpio_actual_chunk_opt_mode_t *
	    actual_chunk_opt_mode)

  

Parameters:
hid_t dxpl_idIN: Dataset transfer property list identifier
H5D_mpio_actual_chunk_opt_mode_t * actual_chunk_opt_modeOUT: The type of chunk optimization performed by HDF5

Motivation:

A user can request collective I/O via a data transfer property list (DXPL) that has been suitably modified with H5P_SET_DXPL_MPIO. The operation can be optimized in several different ways, some of which also can be requested by the user. However, HDF5 may not be able to satisfy requests for specific optimizations and may choose a different optimization scheme. This property allows the user to track which optimization was actually used. Used in conjunction with H5P_GET_MPIO_ACTUAL_IO_MODE, this property allows the user to determine exactly what HDF5 did when attempting collective chunked I/O.

Description:

 

H5P_GET_MPIO_ACTUAL_CHUNK_OPT_MODE retrieves the type of chunk optimization performed when collective I/O was requested. This property is set before I/O takes place, and will be set even if I/O fails.

Valid values returned in actual_chunk_opt_mode:

H5D_MPIO_NO_CHUNK_OPTIMIZATIONNo chunk optimization was performed. Either no collective I/O was attempted or the dataset wasn't chunked.
(Default)
H5D_MPIO_MULTI_CHUNKEach chunk was individually assigned collective or independent I/O based on what fraction of processes access the chunk. If the fraction is greater than the multi chunk ratio threshold, collective I/O is performed on that chunk. The multi chunk ratio threshold can be set using H5P_SET_DXPL_MPIO_CHUNK_OPT_RATIO. The default value is 60%.
H5D_MPIO_MULTI_CHUNK_NO_OPTEach chunk is assigned collective or independent I/O based on how many chunks were accessed before it. Collective I/O is performed on the the first chunk in each selection, then the second, and so on until one process finishes, then the remaining processes perform independent I/O on the rest of their selections.
H5D_MPIO_LINK_CHUNKCollective I/O is performed on all chunks simultaneously.

Returns:

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

Example:

Coming Soon!

History:
Release    Change
1.8.8C function introduced in this release.

--- Last Modified: January 03, 2018 | 04:04 PM