Configuring your IBM i Web Service runtime environment

On the Select Service Implementation window you can click Edit where you can access a dialog to set the authentication and runtime configuration values for the IBM® i programs and procedures called from your Web application.

Authentication

About this task

On the first page of the IBM i Web Service Runtime Configuration dialog, specify how to connect and authenticate Web services that perform program calls to an IBM i host.

Procedure

Library List

About this task

On the second page of the IBM i Web Service Runtime Configuration dialog, define the runtime library list information for Web services that perform program calls to an IBM i host.

Procedure

  1. Add any runtime libraries that your program requires in the Runtime library list area. This results in the libraries being added to the library list on the IBM i server when the job is first created and before the IBM i program or procedure is invoked.
    1. Enter the name of the library in the Library field and click Add to add it to the list.
    2. Click the Library Position field and select *FIRST or *LAST to indicate whether the library should be added first or last in the list. Press Enter to save the entry in the library list. The libraries in the list are used by the program at run time.
    3. To remove a library from the list, select the library and click Remove.
    4. Use Move Up and Move Down to change the order of the libraries in the list.
  2. If you select *CRTDFT for Current library, any objects that are created into the current library using *CURLIB on the create command, the QGPL library is used as the default current library. If you select *USRPRF for Current library, then the setting in the user profile is used.
  3. In the Initial command field, specify the host command to run after signing on to the host system. For example, you can specify a CL setup program to set the environment before invoking applications. This program could add additional libraries to the library list, depending on the user ID.

What to do next

The runtime configuration file

A runtime configuration file with all your settings is generated and placed in the source folder of the service project.

The generated Java bean, by default, looks for the runtime configuration file in the class path.

If the Web service is created from a file that has an IBM i connection (for example, a file chosen from the Remote System Explorer) then the fields under both wizard pages are prefilled with the connection information.

Additional considerations

In addition to defining authentication and runtime values, you should ensure that host servers are running on your IBM i host. The servers are *SRVMAP, *CENTRAL, *RMTCMD, and *SIGNON. You start a host server with the STRHOSTSVR command. For example, enter STRHOSTSVR *RMTCMD to start the *RMTCMD server. To start all host servers, use the command STRHOSTSVR *ALL.

To test IBM i Web services in the Rational Test Environment, you need a TCP/IP connection to your IBM i host, and the user profile QUSER must be enabled.


Feedback