Register a module

To register a module, run the SYSBldPrepare( ) function with the module reference and the 'create' arguments.

For the complete calling syntax and the signature of the SYSBldPrepare( ) function, see its description in the HCL® Informix® Guide to SQL: Syntax.

The module reference is the installed name and version number of the module, which you can see in the $INFORMIXDIR/extend directory. The version string that follows the module name can be replaced by or truncated with the asterisk (*) wildcard, which instructs SYSBldPrepare( ) to register the highest installed version of the specified module.

The module reference is the installed name and version number of the module, which you can see in the $INFORMIXDIR/extend directory. The version string that follows the module name can be replaced by or truncated with the asterisk (*) wildcard, which instructs SYSBldPrepare( ) to register the highest installed version of the specified module.

The following call to the SYSBldPrepare( ) function instructs the database server to register the highest installed version of a module named Map:
EXECUTE FUNCTION sysbldprepare('map.*','create');
Successful invocation of the SYSBldPrepare( ) function with 'create' as its second argument also registers any modules on which the module specified in the first argument is dependent. For example, suppose you create a WorldView module that is dependent on the Map module. The following SPL statement registers the specified version of the WorldView module and implicitly registers the highest installed version of the Map module on which it has a dependency:
LET y = sysbldprepare('worldview.1.0.TC1','create');
Here the LET statement assigns to the variable y the returned status code from the call to SYSBldPrepare( ). If y = 0, the registration succeeded.

If the dependency Map module is already registered, no action to register it is taken, even if the currently registered version is not the highest installed version.

Calls to the SYSBldPrepare( ) function can return error messages. For information about these error messages, see Exceptions in calls to SYSBldPrepare( ).