Charles Guarino

Transcription

1 Raising the Bar: A Jumpstart to Using SOAP Web Services in RPG Charles Guarino SOAP SERVICES Charles Guarino Central Park Data Systems, Inc. About The Speaker With an IT career spanning over 30 years, Charles Guarino has been a consultant for most of them. Since 1995 he has been founder and President of Central Park Data Systems, Inc., a New York area based IBM midrange consulting and corporate training company. In addition to being a professional speaker across the United States and Europe, he is a frequent contributor of technical and strategic articles and webcasts for the IT community. He is a member of COMMON s Speaker Excellence Hall of Fame and also Long Island Software and Technology Network s Twenty Top Techies. In 2015 Charles became the recipient of the Al Barsa Memorial Scholarship Award. Additionally, he serves as a member of COMMON s Strategic Education Team (SET) and is also a past president and monthly Q&A host of LISUG, a Long Island IBM i User s Group Charles can be reached at cguarino@centralparkdata.com. LinkedIn - Twitter 1

2 In This Session Web services extend your applications by providing functionality you should not or could not write yourself. We will demonstrate what a web service is, where to find them and how to consume them. We will explore how supplying just a zip code to an application can return meaningful and real time information that is well beyond your company s four walls. All of the source code for these programs can be downloaded and compiled on your own systems and be put to use immediately. They are production ready! What We ll Cover Definitions Where are the web services? Testing a SOAP Web Service Our mission SERVICE PROGRAM CREATION!!! A step by step analysis of WSDL2RPG Wrap up 2

3 Definitions Web Service API Application Program Interface SOAP Simple Object Access Protocol SOAP Methods or Operations WSDL Web Services Definition Language URI - Uniform Resource Identifier IWS - Integrated Web Services Definitions HTTP - Server Powered by Apache AXIS The SOAP engine for HTTP servers running Apache QSHELL an environment that runs Unix commands interactively or from a script Stub Code Stub create, operation and destroy procedures 3

4 Simplistic diagram of a web service request Internet System i Some other system More Web Services Fun Facts A STATELESS connection Can be sent in the clear or securely Can be public or private between companies or individuals Hardware, programming language and platform agnostic Can save you lots of $ - pre-written and tested and documented services Can be FREE, Restricted Access, Pay-For-Each-Use or Subscription Based Extends your applications in ways you may have never known possible, providing real time information. Can be many and simultaneous points of failure 4

5 What We ll Cover Definitions Where are the web services? Testing a SOAP Web Service Our mission SERVICE PROGRAM CREATION!!! A step by step analysis of WSDL2RPG Wrap up Where can you find a web service to consume? 5

6 A closer look at the GlobalWeather web service Service Operations 6

7 Operation Operation Service Input form for GetCitiesByCountry operation Italy 7

8 Output from GetCitiesByCountry operation 8

9 9

10 10

11 You can even create your own!!! Step 1 STRTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN) Step 2 From a browser to go For more information Google IBM Web Administration for i What We ll Cover Definitions Where are the web services? Testing a SOAP Web Service Our mission SERVICE PROGRAM CREATION!!! A step by step analysis of WSDL2RPG Wrap up 11

12 Same Web Service using SoapUI graphical interface Typed Italy here Resulting XML here 12

13 What We ll Cover Definitions Where are the web services? Testing a SOAP Web Service Our mission SERVICE PROGRAM CREATION!!! A step by step analysis of WSDL2RPG Wrap up If zeros are entered display the first error message: 13

14 When an invalid zip code is keyed, display second error message : If an error occurs when service is called display third message: 14

15 Subfile displayed with fully parsed data for zip code 10038: If F1 is pressed launch Internet Explorer and display weather.com 15

16 What We ll Cover Definitions Where are the web services? Testing a SOAP Web Service Our mission SERVICE PROGRAM CREATION!!! A step by step analysis of WSDL2RPG Wrap up Let s go through the steps to see how we achieved this! Download the IBM Web Services Client for ILE Programming Guide Verify licensed programs on your system Select a SOAP web service and identify the WSDL URI Choose a folder where you want to create and store your stub code Decide which library you want the tool to create your service program Start QSHELL and run the command Create a binding directory and add the service program as an entry Identify the incoming and outbound parameters for the service using RPGLEINC member Create your RPG program to prepare the service to run ( create ), consume the service and then free up ( destroy ) the resource upon completion. 16

17 Google IBM Web Services Client For ILE Programming Guide IBM Licensed Program Requirements 17

18 The WSDL URI 18

19 Where we ll store the code Source code will automatically be placed in the IFS By default it is placed in your HOME directory You can override this location at creation time We will not use the default for this example We will use folder WEBSERVICE/WEATHERWS Our service program will be placed in library WEBSERVICE WSDL2WS.SH (runs in QSHELL) 19

20 The parameters continued WSDL2SH.SH {arguments} WSDL-URI Parameters you will likely be using: -l -o -s -d -ma Target language object directory Service program and library Create service program with debug views Maximum array size (default is 20) -p Prefix for modules VERY IMPORTANT if you use only one library for development 20

21 WSDL2RPG!!! If you Google this you will likely also find the non-ibm version written by Thomas Raddatz. This is NOT the one supported by IBM. STRQSH 21

22 A line by line analysis Execute command wsdl2ws.sh from the install directory of /qibm/proddata/os/webservices/v1/client/bin The URI where the WSDL is located 22

23 Place the objects in directory /webservices/weatherws Create RPG language source members Create service program weathersvc with debug views Create the service program WEATHRSVC in library WEBSERVICE 23

24 SUCCESS!!! SUCCESS Using RDi Right click on Qshells>Launch Shell 24

25 What just happened? -o/webservices/weatherws Source members created in /webservices/weatherws 25

26 Identify the web service create and destroy prototypes and their parameters. These will be found in the RPGLEINC source member. Identify the stub_op for the web service operation you want to consume. Pay particular attention to the parameters and how they re defined. 26

27 Service program WEATHRSVC was created DSPSRVPGM WEATHRSVC Place the newly created service program into a binding directory 27

28 Start of program, request zip code from user Zip code cannot be *zeros, if so re-display screen Clear data structures Create space in storage to call SOAP web service (stub_create) Consume GetCityForecastByZip operation (stub_op) De-allocate space in storage from web service (stub_destroy) Was the call to the web service successful? Was valid data received? (does Success = 1?) Load and display subfile Display weather.com if requested Return to start How the date is mapped from the web service (xsd_datetime same as xsd_date) 28

29 Program WEATHRSOAP Debugging WEATHRSOAP in RDi 29

30 Need to tell RDi where the source code resides Source code is stored in WEBSERVICE/QRPGLESRC 30

31 Stepping through the code CLLE HOURLYCL that launches web browser Where the real magic happens 31

32 In case you have a very long URL Search for STRPCCMD PCCMD Raising the Bar: A Jumpstart to Using SOAP Web Services in RPG Charles Guarino SOAP SERVICES Charles THANK YOU!!! 32