Home
Extending Informix®Beyond standard relational database objects, HCL Informix® can be extended to handle specialized data types, access methods, routines, and other objects. Informix® includes many built-in extensions that are fully integrated in the database server. Informix® also provides DataBlade® modules, which are packages of extended database objects for a particular purpose and that are installed separately from the database server. Alternatively, you can create your own user-defined objects for Informix®.
Creating extensionsYou can create user-defined data types, routines, access methods, and other database objects to suit your needs. You can use application programming interfaces to write user-defined routines and applications that access data in Informix® databases.
DataBlade® API Programmer's GuideThe Informix® DataBlade® API Programmer's Guide describes information about the DataBlade® API, the C-language application programming interface (API) provided with HCL Informix®.
Create user-defined routines
Develop a user-defined routineA C user-defined routine (UDR) is a UDR that is written in the C language and uses the server-side implementation of the DataBlade® API to communicate with the database server. C UDRs (functions and procedures) are implemented as C-language functions. DataBlade® modules often include C UDRs that are made available for use by registering them in the database.
Compile a C UDRTo compile a C UDR, use a C compiler to compile the source file (.c file extension) into an object file (.o file extension) and create a shared-object file that contains the object file.
Creating a shared-object fileYou create a shared-object file to hold the compiled UDRs. This file is in a directory on the server computer. Each UDR must have a unique name within the shared-object file.
Creating a shared-object file for a C UDR

Creating a shared-object file for a C UDR

About this task

To create a shared-object file for a C UDR:

Procedure

Create a shared-object file and put the UDR object file (.o file) into this shared-object file.
You can put C functions for related UDRs into the same shared-object file. However, the name of each C function must be unique within the shared-object file.
Put the shared-object file in a directory on which the user informix has read permission and the shared-object owner has write permission.
The shared-object file must not have permissions that allow any user other than user informix to have write permission.
Specify the path of the shared-object file in the EXTERNAL NAME clause of the CREATE FUNCTION (or CREATE PROCEDURE) statement when you register the C UDR.
The shared-object file does not have to exist before you register its path with CREATE FUNCTION or CREATE PROCEDURE. However, at UDR runtime, the paths of the shared-object file and the registered UDR must match for the database server to locate the UDR.

Results

Important: If a shared-object file has write permission set to all, the database server issues error -9793 and writes a message in the log file when someone tries to execute any UDR in the shared object.

For more information, see Execute a UDR. For information about how to create a shared-object file, see the Informix® User-Defined Routines and Data Types Developer's Guide.

Rate this topic

5 stars 4 stars 3 stars 2 stars 1 star

Comment on this topic.

By clicking this box, you acknowledge that you are NOT a U.S. Federal Government employee or agency, nor are you submitting information with respect to or on behalf of one. HCL provides software and services to U.S. Federal Government customers through its partners immixGroup, Inc. Contact this team at https://hcltechsw.com/resources/us-government-contact. Do not include any personal data in this Comment box.