Creating a new 4GL JSP page

You create new 4GL JSP pages using the 4GL JSP Page wizard. If you want to change an existing page to 4GL mode, you can enable 4GL mode by selecting a check box in the Page Properties dialog box for the page.

The 4GL JSP Page wizard prompts you for basic design information, options for error reporting, page parameters, and EAServer components that you want to use on the page. If you are unsure about values to enter for a particular wizard field, you can leave the field blank or accept the field default, then add or change the information later in the Page Properties dialog box.

**Table 9-1: 4GL JSP Page wizard page design information**
Specify this	To do this
Style sheet	Select an existing style sheet for the page.
Background image	Select an image that displays as the page background.
Scroll image	Make the background image scroll with the page.
Background color	Select a color for the page background.
Header based on title	Add a page header that is the same as the title. This header appears on the printed version of the page.
Date created footer	Add a page footer that shows the date the page was created. This footer appears on the printed version of the page.

Table 9-1: 4GL JSP Page wizard page design information

Specify this

To do this

Style sheet

Select an existing style sheet for the page.

Background image

Select an image that displays as the page background.

Scroll image

Make the background image scroll with the page.

Background color

Select a color for the page background.

Header based on title

Add a page header that is the same as the title. This header appears on the printed version of the page.

Date created footer

Add a page footer that shows the date the page was created. This footer appears on the printed version of the page.

The 4GL JSP Page wizard also includes a page with selections for the specialized error reporting capabilities available to 4GL pages:

**Table 9-2: Error reporting selections for 4GL pages**
Select this	To do this
Show runtime errors in alert message box	Display page processing errors in an alert message box
Show runtime errors as text at the top of the page	Display page processing errors at the top of a generated page
Show runtime errors as text at the bottom of the page	Display page processing errors at the bottom of a generated page
Enable trace	Display detailed information about page processing during page development

Table 9-2: Error reporting selections for 4GL pages

Select this

To do this

Show runtime errors in alert message box

Display page processing errors in an alert message box

Show runtime errors as text at the top of the page

Display page processing errors at the top of a generated page

Show runtime errors as text at the bottom of the page

Display page processing errors at the bottom of a generated page

Enable trace

Display detailed information about page processing during page development

To create a new 4GL JSP page:

From a Web target select File>New from the menu bar

Right-click a target or target folder in Workspace view and select New from the pop-up menu.

Click the Web tab in the New dialog box.

Make sure the Web target to which you want to add a 4GL JSP page is selected in the Target drop-down list box.

Click the 4GL JSP Page wizard icon to start the wizard, then click Next.

On the Specify New 4GL JSP File page of the 4GL JSP Page wizard, enter the title and file name for the page you want to create.

Provide design information for your Web page in subsequent wizard pages.

Specify options for error reporting and click Next.

Specify any page parameters that will provide input values for the page, and click Next.

You can add page parameters at a later time from the Page Properties dialog box for your page.

Select an EAServer profile, making sure the EAServer you select is running, and click Next to list the available components on this server or Select the Skip EAServer Components check box if you want to select components at a later time, then click Next and skip the next step in this procedure.

This wizard page lists EAServer profiles already configured in your development environment.

Make sure your EAServer is running If you click Next without selecting the Skip EAServer Components check box, the wizard attempts to connect to the server that is selected in the Choose EAServer Profile dialog box.

Select the EAServer components you want your 4GL JSP page to access, and click Next.

Shown is the Select E A Server Components screen of the 4 G L wizard, which has instructions to select E A Server components for data binding or to skip this step and drop components on the screen later. A list of E A Server components is displayed in a dialog box and boxes are checked for sample components named n _ customer and n _ movie under the expanded sample entry named Surf Side Video P B.

On the last wizard page, review the summary of page properties, and click Finish.