C:\> runide.exe [switch]

See the next section for information on switches.

Modifying the Session With Command-Line Switches

TABLE 1-1 describes the switches that you can use to modify how you launch the IDE. This information is also available from the Forte for Java 4 Getting Started Guide, but is provided here for your convenience.

• On Microsoft Windows systems

You can set options when running the IDE on the command line.

• In Solaris, Linux, and other UNIX environments

You can modify the ide.sh file in the bin subdirectory of the installation directory, or you can create your own shell script that calls ide.sh with options.

Specifying Your User Settings Directory

The Forte for Java 4 IDE stores your individual projects, samples, and IDE settings in your own special directory. This enables individual developers to synchronize their development activities, while keeping their own personal work and preferences separate.

• In Solaris, UNIX, or Linux environments

If you don't explicitly specify a user settings directory with the -userdir command-line switch, user settings are located by default in user-home/ffjuser40ce.

• On Microsoft Windows systems

At first launch of the Forte for Java 4 IDE, you are prompted to specify a user settings directory. Use a complete specification, for example, C:\MySettings.

This value is stored in the registry for later use. For a given session, you can specify a different user settings directory by using the -userdir command-line switch when launching the IDE.

---

Understanding the Forte for Java 4 Directory Structure

When you install the Forte for Java 4 software, the subdirectories described in TABLE 1-2 are included in your installation directory.

When you launch the Forte for Java 4 software, the subdirectories in TABLE 1-3 are installed in your user settings directory. Most of them correspond to subdirectories in the Forte for Java 4 home directory, and are used to hold your settings.

---

Verifying the Correct Default Web Server

The CDShopCart tutorial uses the Tomcat 4.0 web server. This server is installed and set as the default web server by the Forte for Java 4 installer. However, you should verify that Tomcat is the default server before you test or run the CDShopCart application.

To verify that the Tomcat web server is the default server:

1. In the Forte for Java 4 IDE, click the Explorer's Runtime tab.

2. Expand the Server Registry node and its Default Servers subnode.

• If the Default Servers node looks like this, then the IDE is using the correct server.

• If anything other than Tomcat 4.0 is listed, then:

a. Right-click the default web server node and choose Set Default Server.

The Select Default Web Server dialog box is displayed.

b. Select the correct server and click OK.

---

Creating the Tutorial Database Table

Before you start the Forte for Java 4, Community Edition tutorial, you must create and install a database table. Instructions in this section describe how to install the table in a PointBase database. If you wish to use a different database program, other versions of the tutorial SQL script are provided in Appendix B.

Alternatively, files containing the SQL script are included in the zip file of the tutorial source code, which you can download from the Forte for Java Developer Resources portal at:

http://forte.sun.com/ffj/documentation/tutorialsandexamples.html

TABLE 1-4 identifies the four available SQL script files.

The CDCatalog script creates the database schema shown in TABLE 1-5.

The CD table is populated with the records shown in TABLE 1-6.

First create a tutorial database and load the table into it. (If you prefer, you can install the table in any PointBase database you choose.)

To create the tutorial database table:

1. Start the PointBase Server.

• In Solaris or Linux environments: Run the Server file in the forte4j-home/pointbase/server directory.
• On Microsoft Windows: Choose Start Forte for Java 4.0 CE PointBase Server or double-click the server.bat file in the forte4j-home/pointbase/server directory.

2. Start the PointBase Console.

• In Solaris or Linux environments: Run the Console file in the forte4j-home/pointbase/client directory.
• On Microsoft Windows: Choose Start Forte for Java 4.0 CE PointBase Console or double-click the console.bat file in the forte4j-home/pointbase/client directory.

The Connect To Database dialog box appears, showing values for the PointBase driver to the default sample database.

3. Change the word sample at the end of the URL field to cdshopcart, as shown.

[ D ] 

4. Set the Create New Database option and click OK.

The PointBase Console is displayed. Wait until the status message ending in "Ready" is displayed before proceeding.

5. Copy the PointBase script from Script for a PointBase Database and paste it into the SQL entry window of the Console.

Alternatively, if you have the CDCatalog_pb.sql file from the tutorial source zip file, do this:

a. Choose File Open to display the file browser dialog box.

b. Use the file browser to find the CDCatalog_pb.sql file and click Open.

6. Choose SQL Execute All.

The message window confirms that the script was executed. (Ignore the initial messages beginning "Cannot find the table..." These appear because there is a DROP statements for the table, which has not been created yet. This DROP statement will be useful in the future if you want to rerun the script to initialize the table.)

Two database files are created in the forte4j-home/pointbase/databases directory.

7. Test that you have created the table by clearing the SQL entry window (Window Clear Input) and typing:

SELECT * FROM CD;