Creating an iSeries program Web service

You can create a Web service out of ILE RPG or COBOL source or PCML files using the Web Service wizard.

Start the application server before running the Web Service wizard.

From the Servers view (Window > Show View > Servers), right-click on a server in the list and select Start.

You may experience errors if this step is not completed and it may take several minutes for the server to start.

This tool set offers two basic approaches to creating an iSeries program Web service:
  • For ILE RPG and COBOL source, or PCML files, you can use the Web Service wizard directly.
  • For other iSeries source (like ILE C) you can use the Program Call wizard to produce a Java bean that can then be used by the Web Service wizard.
This task describes the process for ILE RPG and COBOL programs.

From the Remote System Explorer perspective, the iSeries Projects perspective, or a dynamic Web project, you can create Web services from ILE RPG or COBOL source, or from a PCML file.

If you start from Remote System Explorer or iSeries Projects, or if you use the Browse for File dialog, any connection information you have already defined is used by the Web Service wizard.

  1. Ensure Web Services Development is enabled on the Capabilities page of the Preferences dialog. Then create an iSeries program Web service in one of the following ways:
    • Click File > New > Other, expand Web Services and select Web Service.
    • Right-click on the ILE RPG, COBOL, or PCML source object and select Web Services > Create Web Service.

    The Web Service wizard appears.

    First page of Web Service wizard

  2. In the Web service type field, iSeries Program Web Service should be highlighted. If not, select it from the drop down list.
  3. Click Next.

    The Object Selection Page appears.

    Object Selection page of Web Service wizard

  4. If you did not select an ILE RPG, COBOL, or PCML source object before starting the wizard, click Browse files next to the File name field to open the Browse for file window.
  5. Select a PCML, ILE RPG, or COBOL file from your remote or local file system and click OK.
  6. Specify the name of the runtime configuration file in the Runtime configuration field. By default, this name is the same as the Java bean name, with an extension of .config. The runtime configuration file is placed within the source folder of the Service project specified on the next page of the Web Service wizard.
  7. Click Browse next to the Runtime configuration field to find authentication and runtime configuration values, or click Edit to set them.
  8. Click Next. The Service Deployment Configuration page appears.
  9. Click Edit to set the Web service runtime protocol and deployment server, if necessary.
  10. Select a deployment server, Web service runtime, and the J2EE version and click OK.
  11. On the Service Deployment Configuration page, specify a service project in the Service project field.
  12. If the EAR project field is enabled, specify the EAR file name for the project. On some configurations (like Apache) this field is disabled.
  13. Either click Finish to create the Web service or click Next to configure advanced options.
Related tasks
Configuring your iSeries Web Service runtime environment
Testing an iSeries Web service
Developing iSeries Web services without source files
Related reference
Edit Web service program
Edit Web service parameters