Preparing to call the SYSBldPrepare( ) function
About this task
This topic lists the prerequisite tasks for using the SYSBldPrepare( ) function to register or unregister modules.
To prepare to call the SYSBldPrepare( ) function:
Procedure
- Install and configure HCL®
Informix®.
- You must have these environment variables set properly: INFORMIXDIR and INFORMIXSERVER. For more information, see the HCL® 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 modules. For more information, see the HCL® Informix® Administrator's Reference.
- Install modules.
See Installing modules for more information about how to install modules on UNIX™ or Windows™ systems, and how to uninstall modules.
- 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 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.
- Connect to the database.For information about the connect and resource access privileges that you need to connect to the database, see the HCL® Informix® Administrator's Guide.
- 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.