Webservice from IBM i RPGLE program out to the web

  • Home
  • /
  • Blog
  • /
  • Webservice from IBM i RPGLE program out to the web

December 16, 2011

Webservice from IBM i RPGLE program out to the web

By NickLitten

December 16, 2011

IBM i, webservice

So, for a recent project I wanted to create a simple webservice, a “heartbeat” program that would be written in RPG and would reply to anbody calling it from anywhere on the network with a simple response that indicated that it worked.

A webservice is routine that can be called over a TCP/IP network.

• A callable routine. (Program? Subprocedure?)

• Callable over a TCP/IP Network. (LAN? Intranet? Internet?)

• Using the HTTP (or HTTPS) network protocol

….can also be called from the same computer.

The idea is that this webservice will allow other computers on the network to communicate with our IBM i system and get a reply back sayiing “Hello, everything is hunky dory”. Tihs is called providing the webservice.

The computer that runs this servcice and gets the reply – is consuming the webservice.

I could do this using an opensource plugin like HTTPAPI (aka LIBHTTP) but this time I’m going to create it as a webservice that is called directly from the IWS (Integrated WebServer – aka IBM Apache Server)

OK – onto the nitty gritty

Configure Apache Server to make sure its ready to provide a weservice to the outside world. From the IBM i command line:


then point your browser at the this server to see if its running:


Create a web services Server:

• Click “Internet Configurations” (if IBM i 6.1 or higher)
• Click “IBM Web Administration for i”

# <NJL01> Modification Start
# WebServices added for ACSIS

ScriptAlias /info /qsys.lib/nlitten.lib/webinfo.pgm
ScriptAlias /valbin /qsys.lib/nlitten.lib/webvalbin.pgm
ScriptAlias /getbin /qsys.lib/nlitten.lib/webgetbin.pgm

<Directory /qsys.lib/nlitten.lib>
Order Allow,Deny
Allow From All

# </NJL01> Modification End

Modernization – From AS400 to ISERIES to IBM i on Power Systems

As400 iseries ibm i - legacy software modernization

Learn the history of AS/400, the replacement iSeries machines and then to modern IBM POWER SYSTEMS. Internet connectivity is integral to modern eBusiness – Learn how to work with IBM i Webservices to create new interfaces and modernize old ones.

{"email":"Email address invalid","url":"Website address invalid","required":"Required field missing"}

Join the IBM i Community for FREE Presentations, Lessons, Hints and Tips