Exercise 4.3: Setting up the iSeries server information

Before you begin, you must complete Exercise 4.2: Creating a dynamic Web project.

Before you can start creating your application, you will need to define where the RPG program you will connect to later on in this tutorial is located. You need to specify the iSeries server name and the user-ID and password to be used when starting the job on the iSeries to run your program.

To set up the iSeries server:

  1. In the Web perspective, right-click the WSSLABxx project in the Project Explorer.
    Setup iSeries information
  2. Click Specify iSeries Web Tools Run-Time Configuration on the pop-up menu.

    Tip: You could also use the Configure iSeries button button from the workbench toolbar to open the Run-Time Configuration wizard.

    The iSeries Web Tools Run-Time Configuration wizard opens.
    Wizard to specify your iSeries server information

    You use this wizard to specify how Web interactions that perform program calls to an iSeries host should be connected and authenticated.

  3. In the Host name field, type the name of the iSeries host where your program is located, for example s400a.
  4. Enter your user ID and password for the iSeries host in the appropriate fields.

    You need to ensure that your User ID has been set up in a way that it contains the correct library list. If not, you will have to use the table on the next page to add a library to the library list when the job gets started to run your program.

  5. Enable password-encoding is selected by default. This option ensures that the password appears in encoded format in the web.xml file. If you clear the check box for this option, the password appears as plain text in the web.xml file.
  6. Click Next.
  7. (Optional) If you need to add WSSLABxx to your library list, then type WSSLABxx in the Library field and click Add.
  8. Select the Display detailed run-time errors check box to see the details for any errors that occur during the runtime of your Web application. This is useful for tracing and debugging development errors that may occur.
    Configure Run Time
  9. Select the Use iSeries message file check box to retrieve error messages from the iSeries host.
  10. Click Browse to specify the iSeries message file.
  11. Click the plus sign + beside s400a.
  12. Click the plus sign + beside *LIBL.
    Locating the message file
  13. Drill down to WSSLABXX > MYMSGF.*msgf.
    Locating the iSeries message file
  14. Click OK.
  15. Click Finish to define authentication and run-time values for your host program or procedure call to be made by your Web interaction in the Web project.

You have defined where the RPG program or service program resides on the iSeries server.

Module recap

You have completed Module 4. Creating a Web project. You have learned how to:

Now that you have created a Web project, you can continue to Module 5. Creating a Web application.