IBM Support

How to Deploy a Web Service from an IASP for an Integrated Web Services (IWS) Server on the IBM i

Troubleshooting


Problem

This document will discuss how to deploy a Web service program from a library that exists in an Independent Auxilary Storage Pool (iASP) for an Integrated Web Services (IWS) Server on the IBM i. The Web Service program can either be a *SRVPGM or *PGM object.

Resolving The Problem

How to Deploy a Web Service from an IASP for an Integrated Web Services (IWS) Server on the IBM i

Notes:

1.This document assumes the user has already created their Integrated Web Services (IWS) Server. If you don't currently have an existing IWS Server, you can create one through the "Setup -> Create a New Web Services Server" wizard in the IBM Web Administration console for i.
2.The program object to externalize as a Web service must be an existing Integrated Language Environment (ILE) program (*PGM) or service program (*SRVPGM) object. Currently, only program objects created using the COBOL or RPG programming languages are supported. 
To deploy a Web service from an IASP for an IWS server on the IBM i, you should do the following:
1.Open a Web browser and enter the following URL to access the IBM Web Administration console for your IBM i server.

http://<serverName>:2001/HTTPAdmin
2.Select the Manage -> Application Servers tabs in the top, left-hand menu to manager your application servers:

Screen shot of the IBM Web Administration menu bar highlighting Manage -> Application Servers
3.Select your IWS Server from the drop down list next to Server. It should have the words (web services) at the end of the name and after its Axis runtime version.
4.On the left-hand, vertical menu bar under Web Services Wizards; click on the Deploy New Service link:

Screen shot of the left-hand, vertical menu bar for a IWS server highlighting Deploy New Service
5.Click the Next button on Step 1 of the Deploy New Service wizard.
6.Select the Browse the integrated file system for the IBM i program object radio button. Then, specify the IFS path to the *SRVPGM or *PGM Web Service program object in the following format:

/<IASP>/QSYS.LIB/<YOURLIB>.LIB/<YOURPGM>.SRVPGM/PGM

For example, /IASP/QSYS.LIB/QGPL.LIB/RPGWEB.SRVPGM

Where <IASP> is the mount point name for the IASP. In the above example, IASP was used as the mount point name.

Screen shot of Step 2 in the deploy new service wizard showing an example for browse the IFS for the IBM i pgm object.
7.Click the Next button to proceed with the Wizard.
8.Complete the rest of the steps in the Wizard and finish by clicking on the Finish button to complete the deployment of the Web Service from an IASP IFS path.

[{"Type":"MASTER","Line of Business":{"code":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"6.1.0"}]

Historical Number

677215923

Document Information

Modified date:
18 December 2019

UID

nas8N1010318