Home
Extending HCL OneDB™Beyond standard relational database objects, HCL OneDB™ can be extended to handle specialized data types, access methods, routines, and other objects. HCL OneDB™ includes many built-in extensions that are fully integrated in the database server. HCL OneDB™ also provides DataBlade® modules, which are packages of extended database objects for a particular purpose and that are installed separately from the database server. Alternatively, you can create your own user-defined objects for HCL OneDB™.
Creating extensionsYou can create user-defined data types, routines, access methods, and other database objects to suit your needs. You can use application programming interfaces to write user-defined routines and applications that access data in HCL OneDB™ databases.
DataBlade® Developers KitThe DataBlade® Developers Kit (DBDK) guides contain information about the tools you can use to develop and package DataBlade® modules, which extend the functionality of HCL OneDB™ databases.
DataBlade® Developers Kit User's GuideThe HCL OneDB™ DataBlade® Developers Kit Users Guide describes how to use OneDB® DataBlade® Developers Kit (DBDK) tools to develop and package DataBlade® modules.
Programming DataBlade® module routines in CThis section contains information to help you edit and compile C language source code generated by DataBlade®.
Generated code
Utility functions generated by BladeSmithBladeSmith generates utility functions that it calls from other generated code.
The Gen_sscanf() utility functionThe Gen_sscanf() utility function scans one value from an input string and stores it at a given address. Gen_sscanf() returns a pointer that points past the value it scanned from the input string.

The Gen_sscanf() utility function

The Gen_sscanf() utility function scans one value from an input string and stores it at a given address. Gen_sscanf() returns a pointer that points past the value it scanned from the input string.

The Gen_sscanf() function takes the following arguments:

Table 1. Gen_sscanf() function arguments
Argument	Description
Gen_Con	The database connection handle
Gen_Caller	The name of the calling function
Gen_InData	A pointer to the text to be scanned
Gen_InDataLen	An integer containing the length of the text (mi_lvarchar strings are not null-terminated)
Gen_Width	An integer containing the maximum data length for text data
Gen_Format	A string containing a sscanf() format string for the structure member to be scanned
Gen_Result	A pointer to the member in the structure where Gen_sscanf() stores the scanned value

The generated input and import functions call Gen_sscanf() once for each structure member. Gen_sscanf() requires an input string in the current locale and uses the routines to scan the string.