DataBlade Developers Kit User's Guide Programming DataBlade Module Routines in C

When you create new objects, BladeSmith generates the source files; some filenames are prefixed with the name of the DataBlade module (indicated by project). By default, BladeSmith creates the source files in the src and src\c subdirectories of the directory that contains the BladeSmith project file. Generated source files are listed in the following table.

Some of these files are described in the following subsections.

The project.h header file for the DataBlade module contains:

• definitions for error messages used in generated code.
• function prototypes for utility and tracing functions BladeSmith provides.
• DBDK_TRACE macros for the BladeSmith tracing facility.
• a type definition for the MI_LO_HANDLES structure returned by smart large object functions.
• type definitions for opaque type structures defined in the BladeSmith project.

The support.c source code file for the DataBlade module project contains:

• #include directives for standard C and DataBlade API header files.
• utility functions called from BladeSmith-generated routines.

The udr.c source code file for the DataBlade module project contains function declarations for user-defined C routines, cast support routines, and aggregates in the BladeSmith project.

Each opaque data type has a source code file, Opaque.c, where Opaque is the name of the opaque data type. The Opaque.c source code files contain function definitions for opaque type support routines specified in the DataBlade module project.

The statistics.c source code file for the DataBlade module project contains user-defined statistics support routines for each opaque data type with statistics support.

The project.dsp file is the Visual C++ project file that contains the project information for both C and C++/ActiveX code: for example, a list of the source code files. For more information about C++/ActiveX code, see Chapter 6, Creating ActiveX Value Objects.

The project.dsw file is the Visual C++ workspace file that contains workspace information and refers to the project file for project information. You open the project.dsw file to edit and compile your source code.

For more information on compiling using the project.dsw file, see Compiling on Windows NT.

The warning.txt file includes the following types of warnings about your source code:

• Unfinished code. The file lists the routines to which you need to add code.
• User-defined statistics. If you included statistics-support functions for an opaque data type, a warning states that user-defined statistics are only available for Dynamic Server Version 9.2 and later.
• Long identifiers. If you created any objects with long identifiers, a warning states that long identifiers are only available for Dynamic Server Version 9.2 and later.
• The mi_selfuncarg data type. If you included the mi_selfuncarg data type in an extended data type, a warning states that the data type is deprecated for Dynamic Server Version 9.2 and later.

The warning.txt file might contain other warnings, as appropriate for your source code.