INFORMIX
DataBlade Developers Kit User's Guide
Chapter 3: Using BladeSmith
Home Contents Index Master Index New Book

Creating a New Project

The first step you complete in BladeSmith to create a DataBlade module is to create a project for it. BladeSmith saves DataBlade module object definitions in a project file with an .ibs extension. BladeSmith generates source code, SQL scripts, functional tests, and installation package files in directories that are relative to the project file. By default, BladeSmith creates subdirectories src, scripts, functest, and install in the directory where you save the project file.

Important: Create a different project directory for each DataBlade module so that BladeSmith does not overwrite any other files.
When you create a project, use the DataBlade module project name and three-character new object prefix assigned to you by Informix. See "Contacting the Informix Registry" for more information.

To create a new project, choose Project New and complete the information requested by the New Project wizard; then save your project file in the directory you created. BladeSmith creates the necessary subdirectories when you generate files.

The following table lists the properties you must specify when you create a project.
Property Default Value Description

DataBlade module name

NewProject

The name of the DataBlade module project. Obtain this name from Informix.

See "DataBlade Module Project Name" for more information.

New object prefix

None

A three-character prefix used in naming new objects. Obtain this prefix from Informix.

See "New Object Prefix" for more information.

Description locale

The locale of your Windows installation

The language code set for the project.

See "Description Locale" for more information.

Project version numbers or letters

Major: 1
Minor: 0

Optional. One to four numbers or letters separated by periods to designate version information.

See "Project Version Numbers" for more information.

Project description

None

Optional. A description of the DataBlade module. This information appears to the user, if requested, when the DataBlade module is registered with BladeManager.

Vendor information

None

Optional. Information about the company developing the DataBlade module, including company name, copyright, and contact. This information appears to the user, if requested, when the DataBlade module is registered with BladeManager.

DataBlade Module Project Name

The project name is combined with the version numbers as a unique identifier to use to register the DataBlade module in the database server and to create the installation directory. The project name must follow standard directory naming conventions.

If you change the project name or version numbers, you must regenerate files in BladeSmith.

For more information on obtaining the project name, see "Contacting the Informix Registry".

New Object Prefix

The three-character new object prefix assigned to your DataBlade module by Informix is used in the name of many of the new objects you create in BladeSmith. Use this prefix to ensure that your objects have unique names in the database when the DataBlade module is registered. See "Contacting the Informix Registry" for information on obtaining a new object prefix.

Use your registered DataBlade module new object prefix to begin the names of the following objects:

You do not have to use the DataBlade module new object prefix for the following objects:

Description Locale

A GLS description locale is a set of files that contain information specific to a particular language and culture. A GLS locale provides the following information:

The default locale is the locale that your Windows NT installation uses. For example, Windows installations running U.S. English use the en_us.1252 locale. To change the locale, type a new locale specification in the Description Locale field. See the Guide to GLS Functionality for more information on locales and how to access a list of available locales.

When you generate SQL scripts, BladeSmith uses the locale information to generate a locale-specific prepare script and locale-specific error scripts.

Project Version Numbers

The optional version information can be one to four numbers or letters separated by periods: for example, 1.2.3.4. Use a consistent versioning format for all your projects.

The version numbers are combined with the project name as a unique identifier to register the DataBlade module in the database server and to create the installation directory.

If you change the version numbers or project name, you must regenerate SQL files and installation packaging files in BladeSmith.




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