DataBlade Developers Kit User's Guide Debugging and Testing DataBlade Modules on UNIX

Installing a DataBlade module places the module's files in a subdirectory of the $INFORMIXDIR/extend directory; registering a DataBlade module adds the module to a database. You must install and register before you can test or debug a DataBlade module.

See Replacing a Shared Object File for important information about updating an existing DataBlade module shared object file.

To install a DataBlade module for testing and debugging, create a project directory and copy the necessary files to it. Create the project directory under $INFORMIXDIR/extend. The name of the project directory is what BladeManager uses as the DataBlade module name.

A good project naming strategy is to combine the project name and version numbers you entered in the New Project wizard in BladeSmith. For example, the Circle project, Version 1.0, can be in $INFORMIXDIR/extend/Circle.1.0. Informix DataBlade modules also include a string indicating the build platform and minor release: for example, 1.0.UC1.TC2, where UC1 is the first UNIX major release, and TC2 is the second Windows NT minor release.

To copy the necessary files to the project directory, use one of these methods:

• Use BladePack to create an installation directory for your DataBlade module and then copy that directory into the module subdirectory under $INFORMIXDIR/extend. For instructions, see Chapter 11, Using BladePack.
• Copy the project.bld file and the contents of the scripts directory into the project directory.

For installation tips and solutions to common problems, see the Informix Developers Network Web site at http://www.informix.com/idn.

You need to register your DataBlade module the first time you install it and if you change the definition of any of your DataBlade module objects in BladeSmith and generate new SQL files. You do not have to reregister your DataBlade module when you only replace its shared object file.

See the DataBlade Module Installation and Registration Guide for more information on registering DataBlade modules.