R-Tree Secondary Access Method DataBlade Module

Home | Previous Page | Next Page R-Tree Secondary Access Method Concepts > R-Tree Functionality That IBM Provides >

R-Tree Secondary Access Method DataBlade Module

The IBM Informix R-Tree Secondary Access Method DataBlade module is automatically installed at the time you install Dynamic Server.

UNIX Only

On UNIX, the IBM Informix R-Tree Secondary Access Method DataBlade module is installed in the directory $INFORMIXDIR/extend/ifxrltree.version, where version refers to the latest version number of the DataBlade module installed on your computer.

End of UNIX Only

Windows Only

On Windows, the IBM Informix R-Tree Secondary Access Method DataBlade module is installed in the directory %INFORMIXDIR%\extend\ifxrltree.version, where version refers to the latest version number of the DataBlade module installed on your computer.

End of Windows Only

Contents of the DataBlade Module

The IBM Informix R-Tree Secondary Access Method DataBlade module consists of:

A list of error messages that the R-tree access method uses
A BladeSmith interface object ifxrltree1 that the DataBlade modules that depend on the IBM Informix R-Tree Secondary Access Method DataBlade module use
For more information on how to use this interface object, refer to Developing DataBlade Modules That Use the R-Tree Secondary Access Method.

As the preceding section describes, the R-tree access method itself is built into Dynamic Server. The error messages that the access method uses, however, are only available if the IBM Informix R-Tree Secondary Access Method DataBlade module is registered in a database.

The R-tree error messages contained in this DataBlade module have error codes of the form RTRnn, where:

RTR is the three-character prefix for all IBM Informix R-Tree Secondary Access Method DataBlade module error codes.
nn are two characters (0 to 9 or A to Z) that uniquely identify each error code.

DataBlade Module Registration

You must register the IBM Informix R-Tree Secondary Access Method DataBlade module in each database in which you plan to use it. To register DataBlade modules, use BladeManager.

This registration normally occurs when you register a dependent DataBlade module, that is, one that can only be registered if the IBM Informix R-Tree Secondary Access Method DataBlade module has been previously registered. The dependent DataBlade module first signals to BladeManager that it depends on the IBM Informix R-Tree Secondary Access Method DataBlade module. BladeManager then registers the IBM Informix R-Tree Secondary Access Method DataBlade module before it registers the dependent DataBlade module.

The dependent DataBlade module usually contains the definition of the user-defined data type the R-tree access method can index.

For more information about BladeManager, refer to the IBM Informix: DataBlade Module Installation and Registration Guide.