Using XMLSERVICE with.net

Transcription

1 Using XMLSERVICE with.net Communicating with IBM i from.net Presented by : Richard Schoen President/Chief Technical Officer RJS Software Systems richard@rjssoftware.com

2 What Is XMLSERVICE? XMLSERVICE is a single library of Open Source RPG code that enables XML scripting calls of System i resources using most any language available on your platform. XMLSERVICE RPG server library does not require other language products to run on your IBM i, however language teams often provide a client toolkit to greatly simplify XML calls to XMLSERVICE. Language vendors often provide compiled XMLSERVICE distributed with product installations (Zend Server, PowerRuby). Richard has developed a.net wrapper API for XMLSERVICE

3 Why Use XMLSERVICE? Building multi-platform apps that need to access IBM i data Building mobile apps that need access to IBM i data Don t want to deploy IBM Client Access and drivers - Windows Don t want to deploy JT400 Windows, Linux, Mac, Android Most dev environments can pass and receive XML via HTTP calls Think of XMLSERVICE as a universal communicator

4 XMLSERVICE is FREE XML Service is completely free/safe commercial use download (Yips) BSD license, download, keep any source copy forever (safe) XML Service written in RPG open source (you can change it) Techniques used IBM i calls are stable, unlikely to change (ever) XML Service is supported Open Source XML Service fix/add improvement goal is never impact current customers

5 XML Service - XML everything XML input <> XML output Any device Any language Any local/remote connection Any IBM i service (PGM, CMD, System API, DB2, PASE)

6 XML Service - IBM i Native Access through XML Access Native IBM i Objects from any language using XML Local or remote IBM i: IBM i local, IBM i-2-ibm i, Linux/Unix/Windows-2-IBM, etc. Any language access: PHP, Ruby, Java, Perl, RPG,.Net or no language at all (HTML/XML)

7 XML Service - IBM i Native Access through XML Many Native Object Types: DB2 SQL and Native, Program call, Procedure call, Data Area, Data Queue, Message Queue, Commands, System values, Spool files, PASE utilities Local or remote call interfaces to XMLSERVICE (included RPG download) Primary: call DB2 stored procedures local or remote (iplug4k - iplug15m) Secondary: call REST HTTP local or remote (xmlcgi.pgm) Richard has only tested CL and DB2 calls so far You can test other calls or wait for me to do it

8 Moving Parts Many Native Object Types: DB2 SQL and Native, Program call, Procedure call, Data Area, Data Queue, Message Queue, Commands, System values, Spool files, PASE utilities Local or remote call interfaces to XMLSERVICE (included RPG download)

9 Moving Parts Any language Browser HTML/XML Script PHP, Ruby, Java, JavaScript, etc. Compiled RPG, C, etc..net Any local/remote connection Linux/Unix/Windows/Mac ibm_db2/odbc/rest to IBM i Native IBM i ibm_db2/odbc/rest to IBM i

10 XMLSERVICE Set Up Restore XMLSERVICE library. Contains source only. Need to build Run CRTXMLV5 CL program to build XMLSERVICE objects Create XMLSERVICE Apache instance Configure XMLSERVICE Apache Instance STRTCPSVR SERVER(*HTTP) HTTPSVR(XMLSERVICE) Test using RJS XMLSERVICE.Net wrapper Note: If you were to use this over the web, SSL would be a good idea.

11 IBM i Apache Server Basic Config Listen *:30000 DocumentRoot /www/xmlservice/htdocs #Apache rest configuration (CGI interface) #Example: Add the following to /www/zendsvr/conf/httpd.conf ScriptAlias /cgi-bin/ /QSYS.LIB/XMLSERVICE.LIB/ <Directory /QSYS.LIB/XMLSERVICE.LIB/> AllowOverride None order allow,deny allow from all SetHandler cgi-script Options +ExecCGI </Directory> #Optional for server side includes (very handy for pure html/xml sites): # server side includes Options +ExecCGI +Includes AddType text/html.shtml AddOutputFilter INCLUDES.shtml AddOutputFilter INCLUDES.html

12 .Net Wrapper Calls Using XMLSERVICE via CGI Compose XML command or query string in code Post string to Apache Server URL to call XMLSERVICE via CGI Retrieve XML response Decide what to do with the response data Query decompose XML to a dataset so it can be consumed CL Command decompose XML and scan for errors. Use RJS XMLSERVICE.Net wrapper to simplify

13 CL Command XML Example The following XML string runs the selected CL command db2=*local&uid=user&pwd=password&ipc=/rjsxmlservice&ctl=*sb mjob&xmlin=<?xml version='1.0'?> <?xml-stylesheet type='text/xsl' href='/demoxslt.xsl'?> <script> <cmd>sndmsg MSG('TEST XMLSERVICE') TOUSR(QSYSOPR)</cmd> </script>&xmlout=32768"

14 SQL Query XML Example The following XML string runs the selected SQL query db2=*local&uid=user&pwd=password&ipc=/rjsxmlservice&ctl=*sb mjob&xmlin=<?xml version='1.0'?> <?xml-stylesheet type='text/xsl' href='/demoxslt.xsl'?> <script> <sql> <options options='noauto' autocommit='off'/> </sql> <sql> <connect conn='myconn' options='noauto'/> </sql> <sql> <prepare conn='myconn'>select * from qiws/qcustcdt</prepare> </sql> <sql> <execute/> </sql> <sql> <describe desc='col'/> </sql> <sql> <fetch block='all' desc='on'/> </sql> <sql> <free/> </sql> </script>&xmlout=500000

15 .Net Application Code Demo Functions we will review CL command call DB2 query to.net DataSet/DataTable Other functions to be defined in.net wrapper at a future date..

16 Wrap-Up / What s Next? Saw an overview on how to install XMLSERVICE Learned a bit about how XMLSERVICE works Saw the CL command and SQL query functionality in action Code for this XMLSERVICE.Net example will be placed on CodePlex Just like XMLSERVICE the code is free, but unsupported me if you want the Codeplex link: richard@rjssoftware.com Start communicating with your IBM i using XMLSERVICE and.net Enhance what I ve done and contribute changes