Name: H5Pset_shared_mesg_index
Signature:
herr_t H5Pset_shared_mesg_index( hid_t fcpl_id, unsigned index_num, unsigned mesg_type_flags, unsigned min_mesg_size )

Purpose:
Configures the specified shared object header message index.

Description:
H5Pset_shared_mesg_index is used to configure the specified shared object header message index, setting the types of messages that may be stored in the index and the minimum size of each message.

fcpl_id specifies the file creation property list.

index_num specifies the index to be configured. index_num is zero-indexed, so in a file with three indexes, they will be numbered 0, 1, and 2.

mesg_type_flags and min_mesg_size specify, respectively, the types and minimum size of messages that can be stored in this index.

Valid message types are as follows:
     H5O_SHMESG_NONE_FLAG No shared messages
     H5O_SHMESG_SDSPACE_FLAG     Simple dataspace message
     H5O_SHMESG_DTYPE_FLAG Datatype message
     H5O_SHMESG_FILL_FLAG Fill value message
     H5O_SHMESG_PLINE_FLAG Filter pipeline message
     H5O_SHMESG_ATTR_FLAG Attribute message
     H5O_SHMESG_ALL_FLAG All message types; i.e., equivalent to the following:
(H5O_SHMESG_SDSPACE_FLAG | H5O_SHMESG_DTYPE_FLAG | H5O_SHMESG_FILL_FLAG | H5O_SHMESG_PLINE_FLAG | H5O_SHMESG_ATTR_FLAG)

Parameters:
hid_t fcpl_id IN: File creation property list identifier.
unsigned index_num IN: Index being configured.
unsigned mesg_type_flags     IN: Types of messages that should be stored in this index.
unsigned min_mesg_size IN: Minimum message size.

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

Fortran90 Interface: h5pset_shared_mesg_index_f
SUBROUTINE h5pset_shared_mesg_index_f(fcpl_id, index_num, mesg_type_flags,    &
           min_mesg_size, hdferr)
  IMPLICIT NONE
  INTEGER(HID_T), INTENT(IN) :: fcpl_id  ! File creation property list
  INTEGER, INTENT(IN) :: index_num       ! Index being configured.
  INTEGER, INTENT(IN) :: mesg_type_flags ! Types of messages that should be 
                                         ! stored in this index.
  INTEGER, INTENT(IN) :: min_mesg_size   ! Minimum message size.
  INTEGER, INTENT(OUT) :: hdferr         ! Error code
                                         ! 0 on success and -1 on failure
END SUBROUTINE h5pset_shared_mesg_index_f
    

History:
Release     C
1.8.0 Function introduced in this release.