Interaction name and location

Use this page of the wizard, Specify a Name and Location for your Web Interaction, to enter a name for the Web interaction that you want to create, and to indicate the location of the files that are created for the Web interaction.

Option Description
Destination folder The WebContent folder is the default destination folder for JSP files that are generated by the wizard. If you specify another destination folder, that folder must be within the WebContent folder.
Web interaction name Enter a unique name to identify the Web interaction.

When the Web interaction is created, this interaction name is associated with a .wit file that is created in the Web project. (For example, the .wit file that is created for a Web interaction name of cust is cust.wit.) If you want to modify the Web interaction, double-click the .wit file to open the Web Interaction wizard and modify the settings for the interaction.

Java package prefix

Indicates the prefix of the Java package that is created for the Web interaction.

You can change the Java package prefix in this field if you want to use a different package name.

By default, the Java package prefix is the value specified in the preferences for Web Tools > Struts and JSF Preferences, plus the Web project name. For example, if com.ibm is specified in the preferences for Struts and JSF Preferences, and the Web project name is myproj, the default Java package prefix is com.ibm.myproj.

The action classes and form beans generated by the wizard are organized by package names containing .actions and .forms as suffixes, respectively. For example, if the default Java package prefix is com.ibm.myproj, the packages that are created are com.ibm.myproj.actions and com.ibm.myproj.forms.

You can change the Java package prefix:
  • In Preferences by selecting Window > Preferences. Then expand Web Tools and select Struts and JSF Preferences in the left pane of the Preferences window to display the Default Java package prefix field in the right pane of the window.
  • On the Struts Settings page of the New Dynamic Web Project wizard when you create a Web project.
  • In the Web project properties by right-clicking the project name, selecting Properties, and then select Struts and JSF in the left pane to display the Default Java package prefix field in the right pane of the window.
  • By default, the Java package prefix is the value specified in the preferences in Web Tools > Struts and JSF Preferences plus the Web project name, for example, com.ibm.myproj.
Use error page

This option is selected by default. The first time you start the wizard in any Web project, an error.jsp file is automatically created in the WebContent folder.

The error.jsp file contains tags that are used to display run-time errors. If you want to use your own file to display run-time errors, you need to ensure that you copy the body of the error.jsp file to your file.

To select your file, use Browse to find and select the page in your Web project.
Invalidate session after the interaction occurs Select this option to indicate the end of a unit of work. For example, you can select this option if this is the last interaction in a series of interactions. This option also ends the iSeries job.
Terminate iSeries connection Select this option to terminate the connection to the iSeries system after the interaction occurs. This option and Invalidate session after the interaction occurs are mutually exclusive. If you select one, you cannot select the other.
Interaction URL
Note: This is a read-only field and it only appears on the page when you open the Web Interaction wizard to modify an existing interaction.

The field contains the URL information that was generated when the interaction was first created.

Example: for Web interaction cust, where parameter names custna (for customer name), caddr (for customer address), and cphone, (for customer phone number), have been specified, the interaction URL appears as:
custServlet.do?custna=#1&caddr=#2&cphone=#3&_witreq=1
The interaction URL shows you the action to invoke as well as the parameters it expects. For example, you could have the following link on a page:
<a href="custServlet.do?custna=Joe&caddr=Main%20St&cphone=555-1212&_witreq=1">Show Joe Info</a>
to display information about the customer name, address, and phone number that you specified.