informix
Informix DataBlade API Programmer's Manual
Using Smart Large Objects

Using the Illustra Large-Object Interface

The Illustra large-object interface is a set of DataBlade API functions that allow you to access the data of a smart large object with the same functions that Illustra applications used. The interface provides the following:

The miloback.h header file defines the functions and data structures of the Illustra large-object interface. The mi.h header file automatically includes the miloback.h header file. You must include either mi.h or miloback.h in any DataBlade API routine that calls an Illustra large-object function or declares one of the Illustra large-object data structures.

Illustra Large-Object Functions

Most of the large-object functions begin with the string mi_large_object_. However, Dynamic Server does not support the entire set of Illustra large-object functions.

Chapter 15, DataBlade API Function Descriptions, contains an alphabetical list of all DataBlade API functions, including the Illustra large-object functions.

Unsupported Functionality

The following Illustra data types are no longer supported:

Illustra Data Type Informix Data Type
large_text CLOB
large_object BLOB

BLOB and CLOB are the SQL data types for smart large objects. They have no relation to the legacy Informix large objects, called blobs, of BYTE and TEXT.

In addition, the DataBlade API does not support the following functions in the Illustra interface:

Illustra Large-Object Data Structures

The following table summarizes the Illustra large-object data structures and their smart-large-object equivalents.

DataBlade API
Data Structure
Backward-Compatible
Data Structure
Purpose
MI_LO_FD MI_LODESC An LO file descriptor describes an open smart large object.
MI_LO_HANDLE MI_LOHANDLE An LO handle is a pointer or handle to a smart large object.
MI_LOINFO Smart-large-object information descriptor
MI_LO_SPEC An LO-specification structure holds storage characteristics for a smart large object.
MI_LO_STAT MI_LOSTAT An LO-status structure holds status information for a smart large object.


Informix DataBlade API Programmer's Manual, Version 9.2
Copyright © 1999, Informix Software, Inc. All rights reserved