INFORMIX
DataBlade API Programmer's Manual
Chapter 12: DataBlade API Function Descriptions
Home Contents Index Master Index New Book

mi_lo_alter()

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

Syntax

Usage

 The mi_lo_alter() function updates the storage characteristics of an existing smart large object with the characteristics in the LO-specification structure that LO_spec references. With mi_lo_alter(), you can change only the following storage characteristics:

    You can specify the MI_LO_ATTR_LOG or MI_LO_ATTR_NO_LOG constant for the attributes flag with the mi_lo_specset_flags() function.

    You can specify the MI_LO_ATTR_KEEP_LASTACCESS_TIME or MI_LO_ATTR_NOKEEP_LASTACCESS_TIME constant for the attributes flag with the mi_lo_specset_flags() function.

    You can store a new integer value for the allocation extent size with the mi_lo_specset_extsz() function. The new extent size applies only to extents written after the mi_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 Values

MI_OK

The function was successful.

MI_ERROR

The function was not successful.

Related Topics

 See the descriptions of the following functions: mi_lo_spec_init(), mi_lo_colinfo_by_name(), and mi_lo_colinfo_by_ids().

In Chapter 3, "Handling Smart Large Objects," see "Altering Storage Characteristics".



DataBlade API Programmer's Manual, version 9.1
Copyright © 1998, Informix Software, Inc. All rights reserved.