Preparing to call the SYSBldPrepare( ) function

About this task

This topic lists the prerequisite tasks for using the SYSBldPrepare( ) function to register or unregister DataBlade® modules.

To prepare to call the SYSBldPrepare( ) function:

Procedure

  1. Install and configure Informix®.
    • You must have these environment variables set properly: INFORMIXDIR and INFORMIXSERVER. For more information, see the Informix® Installation Guide.
    • Set the DB_LIBRARY_PATH configuration parameter in the onconfig file. The DB_LIBRARY_PATH configuration parameter specifies the location that Informix® checks for UDR or UDT shared libraries. The DB_LIBRARY_PATH configuration parameter should include $INFORMIXDIR/extend for DataBlade® modules. For more information, see the Informix® Administrator's Reference.
  2. Install DataBlade® modules.
    See Installing DataBlade modules for more information about how to install DataBlade® modules on UNIX™ or Windows™ systems, and how to uninstall DataBlade® modules.
  3. Obtain a user identifier and its password that authorizes you to begin a user session.
    If you do not have these for the Informix® instance, contact the Database Server Administrator (DBSA) and request a user ID and a password.

    On Informix® instances that have set the IFX_EXTEND_ROLE configuration parameter to enable the EXTEND role, you must be granted that role (or be user informix or a member of the DBSA group) to be able to register or unregister DataBlade® modules in any database. If your Informix® instance has enabled the EXTEND role, but you do not hold that role, contact the DBSA and request that the EXTEND role be granted to you.

  4. Connect to the database.
    For information about the connect and resource access privileges that you need to connect to the database, see the Informix® Administrator's Guide.
  5. Establish an environment in which you can issue valid SQL statements.
    This can be any client API that supports SQL, such as DB-Access, SPL, C API, ESQL, JDBC, or ODBC. Refer to the documentation of your API for information about how to establish a database connection and how to call built-in functions.