Configuring your iSeries Web Service runtime environment

On the Object Selection page of the Web Services wizard you can access a dialog to set the authentication and runtime configuration values for the iSeries programs and procedures called from your Web application.

Related tasks
Creating an iSeries program Web service
Testing an iSeries Web service
Developing iSeries Web services without source files
Related reference
Edit Web service program
Edit Web service parameters

Authentication

On the first page of the iSeries Web Service Runtime Configuration dialog, specify how to connect and authenticate Web services that perform program calls to an iSeries host. By default, the configuration file name is the same as the Java bean name, with an extension of .config, and is stored in the source folder of the service project specified on the Service Deployment Configuration page of the Web Service wizard. You can browse for another configuration file or you can type in a new configuration file name. The browse dialog contains the names of all the .config files in your project. More than one Web service can refer to the same .config file.

Library List

On the second page of the iSeries Web Service Runtime Configuration dialog, define the runtime library list information for Web services that perform program calls to an iSeries host.
  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 iSeries server when the job is first created and before the iSeries 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.
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 iSeries connection (for example, a file chosen from the Remote System Explorer) then the fields under both wizard pages are pre-filled with the connection information.

Additional considerations

In addition to defining authentication and runtime values, you should ensure that host servers are running on your iSeries 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 iSeries Web services in the WebSphere Test Environment, you need a TCP/IP connection to your iSeries host, and the user profile QUSER must be enabled.