
JBuilder Integration Notes (JBuilderNotes.txt)
InterClient 3.00
Last modified: October 22, 2002


JBuilder .config and .library 

NOTE: JBuilder must *not* be running while installing InterClient.

After installing your InterClient JDBC driver, use the steps below 
to set it up for use with JBuilder. Currently, the InterClient
installation does not automatically create the .config and .library
files for InterClient that are required by JBuilder. Please 
follow the instructions below and manually create the required 
files.

Note: Uninstalled drivers are red on the Drivers list in the 
Connection Property dialog box and cannot be selected for use in 
JBuilder. You must install the InterClient JDBC driver first 
before setting it up in JBuilder. 

Creating the .library and .config files:
---------------------------------------

There are three steps for adding a database driver to JBuilder: 
1. Create a library file--typically a .jar file--that contains 
   the driver's classes and any other auxiliary files, such 
   as documentation and source. 
2. Derive a .config file from the library file. JBuilder 
   adds this to its classpath at start-up. 
3. Add the new library to your project, or to the Default project 
   if you want it available for all new projects. 

The first two steps can be accomplished in one dialog box: 
1. Open JBuilder and choose Tools|Enterprise Setup. Click the 
   Database Drivers tab to view the .config files for all 
   the currently known database drivers. 
2. Click Add to add a new driver, then New to create a new library 
   file for the driver. The library file is used to add the driver 
   to the required libraries list for projects. Note: You can also 
   create a new library under Tools|Configure Libraries, but since 
   you would then have to use Enterprise Setup to derive the .config 
   file, it is simpler to do it all here. 
3. Type a name and select a location for the new file in the 
   Create New Library dialog box. 
4. Click Add and browse to the location of the driver. You can 
   select the directory containing the driver and all its support 
   files, or you can select just the archive file for the driver. 
   Either will work. JBuilder will extract the information it needs. 
5. Click OK to close the file browser. This displays the new library 
   at the bottom of the library list and selects it. 
6. Click OK. JBuilder creates a new .library file in the JBuilder 
   /lib directory with the name you specified (for example, 
   InterClient.library). It also returns you to the Database Drivers 
   page, which displays the name of the corresponding .config file 
   in the list which will be derived from the library file 
   (for example, InterClient.config). 
7. Select the new .config file in the database driver list and 
   click OK. This places the .config file in the JBuilder /lib/ext 
   directory. 
8. Close and restart JBuilder so the changes to the database drivers 
   will take effect, and the new driver will be put on the JBuilder 
   classpath. 

Important: If you make changes to the .library file after the 
.config file has been derived, you must re-generate the .config 
file using Enterprise Setup, then restart JBuilder. 

Adding the InterClient JDBC driver to projects:
----------------------------------------------

Projects run from within JBuilder use only the classpath defined 
for that project. Therefore, to make sure the JDBC driver is 
available for all new projects that will need it, define the 
library and add it to your default list of required libraries. 
This is done from within JBuilder using the following steps: 

1. Start JBuilder and close any open projects. 
2. Choose Project|Default Project Properties. 
3. Select the Required Libraries tab on the Paths page, then click 
   the Add button. 
4. Select the new JDBC driver from the library list and click OK. 
5. Click OK to close the Default Project Properties dialog box. 

Note: You can also add the JDBC driver to an existing project. 
Just open the project, then choose Project|Properties and use 
the same process as above. 

__________________________________________________________________
Copyright (c) 2002 Borland Software Corporation
All rights reserved.

