The ifx_lo_alter() function

The ifx_lo_alter() function alters the storage characteristics of an existing smart large object.

Syntax

mint ifx_lo_alter(LO_ptr, LO_spec)
   ifx_lo_t *LO_ptr;
   ifx_lo_create_spec_t *LO_spec;
LO_ptr
A pointer to an LO-pointer structure that identifies the smart large object whose storage characteristics are altered. For more information about LO-pointer structures, see The LO-pointer structure.
LO_spec
A pointer to the LO-specification structure that contains the storage characteristics that ifx_lo_alter() saves for the smart large object that LO_ptr indicates. For more information about the LO-specification structure, see The LO-specification structure.

Usage

The ifx_lo_alter() function updates the storage characteristics of an existing smart large object with the characteristics in the LO-specification structure to which LO_spec points. With ifx_lo_alter(), you can change only the following storage characteristics:
  • Logging characteristics

    You can set the LO_LOG or LO_NOLOG flag with the ifx_lo_specget_flags() function.

  • Last-access time characteristics

    You can set the LO_KEEP_LASTACCESS_TIME or LO_NOKEEP_LASTACCESS_TIME flag with the ifx_lo_specset_flags() function.

  • Extent size

    You can store a new integer value for the allocation extent size with the ifx_lo_specset_extsz() function. The new extent size applies only to extents written after the ifx_lo_alter() function completes.

The function obtains an exclusive lock for the entire smart large object before it proceeds with the update. It holds this lock until the update completes.

Return codes

0
The function was successful.
<0
The function was not successful and the return value indicates the cause of the failure.