Introduction

JDataStore is a feature of JBuilder Professional and Enterprise, and the Inprise Application Server.

JDataStore is a high-performance, small-footprint, 100% Pure JavaTM multifaceted data storage solution. JDataStore provides:


When to use JDataStore

With a JDataStore, you can


JDataStore and DataStore

JDataStore is the name of the product, tools and file format. DataStore is the name of the package and classes.


What you should know

The JDataStore Developer's Guide assumes you have a working knowlege of


What's in this book

For an explanation of documentation conventions, see "JBuilder documentation conventions."

The JDataStore Developer's Guide consists of general guide and tutorial to using JDataStore followed by reference material. It contains these chapters:


Using JDataStore for the first time

Before you can use JDataStore, you must enter your development license information. Please note that the JDataStore development license key is separate from any license key you may have for JBuilder.

Reminder: JDataStore comes with one free development license. When you are ready to deploy JDataStore, you will need to purchase additional deployment license(s). Please contact Borland Customer Service for more information.

The first step is to find your JDataStore development license key. The location could vary, depending on how you purchased JDataStore.

If you received JDataStore on a JBuilder CD, it will be in the setup folder on the CD. The file will be named setup_<platform>.html. Select the appropriate file for your platform, and click the "Run JDataStore" link.

If you purchased JDataStore standalone, you will need to register your product to receive your development license key from Borland Customer Service.

After you have located your key(s):

Start the JDataStore Explorer. You can do this in JBuilder by going to Tools | JDataStore Explorer. Another way to start JDataStore Explorer is via a shortcut or command line.

Now select File | License Manager. Click Add. Enter your serial number and key and click OK. Click OK on the JDataStore License Manager. The License manager creates the license file jdatastore.license which you will need to run JDataStore. This file needs to be in the classpath whenever you are running JDataStore.


Starting with the JDataStore Explorer

DataStore Explorer (DSX) is an all-Java visual tool that helps you manage your JDataStores. It is covered in detail in "Using the JDataStore Explorer." By using the JDataStore Explorer in conjunction with the sample JDataStore files that ship with JBuilder, you can get an quick idea of what a JDataStore can do.

The JDataStore Explorer provides visual tools for performing many maintenance tasks. The Developer's Guide explains the fundamentals using the basic JDataStore API. You could begin by going to the JDataStore Explorer chapter first, however.

Throughout the JDataStore Developer's Guide, you'll see the following notation, which indicates some task that can be performed visually with the JDataStore Explorer:

DSX: This notation is accompanied by a reference to that task in the JDataStore Explorer.


Deploying JDataStore application components

You can find information on deploying the JDataStore Server for remote access in "Deploying the JDataStore Server." For tips on reducing the deployed size of JDataStore client applications, see "Pruning deployed resources."

Reminder: JDataStore is provided with a license for development only. For deployment, you must purchase additional licenses. Contact Borland Customer Service for more information.


Contacting Borland developer support

Borland offers a variety of support options. These include free services on the Internet, where you can search our extensive information base and connect with other users of Borland and Inprise products. You can also choose from several categories of support, ranging from help on installing the Borland product to fee-based consultant-level support and detailed assistance.

For more information about Borland's developer support services, see our Web site at http://www.borland.com/devsupport, call Borland Assist at (800) 523-7070, or contact our Sales Department at (831) 431-1064.

When contacting support, be prepared to provide complete information about your environment, the version of the product you are using, and a detailed description of the problem.