Zend Server for IBM i Open Source Toolkit

Transcription

1 Zend Server for IBM i Open Source Toolkit Mike Pavlak Solution Consultant Mike.p@zend.com

2 Agenda Open Source Toolkit Compatibility Wrapper Command processing and *libl Miscellaneous points Q&A 2

3 Zend Server 5.6 for IBM i Key Features Shipping with IBM i 6.1 & 7.1 New Open Source Toolkit ***GA*** Performance enhancements PHP Zend Framework 1.12 & 2.0 Application Deployment PTF Update as well as full package Hotfix 7!!! 3

4 Zend Server Update Open Source Toolkit

5 What is the toolkit? Set of classes that access IBM i native artifacts All Program Objects RPG, COBOL, CL, etc. Others Command processor Data Queue s Spooled File More Access naturally from PHP code. No SP s required Easy to use 5 Insert->Header & Footer

6 Why a new toolkit Open Source is the plan Open Source languages using an Open Source toolkit Makes sense to me Opportunity for community involvement Seeing already 4 contributors, worldwide Created enhancements beyond previous toolkit Access sub-procedures, stateful access, etc No effect on DB2 functions, only the i5 functions are impacted. 6 Insert->Header & Footer

7 But I liked the old one, what are my options? Upgrade customers (PTF update only) Can continue to use Easycom or the new toolkit PTF upgrade process will not remove Easycom Support from Aura, or forum New download customers New Open Source toolkit Easycom no longer ships with Zend Server 5.6 and higher Compatibility Wrapper intercepts i5 function calls (Minor code changes) Passes to new toolkit, transparently 7 Insert->Header & Footer

8 New toolkit FAQ Zend official position and response is in the forums Zend forums are a wonderful source of PHP info Forum PHP on IBM i Zend Server for IBM i New Toolkit Contact Zend with questions. 8 Insert->Header & Footer

9 Notes on installation (PTF update only) Best to update Include_Path in php.ini PTF does not change it, first do no harm Head to Server Setup Directives Paths & Directories Add: :/usr/local/zendsvr/share/toolkitapi Different path from ZSi 5.1- beta 9 Insert->Header & Footer

10 New toolkit is Object Oriented Series of classes that wrap the IBM project All PHP but Object Oriented (wait, there s more!) Zend built the PHP wrapper No OO training required to use them!!! Sam Pinkhasov, Zend 11 Insert->Header & Footer

11 Toolkit Plumbing from 10,000 feet DB2 Functions DB2 Extension or ODBC DRDA DB2 OO Program Calls XML PHP Classes Toolkit API Stored Procedures & Data i5 functions OO Request Compatibility Wrapper XML RPG XMLSERVICE Parm Data HLL s RPG, COBOL System Artifacts 12 Insert->Header & Footer

12 XML Service IBM has open sourced XMLService. First Open Source project on IBM i. (that I know of ) Made up of RPG, CL and DB2 stored procedures (SQL) Tony Cairns, IBM Rochester 13 Insert->Header & Footer

13 XML Service Cross platform Language agnostic Basic plumbing for all open source languages 14 Insert->Header & Footer

14 Compatibility Wrapper Intercepts existing i5 function requests Written in pure PHP Passes them on to OO PHP which then Passes on to XML Service Alan Seiden, SBS & alanseiden.com 15 Insert->Header & Footer

15 Source Code on YiPs for now 16 Insert->Header & Footer

16 PHP Classes Class where all wrapper functions start Yes, this is OO but not too bad Look at it and poke around, It s OK! This is why we need the path set correctly 17 Insert->Header & Footer

17 Housekeeping Need to set the extension and instantiate the object Singleton pattern Try & Catch Can put this in your own include 18 Insert->Header & Footer

18 Now the program call Set parameters based on function Call program Output results 19 Insert->Header & Footer I / O L e n g t h C o m m e n t V a r n a m e I n i t v a l

19 AddParameterChar Located in ToolkitService.php /usr/local/zendsvr/share/toolkitapi Uses CharParam which extends ProgramParam, etc 20 Insert->Header & Footer

20 Before and after Part 1 Existing code call 21 Insert->Header & Footer

21 Before and after Part 2 New Open Source Toolkit program call 22 Insert->Header & Footer

22 Additional Parameter Types AddParameterInt32($io, $comment, $varname, $value, $dimension) AddParameterInt64($io, $comment, $varname, $value, $dimension) AddParameterUInt32($io, $comment, $varname, $value, $dimension) AddParameterUInt64($io, $comment, $varname, $value, $dimension) AddParameterFloat ($io, $comment, $varname, $value, $dimension) AddParameterReal($io, $comment, $varname, $value, $dimension) AddParameterPackdec($io, $length, $scale, $comment, $varname, $value, $dimension) AddParameterZoned($io, $length, $scale, $comment, $varname, $value, $dimension) AddParameterBin($io, $size, $comment, $varname, $value, $dimension) AddDataStruct($array, $parameters, $name= struct_name, $dim, $by, $isarray, $labellen) 23 Insert->Header & Footer

23 Zend Server Update Compatibility Wrapper

24 Why the compatibility wrapper? In the past 6 years many folks have invested in i5 functions Yes, legacy PHP on IBM i New toolkit is OOP but i5 functions support procedural code Smooth the transition from Easycom to Open Source toolkit Currently in beta 25 Insert->Header & Footer

25 Minor change to existing PHP script Require the class 26 Insert->Header & Footer

26 Zend Server Update Command processing & *libl

27 Several ways to call commands $conn->clcommand( my command ); $conn->clinteractivecommand( DSP command ); $conn->clcommandwithoutput( RTV command );

28 Other uses for the toolkit Command processing Call CL command directly from toolkit Retrieve response from command call Example DSPLIBL CHGLIBL DSPLIBL Useful for managing access to resource Files & Programs from RPG 29 Insert->Header & Footer

29 30 Insert->Header & Footer

30 PHP Code 31 Insert->Header & Footer

31 32 Insert->Header & Footer

32 Zend Server Update Miscellaneous Toolkit Points

33 What was passed? Toolkit.ini setting Debug = TRUE Turns on DebugOutput file debuglogfile = "/usr/local/zendsvr/share/toolkitapi/debug.log Many other directive settings here 34 Insert->Header & Footer

34 Contents of output 35 Insert->Header & Footer

35 Stateful processing IPC Use session ID, for example $PHPToolkitObj->setToolkitServiceParams ( array ('InternalKey' => "/tmp/$user" ) ); 36 Insert->Header & Footer

36 Zend Server Update Wrap it up

37 Time permitting Local development demo

38 Q&A Please fill out your Session Evaluation! 39 Insert->Header & Footer