Debugging a DataBlade Module

Debugging a DataBlade module is usually an iterative process, repeated many times until the code is completely debugged. The debugging process has the following general steps:

1. Build the shared object file with debugging support while logged on as user informix (if necessary).

   To debug a DataBlade module, compile the shared object file with the -g compiler option so that debugging symbols are available to the debugger. See Compiling DataBlade Module Code for information about compiling with debugging support.

2. Install the DataBlade module shared object and SQL scripts in the $INFORMIXDIR/extend/project directory.

   See Installing a DataBlade Module for more information.

3. Start your database server with the oninit command, while logged on as the informix user.

   See the IBM Informix: Dynamic Server Administrator's Guide for more information.

4. Register the DataBlade module, using BladeManager (if necessary).

   See Registering a DataBlade Module for more information.

5. If you are replacing an existing shared object, shut down and restart the database server with the onmode -yuk and oninit commands.

   See Replacing a Shared Object File for more information.

6. Load the DataBlade module by calling one of its routines.

   See Loading the DataBlade Module for instructions.

7. Log on as user root in a new window to run the debugger.
8. Obtain the database server process ID for the root session.

   See Identifying the Server Process for instructions.

9. Run the debugger and attach to the database server process.

   See Running the Solaris Debugger for instructions.

10. Set any appropriate breakpoints.

    See Setting Breakpoints for more information.

11. Issue SQL statements to call your DataBlade module routines from the informix session.

    See the IBM Informix: DB–Access User's Guide for more information.

12. Edit the source code (if necessary).
13. Repeat the procedure, as necessary.

The following sections describe some of these steps.