RPG & DB2 Stored Procedures with PHP - Schedschd.ws/hosted_files/commons17/77/Stored Procedures3.0.pdfRPG & DB2 Stored Procedures with PHP ... •Advantages? –Static objects –Indexing,

1© 2017 Rogue Wave Software, Inc. All Rights Reserved. 1

RPG & DB2 Stored Procedures with PHP


PHPish Sessions

• Workshop – Make your IBM i Sizzle with Wordpress (Alan)A4AA – 12:30 PM

• Connecting the dots: Building Web Apps w/PHP, HTML & CSS (John)13BH – 10:45 AM

• PHP on IBM i: Getting Started (Mike)14BI – 12:45 PM

• OO and Ahh! Understanding Object Oriented PHP (John)16BI –3:45 PM

• Open Lab: Basic PHP to access your Data on IBM i, Object Oriented PHP (John)21AB – 8:00 AM to Noon

• Introduction to Maria DB for IBM i (Mike)21BJ – 8:00 AM

• PHP and DB2 Essentials (Alan)25BJ – 2:00 PM

• PHP Tricks for the RPG Programmer (Alan & Birgita)25CA – 2:00 PM

• Building Reusable APIs (Stephanie)27BJ – 5:00 PM

• Watson and PHP Inventory Integration (Mike & Clark)32CL – 9:30 AM

• Intro to Python33CL – 11:00 AM

• Using DB2 and SQL with Open Source Languages (Alan & Scott)35CL – 2:00 PM

• IBM i and PHP System Integration (Jim O)35BH – 2:00 PM

• Debugging your web application from A to Zend (Stephanie)41BI – 8:00 AM

• A Real Zend Expressive Application (Clark)42BH – 9:30 AM

• Bring RPG/COBOL Business Logic to the web with PHP Toolkit (Alan)42BI – 9:30 AM

• Object Oriented Business Programming :An intro to DDD (Chuk)46AD – 3:30 PM

• RPG and DB2 Stored procedures with PHP on IBM i (Mike)46BJ – 3:30 PM

• Object Oriented Business Programming :An intro to DDD (Chuk)46CP – 3:30 PM

• Case Study jQuery and PHP – Drag & Drop Scheduling for BPCS (John)46BH – 3:30 PM

• Getting Started with PHP Frameworks (Stephanie)47BH – 5:00 PM


Agenda

• DB2

– SQL Stored procedures

– Examples

• RPG

– Hello World from RPG (sp1)

– Pass an array from RPG to PHP (sp2)

– Pass a record set from RPG to PHP (sp3)

• Q&A


Introduction to SPs


Stored Procedures…What are they?

• Database artifacts that perform a specific task.

• Zend Server PHP on IBM i supports access to multiple DB’s

– DB2

– MySQL

– MS SQL Server

– Oracle

– Mongo DB (Zend Server 5.6)

• Therefore, SP’s on each are available to PHP on IBM i


Stored Procedures on IBM i…What are they?

• Operating System Objects but Database attributes

• Typically written in SQL or RPG, but…

• Can be written in nearly any HLL like

– Java, REXX, C, CL, C++, COBOL, FORTRAN, PL1


What do they look like?

Simple SP data retrieval:

CREATE PROCEDURE sales_price(

IN Customer# CHAR(8),

IN Product# CHAR(8),

OUT price DECIMAL(12,2))

LANGUAGE SQL

BEGIN

SELECT CustPrice FROM priceTable

WHERE CUSTNO=Customer# AND

PRODNO=Product# AND

active = ‘Y’

END


Open Source Toolkit has examples


Command line procedure creation

From PASE:

QSH CMD(‘/usr/bin/db2 -t -f

/QSYS.LIB/MPAVLAK.lib/QSQLSRC.FILE/MPSQL1.MBR')

Or…

From Native Command Line

RUNSQLSTM

SRCFILE(MPAVLAK/QSQLSRC) SRCMBR(MPSQL1)


IBM i Navigator


DB2 Housekeeping

• Supports 2 types

– External (RPG, COBOL, etc.)

– SQL

• Implemented via C programs (transparently)

• Enhancements with each release of IBM i

– Be Careful if developing for multiple OS versions

• SQL details:

– Supports multiple statements

– Supports iterative processing (Loop, Repeat Until, While)

– Get Diagnostics and feedback (SQLSTATE, SQLCODE)

– Can return discrete results or result sets


Example


Before…


Output


After


Looks the same!


And now a word about library lists


Option parameter of DB2_Connect

• Options parameter is an array.

• Supports three kinds if library list

– i5_lib – Single library

– i5_naming – Enable library list via user profile

– i5_libl – Specify library list in PHP

• Supports many other parameters


Single library approach

• Similar to the world of MySQL/MariaDB.


Multiple libraries hardcoded in PHP

• More like real life


Job Description – PHPUSER2

• WRKJOBD, DSPJOBD


Multiple libraries via User Profile

• Parallels Green Screen access


Back to SPs


Observations about SPs

• Advantages?

– Static objects

– Indexing, permanent objects

– Manage queries, DBA role is emerging

– Ever heard of little Bobby Tables?

• Disadvantages

– Another thing to manage


Security is no laughing matter?


Understand which Exec to use

• DB2_Exec

– Fire and forget

– Use when no parameters necessary

• DB2_Execute

– Prepared SQL via DB2_Prepare & DB2 bind

– Always use when using parameters

– Example in Samples


Hello World


Start slow

• Don’t try to boil the ocean with your first SP!

• How did you learn RPG?

– Reports

– Batch

– Interactive

– Subfiles, etc…

• Start with simple SP’s and grow..


An approach

• Process:

– Create RPG

– Identify parameter interface

– Create procedure

– Test in Database Navigator

– Try it in PHP

– Increase complexity a little

– Repeat!


RPG


Create the procedure & test

CREATE PROCEDURE MPAVLAK/RPGSP1(INOUT Response CHAR ( 32)) LANGUAGE RPGLE

NOT DETERMINISTIC CONTAINS SQL EXTERNAL NAME MPAVLAK/RPGSP1 PARAMETER STYLE GENERAL

Then fire up System i Navigator


Admire results in DB Nav


Now try it in PHP


Results from Script


Array from RPG to PHP


Now an array

• Data elements are nice, but…

• Sometimes you need a little more…

• How about an array of information?


SQL to create the SP & test in iNav

CREATE PROCEDURE mpavlak/rpgsp2() LANGUAGE RPGLE

EXTERNAL NAME mpavlak/rpgsp2 GENERAL


Open results in PHP


Results in browser


Record set from RPG


Have RPG build the result set and use SQL…


SQL to create the SP & test in iNav

CREATE PROCEDURE mpavlak/rpgsp3() LANGUAGE RPGLE

EXTERNAL NAME mpavlak/rpgsp3 GENERAL


Now open results in PHP


Now open results in browser


Wrap it up…


Q&A

• Mike Pavlak – [email protected]

mailto:[email protected]


ATTENDConnect with experts.Become an authority.Register now:zendcon.com/register-now

EXPLOREShare, inspire, educate.Network

SPONSORSpotlight your best in enterprise PHP, opensource & frameworks:[email protected]

Visit zendcon.com


Documents

RPG & DB2 Stored Procedures with PHP - Schedschd.ws/hosted_files/commons17/77/Stored Procedures3.0.pdfRPG & DB2 Stored Procedures with PHP ... •Advantages? –Static objects –Indexing,