DataBlade Developers Kit User's Guide

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

Home Contents Index Master Index New Book

Source Files Generated by BladeSmith

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\C subdirectory of the directory that contains the BladeSmith project file. Generated source files are listed in the following table.


Filename	Type of File	More Information
project.h	C header file	See "C Header File" for more information.
support.c udr.c opaquename.c	C source code file	See "C Source Code File" for more information.
project.def	C definition file	This file lists the exported routines declared in the source code file.
readme.txt	Text file	This file describes the files in the src directory.
UNIX.mak project.mak WinNT.mak	Makefiles	Use these files for compiling on UNIX and Windows NT operating systems. See "Makefiles" for more information.

Some of these files are described in the following subsections.

C Header File

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 typedef for the MI_LO_HANDLES structure returned by smart large object functions.
typedefs for opaque type structures defined in the BladeSmith project.

C Source Code File

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 all user-defined C routines, casts, and aggregates in the BladeSmith project.

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

Makefiles

BladeSmith generates these makefiles for every project:

UNIX.mak

project.mak

WinNT.mak

For instructions on using makefiles to compile and link your source code, see the section "Compiling DataBlade Module Code".

DataBlade Developers Kit User's Guide, version 3.6
Copyright © 1998, Informix Software, Inc. All rights reserved.