SlideShare a Scribd company logo
1 of 70
Download to read offline
alanseiden.com
Alan Seiden Consulting
PHP Batch Jobs on IBM i
PHP Batch Jobs on IBM iAlan Seiden Consulting
Alan’s PHP on IBM i focus
• Consultant to innovative IBM i and PHP users
• PHP project leader, Zend/IBM Toolkit
• Contributor, Zend Framework DB2 enhancements
• Award-winning developer
• Authority, web performance on IBM i
2
PHP Batch Jobs on IBM iAlan Seiden Consulting
Founder, Club Seiden
3
club.alanseiden.com
PHP Batch Jobs on IBM iAlan Seiden Consulting
Contact information
Alan Seiden
alan@alanseiden.com
201-447-2437
alanseiden.com
twitter: @alanseiden
4
PHP Batch Jobs on IBM iAlan Seiden Consulting
Where to download these slides
From my site
http://alanseiden.com/presentations
On SlideShare
http://slideshare.net/aseiden
The latest version will be available on both sites
5
PHP Batch Jobs on IBM iAlan Seiden Consulting
What we’ll discuss today
• Quick overview, Zend Server for IBM i

• PHP for Batch (non-web) Tasks on IBM i
• “batch” = command line or scheduled PHP
• PHP as a utility language

• Running web tasks in the background for better
perceived speed

• Tips and techniques





6
PHP Batch Jobs on IBM iAlan Seiden Consulting
PHP/web
7
PHP Batch Jobs on IBM iAlan Seiden Consulting
PHP was built for server-side web apps
•Started as a web development language in 1995

•Over time, the open source community and Zend
made PHP more and more powerful

•Currently one of the most popular web languages
§ It’s everywhere, eBay, Wikipedia, Facebook…
§ But it’s not limited to the web
§ It would be a shame to restrain PHP’s power to only the web
•On IBM i, PHP’s power is available in Zend Server
8
PHP Batch Jobs on IBM iAlan Seiden Consulting
Zend Server
9
PHP Batch Jobs on IBM iAlan Seiden Consulting
Zend Server for IBM i
• Download Zend Server 8.x
• http://www.zend.com/en/products/server/downloads-ibmi
• Easy upgrade from 6.x













• Editions
• Basic (free), Professional, Enterprise
• http://www.zend.com/en/products/server/editions
• Same download, different license
10
PHP Batch Jobs on IBM iAlan Seiden Consulting
Zend Server and PHP resources
• Support: Zend Server “Basic” includes one year of email support.
Upgrade for more years and fast phone support
§ Register at http://www.zend.com/en/products/server/downloads-ibmi
and also get Zend’s IBM i newsletter

• Web:
§ Zend’s recorded webinars: http://www.zend.com/resources/webinars/i5-os
§ Zend Forums: forums.zend.com (look for IBM i Zend Server forums)
§ http://alanseiden.com (of course!)
• Blog, articles
• Books (online and print)
§ PHP Manual: http://php.net
§ PHP on IBM i book by Jeff Olen & Kevin Schroeder (MC Press)
§ New Advanced PHP on IBM i book by Kevin Schroeder
• Training from Zend
11
PHP Batch Jobs on IBM iAlan Seiden Consulting
PHP beyond the
web
12
PHP Batch Jobs on IBM iAlan Seiden Consulting
I first used “batch PHP” on an EDI project
•Generate an XML-based price list and FTP it to
customer each week at the same time
•Poll for and receive XML orders arriving on IFS
§ Process the XML, generate a new XML acknowledgement,
and then FTP a response
•Send e-mail reports to administrators
13
PHP Batch Jobs on IBM iAlan Seiden Consulting
Why use PHP for non-web tasks?
•PHP easily handles:
§ IFS stream files
§ manipulation of any string data and common formats such
as XML and JSON
§ communication with other processes through TCP/IP,
whether on your network or on the internet

•Leverage your PHP skills instead of learning yet
another language
§ And have another opportunity to improve your PHP skills!

•Share functions between web and non-web

14
PHP Batch Jobs on IBM iAlan Seiden Consulting
More possibilities with PHP on i
•Download, upload, process files from web and
FTP servers

•Send e-mails with great flexibility
•Create graphics

•Read and write from your regular db2 files
•Schedule these tasks to occur when you want
15
PHP Batch Jobs on IBM iAlan Seiden Consulting
Three methods to do this
•Method #1: “PHP-CLI” (command line)
§ Included in Zend Server Basic (no charge)
§ Test on command line, embed in CL/RPG
§ Need knowledge of PASE or QSHELL environment
§ Accepts simple string parameters only
§ Delay of a few seconds for PHP-CLI to load
•Method #2: Zend Server’s Job Queue
§ Included in Zend Server Professional/Enterprise Editions
§ Web based, more flexibility, dynamic scheduling
§ Accepts varied parms, multi-dimensional arrays, objects
§ Faster loading
16
PHP Batch Jobs on IBM iAlan Seiden Consulting
Three methods to do this
•Method #3: SQL HTTP Web services
§ RPG calls PHP using DB2 HTTP and XML capabilities
§ PHP acts as a web service under the Apache web server,
like a normal PHP web script
§ Can return data to RPG via an XML string
§ Covered in my talk, “PHP Tricks for RPG Programmers”
17
PHP Batch Jobs on IBM iAlan Seiden Consulting


Method #1: 

PHP-CLI
18
PHP Batch Jobs on IBM iAlan Seiden Consulting
CLI = Command LIne
l PHP-CLI runs PHP when not in a web server
l http://docs.php.net/manual/en/features.commandline.php
l Location in Zend Server: /usr/local/zendsvr6/bin/php-cli

l Optimized for the command line
l No web server variables or HTTP headers
l Get parameters from $argv array
• Not web server $_GET and $_POST arrays
19
PHP Batch Jobs on IBM iAlan Seiden Consulting
Tips for PHP-CLI
l To ensure success
l Navigate to PHP’s “bin” directory where php-cli is located
l cd /usr/local/zendsvr/bin [5.x]
l cd /usr/local/zendsvr6/bin [6.x-8.x]
l The two paths above are used interchangeably in this
presentation. Use the correct one for your version
l Specify php-cli explicitly; “php” will not work in all version
20
PHP Batch Jobs on IBM iAlan Seiden Consulting
Techie note
l PHP-CLI difference on IBM i vs. other systems
l On IBM i, php-cli is a shell script that sets up paths for PHP
l On Linux, Windows, et al., php-cli is an actual executable file
21
PHP Batch Jobs on IBM iAlan Seiden Consulting
PHP-CLI doesn’t need a web server
• Apache web server does not have to be running
• Scripts needn’t be in a web-accessible location
§ In fact, for security, you should put them anywhere BUT the web
server root, unless you also want the scripts to be run in a
browser.

§ That means don’t put them in /www/zendsvr/htdocs

§ Prefer a location such as /php/appname/myscript.php
• Note: no “www” in the path. Not accessible to the web
• Choose a convention so you’ll be able to find the scripts
• Assign *RX permissions for chosen user
• Example: CHGAUT OBJ('/php/appname/') USER(MYUSER)
DTAAUT(*RX) SUBTREE(*ALL)
22
PHP Batch Jobs on IBM iAlan Seiden Consulting
PHP-CLI provides sanity checks
• Independence from the web server makes it a good
tool to check health of PHP installation
• php-cli –v outputs PHP version information
• php-cli –i outputs the equivalent of phpinfo()
§ Shows what extensions and options you have loaded. An excerpt:
IBM DB2, Cloudscape and Apache Derby support => enabled
Module release => 1.8.1 

§ Tip: filter results by piping to “grep”
• php-cli -i | grep ssl outputs only ssl info
• php-cli -i | grep db2 outputs only db2 info
• Use php-cli –h to see all options
23
PHP Batch Jobs on IBM iAlan Seiden Consulting
Do a simple version check: php-cli -v
24
PHP Batch Jobs on IBM iAlan Seiden Consulting
PHP-CLI Runs via PASE or QSHELL
• Two environments
§ PASE (Portable Application System Environment): AIX-like environment
on the IBM i
§ QSHELL: a scripting environment
• I prefer PASE for calling php-cli
§ PASE lets you pass parameters separately
§ Qshell requires a single concatenated command string
§ But you’ll see Qshell in articles, or may have a need for it
• I compared PASE and QSHELL in this article:
§ http://www.mcpressonline.com/tips-techniques/programming/
techtip-qshell-vs-pase.html
25
PHP Batch Jobs on IBM iAlan Seiden Consulting


PASE Primer
26
PHP Batch Jobs on IBM iAlan Seiden Consulting
Calling applications in PASE
•If an app runs in AIX it will probably run in PASE

•Invoke with QP2TERM and QP2SHELL
•Interactively with QP2TERM (“TERM” = “terminal”)
• Two steps: start QP2TERM, then run application
• CALL QP2TERM
• /usr/local/zendsvr6/bin/php-cli '/php/sendinvoice.php'
fred@example.com Fred 'Y'
•From CL or to launch application in one step
• CALL QP2SHELL PARM('/usr/local/zendsvr6/bin/php-cli'
'/php/sendinvoice.php' &EMAIL &NAME 'Y')
• Don’t confuse these with QSHELL environment
27
PHP Batch Jobs on IBM iAlan Seiden Consulting
Non-PHP example of QP2SHELL
CALL PGM(QP2SHELL) PARM('/mypath/C42PDF' '–o'
'invoice.pdf' '–l' + 'tifflist.txt')
•Example of calling an AIX binary in PASE
•C42PDF binary combines “TYPE IV TIFF” images into
a multi-page PDF file
•Compiled binary at http://c42pdf.ffii.org
•Works well on IBM i
28
PHP Batch Jobs on IBM iAlan Seiden Consulting


Qshell Primer
29
PHP Batch Jobs on IBM iAlan Seiden Consulting
Qshell is another UNIX-like environment
•Run commands on its command line or launch
Qshell environment from CL, etc.
•Allows complex shell script utilities
•For our purposes, use it similarly to PASE,
except you’ll have to concatenate commands
into a single string
30
PHP Batch Jobs on IBM iAlan Seiden Consulting
Using Qshell
•Invoke with QSH and QSH CMD()
§ Interactively
• QSH by itself

§ From CL or to launch application in one step
• QSH CMD('MYCOMMAND')
• Launches a command or application of your choice
•Note: QSH is equivalent to STRQSH
31
PHP Batch Jobs on IBM iAlan Seiden Consulting


Try PHP-CLI
32
PHP Batch Jobs on IBM iAlan Seiden Consulting
Start PASE session with QP2TERM
33
PHP Batch Jobs on IBM iAlan Seiden Consulting
Do a simple version check: php-cli -v
34
PHP Batch Jobs on IBM iAlan Seiden Consulting
Try a ‘hello world’ test
<?php
// if run from browser, output to browser
// if run from command line, output there
echo ‘Hello, world!’
?>
35
PHP Batch Jobs on IBM iAlan Seiden Consulting
Run “Hello World” script
36
PHP Batch Jobs on IBM iAlan Seiden Consulting
Output the results to an IFS file
Type this into QP2TERM (note ‘redirection’ symbol):
Produces a file that I can view in Notepad:
37
PHP Batch Jobs on IBM iAlan Seiden Consulting
Email with PHP
<?php
// emailme.php
// establish "from" user (optional)
ini_set("sendmail_from","sender@example.org");
// Parameters: recipient, subject, body
mail("alan@alanseiden.com",
"Sent from CL",
"CL can call PHP scripts.");
?>
38
PHP Batch Jobs on IBM iAlan Seiden Consulting
Call the email script from a CL program
Now call your CL
39
PHP Batch Jobs on IBM iAlan Seiden Consulting
I received the message
40
PHP Batch Jobs on IBM iAlan Seiden Consulting
How to automate it?
• Add a job schedule entry (ADDJOBSCDE) for your
CL program
• (In the UNIX world they call this a “CRON job.”)
• ADDJOBSCDE JOB(SNDPRICES) SCDDATE(*NONE) 

CMD(CALL PGM(MYLIB/PRICEPGM)) 

SCDDAY(*FRI) SCDTIME(‘23:00’) 

FRQ(*WEEKLY) RCYACN(*NOSBM) 

JOBD(MYLIB/PRICEJOBD)
41
PHP Batch Jobs on IBM iAlan Seiden Consulting
Read parameters
in PHP
42
PHP Batch Jobs on IBM iAlan Seiden Consulting
Command-line arguments
• When we use PHP in a website, we receive
parameters using the $_GET and $_POST arrays

• How do we get parameters/arguments when PHP is
called from the command line or a CL?

43
PHP Batch Jobs on IBM iAlan Seiden Consulting
Two special variables
• $argv: array of arguments
§ $argv[0] is always the PHP script name itself, e.g. helloworld.php
§ $argv[1], $argv[2], and so on are the actual arguments

• $argc: count (how many) of arguments
• Use it to check that you’ve received what you expected
44
PHP Batch Jobs on IBM iAlan Seiden Consulting
Args.php gets params with $argc and $argv
<?php
// args.php
// remember, [0] is the script itself.
echo "n"; // blank line
// check argument count
if ($argc > 0) {
echo $argc . " argument(s) received, including the script name itself.
nn";
foreach ($argv as $num=>$val) {
echo "arg $num: $valn";
}
} else {
echo "We should have had at least one argument: the script name
itself.";
}
// usage: /usr/local/zendsvr6/bin/php-cli /batchphp/args.php firstarg
secondarg
45
PHP Batch Jobs on IBM iAlan Seiden Consulting
Run args.php in QP2TERM (PASE)
• cd /usr/local/zendsvr6/bin
• php-cli /batchphp/args.php
1 argument(s) received, including the script name
itself.
arg 0: /batchphp/args.php
$

• php-cli /batchphp/args.php hello ″I like PHP″
3 argument(s) received, including the script name
itself.
arg 0: /batchphp/args.php
arg 1: hello
arg 2: I like PHP
$
46
PHP Batch Jobs on IBM iAlan Seiden Consulting
CL that passes parameters to PHP
/* PHPPARAMS CL */
PGM PARM(&FIRST &SECOND)
DCL VAR(&FIRST) TYPE(*CHAR) LEN(25)
DCL VAR(&SECOND) TYPE(*CHAR) LEN(25)
DCL VAR(&NULL) TYPE(*CHAR) LEN(1) VALUE(X'00')
/* Terminate variables with null for safety */
CHGVAR VAR(&FIRST) VALUE(&FIRST *TCAT &NULL)
CHGVAR VAR(&SECOND) VALUE(&SECOND *TCAT &NULL)
/* Call PHP with command line arguments */
CALL PGM(QP2SHELL) +
PARM('/USR/LOCAL/ZENDSVR6/BIN/PHP-CLI' +
'/BATCHPHP/ARGS.PHP' +
&FIRST &SECOND)
ENDPGM
47
PHP Batch Jobs on IBM iAlan Seiden Consulting
Call that CL with parameters
Just like a normal CL program
CALL PHPPARAMS PARM('param1' 'param2')
48
PHP Batch Jobs on IBM iAlan Seiden Consulting
Examples
49
PHP Batch Jobs on IBM iAlan Seiden Consulting
Examples of batch tasks
• Generate and email Excel spreadsheets or HTML-
formatted emails

• Access web services
• Create PDF files with dynamic text and graphics
• Manipulate IFS stream files
50
PHP Batch Jobs on IBM iAlan Seiden Consulting
Excel spreadsheets: plain or formatted
51
PHP Batch Jobs on IBM iAlan Seiden Consulting
How to generate spreadsheets
• Simple CSV spreadsheet
§ Note: change curly quotes to straight quotes in your code
function getCsv() {
// commas to separate. n for new line
$csvStr = “firstname,lastnamenJoe,SmithnAndi,Gutmans”;
return $csvStr;
}
$csvStr = getCsv();
// save it in an IFS file
$ret = file_put_contents(‘/dir/names.csv’, $csvStr);
• True Excel file with formatting
§ http://phpexcel.net (.xslx, .pdf...)
§ These free packages allow complex

styling, nonscrolling headers, lots more
52
PHP Batch Jobs on IBM iAlan Seiden Consulting
Generate and send HTML email
53
PHP Batch Jobs on IBM iAlan Seiden Consulting
Sending authenticated HTML mail
require_once 'Zend/Mail.php';
require_once 'Zend/Mail/Transport/Smtp.php';
$mail = new Zend_Mail_Transport_Smtp(‘mail.myhost.com’,array('auth' => 'login',
'username' => ‘myuser’,'password' => ‘mypass’));
Zend_Mail::setDefaultTransport($mail);
$mail = new Zend_Mail();
$mail->setFrom($mailFrom, $mailFromName);
$mailBody = ‘<HTML><b>Alert</b>: hot tea at buffet</HTML>’;
// add addresses
foreach ($custEmails as $custEmail) {
$mail->addTo(trim($custEmail['email']), trim($custEmail['name']));
} //(foreach ($custEmails as $custEmail) )
$mail->AddTo(‘alan@alanseiden.com’, ‘Alan Seiden’);
$mail->setSubject(“Alert of vital importance”;
$mail->setBodyHTML($mailBody);
// attach CSV file
$csvStr = getCsv(); // string
$attachment = $mail->createAttachment($csvStr, 'application/csv‘);
$attachment->filename = ‘names.csv';
$mail->send();
54
PHP Batch Jobs on IBM iAlan Seiden Consulting
Generate a PDF from text provided
<?php
// Zend_Pdf docs: http://files.zend.com/help/Zend-Framework/zend.pdf.drawing.html
require_once 'Zend/Pdf.php';
// **** Get user-supplied text
$textToShow = $argv[1]; // assume argument is present
// Create new PDF
$pdf = new Zend_Pdf();
// Add new page to the document
$page = $pdf->newPage(Zend_Pdf_Page::SIZE_A4);
$pdf->pages[] = $page;
// Set font
$page->setFont(Zend_Pdf_Font::fontWithName(Zend_Pdf_Font::FONT_HELVETICA), 40);
// Draw text
$page->drawText($textToShow, 100, 510);
$this->_helper->layout()->disableLayout();
$this->_helper->viewRenderer->setNoRender();
// plus I create an ellipse shape (code not shown here…see zend documentation,
above, for how to do that)
$pdf->save('/alan/pdffromtext.pdf'); // now save to a file on IFS
55
PHP Batch Jobs on IBM iAlan Seiden Consulting
Run PDF generator
/usr/local/zendsvr6/bin/php-cli /batchphp/
pdffromtext.php "Look, ma! I'm in a PDF!"
56
PHP Batch Jobs on IBM iAlan Seiden Consulting
Result
57
PHP Batch Jobs on IBM iAlan Seiden Consulting


Method #2: 

PHP Job Queue
58
PHP Batch Jobs on IBM iAlan Seiden Consulting
Job Queue is part of Zend Server
•Requires at least Professional Edition
•Web-based
•More flexible than the CL technique
•Easily launched from within PHP
•Runs long-running tasks asynchronously
59
PHP Batch Jobs on IBM iAlan Seiden Consulting
Job Queue allows you to...
•Move tasks into a separate execution queue
§ Off-load to new process, later time, or different server
•Execute certain tasks at a specified time
§ Schedule, optionally repeat at intervals
•Use complex parameters
•Control from PHP or via Zend Server GUI

•Launch faster than PHP-CLI
60
PHP Batch Jobs on IBM iAlan Seiden Consulting
Creating Jobs
•Create jobs with createHttpJob() method
•Pass parameters
§ Simple: via query string $_GET
§ Complex: as an associative array of key => value pairs
•Set job options
§ Name, priority, schedule, etc.
§ Create deferred or recurring jobs
•Launch from PHP scripts or use the Zend Server UI
$queue = new ZendJobQueue(); 

$queue->createHttpJob('http://myIbmi.local/jobs/somejob.php');
61
PHP Batch Jobs on IBM iAlan Seiden Consulting
More about Zend Job Queue
Specs: http://files.zend.com/help/Zend-Server/jobqueue-global-api.html
Tutorial: http://files.zend.com/help/Zend-Server/working_with_jobs.htm
API signature for createHttpJob:
int ZendJobQueue::createHttpJob (
string $url,
array $vars,
mixed $options)
Example with nested array variables:
$queue = new ZendJobQueue();
$queue->createHttpJob(
‘http://yourIBMi.com/send_alert.php’,
array(‘from’=> ‘alan@alanseiden.com’,
‘to’=>array(‘someone@example.com’,
‘another@example.com’)),
array(‘persistent’=>false) );
62
PHP Batch Jobs on IBM iAlan Seiden Consulting
Job Queue Management
View job status
and manage
execution
63
PHP Batch Jobs on IBM iAlan Seiden Consulting
Other Job Capabilities
l Set priority and dependencies
l Get job output from PHP
l Check job status and queue statistics
l Passing custom HTTP headers
l Management of jobs
l Handling failures and controlling retries
l Suspend/resume recurring jobs
l Code tracing, monitor
64
PHP Batch Jobs on IBM iAlan Seiden Consulting
Job Queue Timeout Tip
l If task will run for a long time, increase the Job
Queue and FastCGI request timeouts
l /usr/local/zendsvr6/etc/jqd.ini
l Default: zend_jobqueue.http_job_timeout = 120

l /www/zendsvr6/conf/fastcgi.conf
l Default: RequestTimeout="60"
• Otherwise you’ll get HTTP 408 errors and
unpredictable results in the Job Queue GUI
65
PHP Batch Jobs on IBM iAlan Seiden Consulting
Creative use of Zend Job Queue
l Imagine a web app where user’s navigation path is
predictable
l User signs in, is redirected to a welcome page, then clicks to see
a data-rich dashboard
l Dashboard contains several slow, user-specific queries

l Question: How can job queue enable faster loading
of the dashboard?
l Answer: run queries as soon as user logs in,
asynchronously, using job queue
l When user gets to dashboard, gather the pre-fetched data
66
PHP Batch Jobs on IBM iAlan Seiden Consulting
More examples online
l https://github.com/clarkphp/Code-Examples/tree/
master/ZendServerJobQueue
l Examples from Zend’s Clark Everetts
67
PHP Batch Jobs on IBM iAlan Seiden Consulting


Other ideas
68
PHP Batch Jobs on IBM iAlan Seiden Consulting
Other ways to use batch PHP
l Web services to synchronize data
l Call from interactive RPG (better would be my “PHP Tricks for
RPG Programmers” technique)
l OR schedule for nighttime
l Use Zend Framework’s “livedocx” service to merge
data with .doc templates/overlays to create MS
Word .docx files
69
PHP Batch Jobs on IBM iAlan Seiden Consulting
Contact and tips
Alan Seiden
Alan Seiden Consulting
Ho-Ho-Kus, NJ
70
alan@alanseiden.com ● 201-447-2437 ● twitter: @alanseiden
Free newsletter: 

http://alanseiden.com/tips

More Related Content

What's hot

What's hot (20)

Web Performance First Aid
Web Performance First AidWeb Performance First Aid
Web Performance First Aid
 
Install MariaDB on IBM i - Tips, troubleshooting, and more
Install MariaDB on IBM i - Tips, troubleshooting, and moreInstall MariaDB on IBM i - Tips, troubleshooting, and more
Install MariaDB on IBM i - Tips, troubleshooting, and more
 
PHP Installed on IBM i - the Nickel Tour
PHP Installed on IBM i - the Nickel TourPHP Installed on IBM i - the Nickel Tour
PHP Installed on IBM i - the Nickel Tour
 
Getting started with PHP on IBM i
Getting started with PHP on IBM iGetting started with PHP on IBM i
Getting started with PHP on IBM i
 
Performance tuning with zend framework
Performance tuning with zend frameworkPerformance tuning with zend framework
Performance tuning with zend framework
 
Fundamentals of performance tuning PHP on IBM i
Fundamentals of performance tuning PHP on IBM i  Fundamentals of performance tuning PHP on IBM i
Fundamentals of performance tuning PHP on IBM i
 
Zend Products and PHP for IBMi
Zend Products and PHP for IBMi  Zend Products and PHP for IBMi
Zend Products and PHP for IBMi
 
PHP on IBM i Tutorial
PHP on IBM i TutorialPHP on IBM i Tutorial
PHP on IBM i Tutorial
 
Running open source PHP applications on you IBM i
Running open source PHP applications on you IBM iRunning open source PHP applications on you IBM i
Running open source PHP applications on you IBM i
 
PHP on Windows - What's New
PHP on Windows - What's NewPHP on Windows - What's New
PHP on Windows - What's New
 
Zend Core on IBM i - Security Considerations
Zend Core on IBM i - Security ConsiderationsZend Core on IBM i - Security Considerations
Zend Core on IBM i - Security Considerations
 
Zend_Tool: Practical use and Extending
Zend_Tool: Practical use and ExtendingZend_Tool: Practical use and Extending
Zend_Tool: Practical use and Extending
 
Getting Started with SQL Server Compact Edition 3.51
Getting Started with SQL Server Compact Edition 3.51Getting Started with SQL Server Compact Edition 3.51
Getting Started with SQL Server Compact Edition 3.51
 
PHP and Platform Independance in the Cloud
PHP and Platform Independance in the CloudPHP and Platform Independance in the Cloud
PHP and Platform Independance in the Cloud
 
What's new with Zend server
What's new with Zend serverWhat's new with Zend server
What's new with Zend server
 
Zend con 2016 bdd with behat for beginners
Zend con 2016   bdd with behat for beginnersZend con 2016   bdd with behat for beginners
Zend con 2016 bdd with behat for beginners
 
Performance tuning PHP on IBMi
Performance tuning PHP on IBMiPerformance tuning PHP on IBMi
Performance tuning PHP on IBMi
 
Keeping up with PHP
Keeping up with PHPKeeping up with PHP
Keeping up with PHP
 
Require js training
Require js trainingRequire js training
Require js training
 
Introduction to column oriented databases in PHP
Introduction to column oriented databases in PHPIntroduction to column oriented databases in PHP
Introduction to column oriented databases in PHP
 

Similar to PHP Batch Jobs on IBM i

Dutch php conference_2010_opm
Dutch php conference_2010_opmDutch php conference_2010_opm
Dutch php conference_2010_opm
isnull
 
Stress Free Deployment - Confoo 2011
Stress Free Deployment  - Confoo 2011Stress Free Deployment  - Confoo 2011
Stress Free Deployment - Confoo 2011
Bachkoutou Toutou
 
Introduction into PHP5 (Jeroen van Sluijs)
Introduction into PHP5 (Jeroen van Sluijs)Introduction into PHP5 (Jeroen van Sluijs)
Introduction into PHP5 (Jeroen van Sluijs)
Stefan Koopmanschap
 

Similar to PHP Batch Jobs on IBM i (20)

Ria Applications And PHP
Ria Applications And PHPRia Applications And PHP
Ria Applications And PHP
 
Dutch php conference_2010_opm
Dutch php conference_2010_opmDutch php conference_2010_opm
Dutch php conference_2010_opm
 
They why behind php frameworks
They why behind php frameworksThey why behind php frameworks
They why behind php frameworks
 
Zend Framwork configurations
Zend Framwork configurationsZend Framwork configurations
Zend Framwork configurations
 
Php on Windows
Php on WindowsPhp on Windows
Php on Windows
 
Zend Framwork presentation
Zend Framwork presentationZend Framwork presentation
Zend Framwork presentation
 
Debugging with Zend Studio for Eclipse
Debugging with Zend Studio for EclipseDebugging with Zend Studio for Eclipse
Debugging with Zend Studio for Eclipse
 
Integrating PHP With System-i using Web Services
Integrating PHP With System-i using Web ServicesIntegrating PHP With System-i using Web Services
Integrating PHP With System-i using Web Services
 
Lamp Zend Security
Lamp Zend SecurityLamp Zend Security
Lamp Zend Security
 
wamp.ppt
wamp.pptwamp.ppt
wamp.ppt
 
Why Docker? Dayton PHP, April 2017
Why Docker? Dayton PHP, April 2017Why Docker? Dayton PHP, April 2017
Why Docker? Dayton PHP, April 2017
 
Stress Free Deployment - Confoo 2011
Stress Free Deployment  - Confoo 2011Stress Free Deployment  - Confoo 2011
Stress Free Deployment - Confoo 2011
 
Zend Code in ZF 2.0
Zend Code in ZF 2.0Zend Code in ZF 2.0
Zend Code in ZF 2.0
 
Mark Wall - F5 Agility 2017 - F5 Automation The Journey - PPT
Mark Wall - F5 Agility 2017 - F5 Automation The Journey - PPTMark Wall - F5 Agility 2017 - F5 Automation The Journey - PPT
Mark Wall - F5 Agility 2017 - F5 Automation The Journey - PPT
 
F5 Automation - The Journey
F5 Automation - The JourneyF5 Automation - The Journey
F5 Automation - The Journey
 
A Tale of Two Toolkits
A Tale of Two ToolkitsA Tale of Two Toolkits
A Tale of Two Toolkits
 
Continuous Integration at Mollie
Continuous Integration at MollieContinuous Integration at Mollie
Continuous Integration at Mollie
 
Zend Server - OSI Days
Zend Server - OSI DaysZend Server - OSI Days
Zend Server - OSI Days
 
Introduction into PHP5 (Jeroen van Sluijs)
Introduction into PHP5 (Jeroen van Sluijs)Introduction into PHP5 (Jeroen van Sluijs)
Introduction into PHP5 (Jeroen van Sluijs)
 
PHP as a Service TDC2019
PHP as a Service TDC2019PHP as a Service TDC2019
PHP as a Service TDC2019
 

Recently uploaded

Breaking Down the Flutterwave Scandal What You Need to Know.pdf
Breaking Down the Flutterwave Scandal What You Need to Know.pdfBreaking Down the Flutterwave Scandal What You Need to Know.pdf
Breaking Down the Flutterwave Scandal What You Need to Know.pdf
UK Journal
 
Easier, Faster, and More Powerful – Alles Neu macht der Mai -Wir durchleuchte...
Easier, Faster, and More Powerful – Alles Neu macht der Mai -Wir durchleuchte...Easier, Faster, and More Powerful – Alles Neu macht der Mai -Wir durchleuchte...
Easier, Faster, and More Powerful – Alles Neu macht der Mai -Wir durchleuchte...
panagenda
 

Recently uploaded (20)

1111 ChatGPT Prompts PDF Free Download - Prompts for ChatGPT
1111 ChatGPT Prompts PDF Free Download - Prompts for ChatGPT1111 ChatGPT Prompts PDF Free Download - Prompts for ChatGPT
1111 ChatGPT Prompts PDF Free Download - Prompts for ChatGPT
 
Easier, Faster, and More Powerful – Notes Document Properties Reimagined
Easier, Faster, and More Powerful – Notes Document Properties ReimaginedEasier, Faster, and More Powerful – Notes Document Properties Reimagined
Easier, Faster, and More Powerful – Notes Document Properties Reimagined
 
IESVE for Early Stage Design and Planning
IESVE for Early Stage Design and PlanningIESVE for Early Stage Design and Planning
IESVE for Early Stage Design and Planning
 
BT & Neo4j _ How Knowledge Graphs help BT deliver Digital Transformation.pptx
BT & Neo4j _ How Knowledge Graphs help BT deliver Digital Transformation.pptxBT & Neo4j _ How Knowledge Graphs help BT deliver Digital Transformation.pptx
BT & Neo4j _ How Knowledge Graphs help BT deliver Digital Transformation.pptx
 
Microsoft CSP Briefing Pre-Engagement - Questionnaire
Microsoft CSP Briefing Pre-Engagement - QuestionnaireMicrosoft CSP Briefing Pre-Engagement - Questionnaire
Microsoft CSP Briefing Pre-Engagement - Questionnaire
 
Extensible Python: Robustness through Addition - PyCon 2024
Extensible Python: Robustness through Addition - PyCon 2024Extensible Python: Robustness through Addition - PyCon 2024
Extensible Python: Robustness through Addition - PyCon 2024
 
Behind the Scenes From the Manager's Chair: Decoding the Secrets of Successfu...
Behind the Scenes From the Manager's Chair: Decoding the Secrets of Successfu...Behind the Scenes From the Manager's Chair: Decoding the Secrets of Successfu...
Behind the Scenes From the Manager's Chair: Decoding the Secrets of Successfu...
 
ERP Contender Series: Acumatica vs. Sage Intacct
ERP Contender Series: Acumatica vs. Sage IntacctERP Contender Series: Acumatica vs. Sage Intacct
ERP Contender Series: Acumatica vs. Sage Intacct
 
TEST BANK For, Information Technology Project Management 9th Edition Kathy Sc...
TEST BANK For, Information Technology Project Management 9th Edition Kathy Sc...TEST BANK For, Information Technology Project Management 9th Edition Kathy Sc...
TEST BANK For, Information Technology Project Management 9th Edition Kathy Sc...
 
FDO for Camera, Sensor and Networking Device – Commercial Solutions from VinC...
FDO for Camera, Sensor and Networking Device – Commercial Solutions from VinC...FDO for Camera, Sensor and Networking Device – Commercial Solutions from VinC...
FDO for Camera, Sensor and Networking Device – Commercial Solutions from VinC...
 
WSO2CONMay2024OpenSourceConferenceDebrief.pptx
WSO2CONMay2024OpenSourceConferenceDebrief.pptxWSO2CONMay2024OpenSourceConferenceDebrief.pptx
WSO2CONMay2024OpenSourceConferenceDebrief.pptx
 
Where to Learn More About FDO _ Richard at FIDO Alliance.pdf
Where to Learn More About FDO _ Richard at FIDO Alliance.pdfWhere to Learn More About FDO _ Richard at FIDO Alliance.pdf
Where to Learn More About FDO _ Richard at FIDO Alliance.pdf
 
Intro in Product Management - Коротко про професію продакт менеджера
Intro in Product Management - Коротко про професію продакт менеджераIntro in Product Management - Коротко про професію продакт менеджера
Intro in Product Management - Коротко про професію продакт менеджера
 
Breaking Down the Flutterwave Scandal What You Need to Know.pdf
Breaking Down the Flutterwave Scandal What You Need to Know.pdfBreaking Down the Flutterwave Scandal What You Need to Know.pdf
Breaking Down the Flutterwave Scandal What You Need to Know.pdf
 
AI presentation and introduction - Retrieval Augmented Generation RAG 101
AI presentation and introduction - Retrieval Augmented Generation RAG 101AI presentation and introduction - Retrieval Augmented Generation RAG 101
AI presentation and introduction - Retrieval Augmented Generation RAG 101
 
How we scaled to 80K users by doing nothing!.pdf
How we scaled to 80K users by doing nothing!.pdfHow we scaled to 80K users by doing nothing!.pdf
How we scaled to 80K users by doing nothing!.pdf
 
ECS 2024 Teams Premium - Pretty Secure
ECS 2024   Teams Premium - Pretty SecureECS 2024   Teams Premium - Pretty Secure
ECS 2024 Teams Premium - Pretty Secure
 
Long journey of Ruby Standard library at RubyKaigi 2024
Long journey of Ruby Standard library at RubyKaigi 2024Long journey of Ruby Standard library at RubyKaigi 2024
Long journey of Ruby Standard library at RubyKaigi 2024
 
Easier, Faster, and More Powerful – Alles Neu macht der Mai -Wir durchleuchte...
Easier, Faster, and More Powerful – Alles Neu macht der Mai -Wir durchleuchte...Easier, Faster, and More Powerful – Alles Neu macht der Mai -Wir durchleuchte...
Easier, Faster, and More Powerful – Alles Neu macht der Mai -Wir durchleuchte...
 
What's New in Teams Calling, Meetings and Devices April 2024
What's New in Teams Calling, Meetings and Devices April 2024What's New in Teams Calling, Meetings and Devices April 2024
What's New in Teams Calling, Meetings and Devices April 2024
 

PHP Batch Jobs on IBM i

  • 2. PHP Batch Jobs on IBM iAlan Seiden Consulting Alan’s PHP on IBM i focus • Consultant to innovative IBM i and PHP users • PHP project leader, Zend/IBM Toolkit • Contributor, Zend Framework DB2 enhancements • Award-winning developer • Authority, web performance on IBM i 2
  • 3. PHP Batch Jobs on IBM iAlan Seiden Consulting Founder, Club Seiden 3 club.alanseiden.com
  • 4. PHP Batch Jobs on IBM iAlan Seiden Consulting Contact information Alan Seiden alan@alanseiden.com 201-447-2437 alanseiden.com twitter: @alanseiden 4
  • 5. PHP Batch Jobs on IBM iAlan Seiden Consulting Where to download these slides From my site http://alanseiden.com/presentations On SlideShare http://slideshare.net/aseiden The latest version will be available on both sites 5
  • 6. PHP Batch Jobs on IBM iAlan Seiden Consulting What we’ll discuss today • Quick overview, Zend Server for IBM i
 • PHP for Batch (non-web) Tasks on IBM i • “batch” = command line or scheduled PHP • PHP as a utility language
 • Running web tasks in the background for better perceived speed
 • Tips and techniques
 
 
 6
  • 7. PHP Batch Jobs on IBM iAlan Seiden Consulting PHP/web 7
  • 8. PHP Batch Jobs on IBM iAlan Seiden Consulting PHP was built for server-side web apps •Started as a web development language in 1995
 •Over time, the open source community and Zend made PHP more and more powerful
 •Currently one of the most popular web languages § It’s everywhere, eBay, Wikipedia, Facebook… § But it’s not limited to the web § It would be a shame to restrain PHP’s power to only the web •On IBM i, PHP’s power is available in Zend Server 8
  • 9. PHP Batch Jobs on IBM iAlan Seiden Consulting Zend Server 9
  • 10. PHP Batch Jobs on IBM iAlan Seiden Consulting Zend Server for IBM i • Download Zend Server 8.x • http://www.zend.com/en/products/server/downloads-ibmi • Easy upgrade from 6.x
 
 
 
 
 
 
 • Editions • Basic (free), Professional, Enterprise • http://www.zend.com/en/products/server/editions • Same download, different license 10
  • 11. PHP Batch Jobs on IBM iAlan Seiden Consulting Zend Server and PHP resources • Support: Zend Server “Basic” includes one year of email support. Upgrade for more years and fast phone support § Register at http://www.zend.com/en/products/server/downloads-ibmi and also get Zend’s IBM i newsletter
 • Web: § Zend’s recorded webinars: http://www.zend.com/resources/webinars/i5-os § Zend Forums: forums.zend.com (look for IBM i Zend Server forums) § http://alanseiden.com (of course!) • Blog, articles • Books (online and print) § PHP Manual: http://php.net § PHP on IBM i book by Jeff Olen & Kevin Schroeder (MC Press) § New Advanced PHP on IBM i book by Kevin Schroeder • Training from Zend 11
  • 12. PHP Batch Jobs on IBM iAlan Seiden Consulting PHP beyond the web 12
  • 13. PHP Batch Jobs on IBM iAlan Seiden Consulting I first used “batch PHP” on an EDI project •Generate an XML-based price list and FTP it to customer each week at the same time •Poll for and receive XML orders arriving on IFS § Process the XML, generate a new XML acknowledgement, and then FTP a response •Send e-mail reports to administrators 13
  • 14. PHP Batch Jobs on IBM iAlan Seiden Consulting Why use PHP for non-web tasks? •PHP easily handles: § IFS stream files § manipulation of any string data and common formats such as XML and JSON § communication with other processes through TCP/IP, whether on your network or on the internet
 •Leverage your PHP skills instead of learning yet another language § And have another opportunity to improve your PHP skills!
 •Share functions between web and non-web
 14
  • 15. PHP Batch Jobs on IBM iAlan Seiden Consulting More possibilities with PHP on i •Download, upload, process files from web and FTP servers
 •Send e-mails with great flexibility •Create graphics
 •Read and write from your regular db2 files •Schedule these tasks to occur when you want 15
  • 16. PHP Batch Jobs on IBM iAlan Seiden Consulting Three methods to do this •Method #1: “PHP-CLI” (command line) § Included in Zend Server Basic (no charge) § Test on command line, embed in CL/RPG § Need knowledge of PASE or QSHELL environment § Accepts simple string parameters only § Delay of a few seconds for PHP-CLI to load •Method #2: Zend Server’s Job Queue § Included in Zend Server Professional/Enterprise Editions § Web based, more flexibility, dynamic scheduling § Accepts varied parms, multi-dimensional arrays, objects § Faster loading 16
  • 17. PHP Batch Jobs on IBM iAlan Seiden Consulting Three methods to do this •Method #3: SQL HTTP Web services § RPG calls PHP using DB2 HTTP and XML capabilities § PHP acts as a web service under the Apache web server, like a normal PHP web script § Can return data to RPG via an XML string § Covered in my talk, “PHP Tricks for RPG Programmers” 17
  • 18. PHP Batch Jobs on IBM iAlan Seiden Consulting 
 Method #1: 
 PHP-CLI 18
  • 19. PHP Batch Jobs on IBM iAlan Seiden Consulting CLI = Command LIne l PHP-CLI runs PHP when not in a web server l http://docs.php.net/manual/en/features.commandline.php l Location in Zend Server: /usr/local/zendsvr6/bin/php-cli
 l Optimized for the command line l No web server variables or HTTP headers l Get parameters from $argv array • Not web server $_GET and $_POST arrays 19
  • 20. PHP Batch Jobs on IBM iAlan Seiden Consulting Tips for PHP-CLI l To ensure success l Navigate to PHP’s “bin” directory where php-cli is located l cd /usr/local/zendsvr/bin [5.x] l cd /usr/local/zendsvr6/bin [6.x-8.x] l The two paths above are used interchangeably in this presentation. Use the correct one for your version l Specify php-cli explicitly; “php” will not work in all version 20
  • 21. PHP Batch Jobs on IBM iAlan Seiden Consulting Techie note l PHP-CLI difference on IBM i vs. other systems l On IBM i, php-cli is a shell script that sets up paths for PHP l On Linux, Windows, et al., php-cli is an actual executable file 21
  • 22. PHP Batch Jobs on IBM iAlan Seiden Consulting PHP-CLI doesn’t need a web server • Apache web server does not have to be running • Scripts needn’t be in a web-accessible location § In fact, for security, you should put them anywhere BUT the web server root, unless you also want the scripts to be run in a browser.
 § That means don’t put them in /www/zendsvr/htdocs
 § Prefer a location such as /php/appname/myscript.php • Note: no “www” in the path. Not accessible to the web • Choose a convention so you’ll be able to find the scripts • Assign *RX permissions for chosen user • Example: CHGAUT OBJ('/php/appname/') USER(MYUSER) DTAAUT(*RX) SUBTREE(*ALL) 22
  • 23. PHP Batch Jobs on IBM iAlan Seiden Consulting PHP-CLI provides sanity checks • Independence from the web server makes it a good tool to check health of PHP installation • php-cli –v outputs PHP version information • php-cli –i outputs the equivalent of phpinfo() § Shows what extensions and options you have loaded. An excerpt: IBM DB2, Cloudscape and Apache Derby support => enabled Module release => 1.8.1 
 § Tip: filter results by piping to “grep” • php-cli -i | grep ssl outputs only ssl info • php-cli -i | grep db2 outputs only db2 info • Use php-cli –h to see all options 23
  • 24. PHP Batch Jobs on IBM iAlan Seiden Consulting Do a simple version check: php-cli -v 24
  • 25. PHP Batch Jobs on IBM iAlan Seiden Consulting PHP-CLI Runs via PASE or QSHELL • Two environments § PASE (Portable Application System Environment): AIX-like environment on the IBM i § QSHELL: a scripting environment • I prefer PASE for calling php-cli § PASE lets you pass parameters separately § Qshell requires a single concatenated command string § But you’ll see Qshell in articles, or may have a need for it • I compared PASE and QSHELL in this article: § http://www.mcpressonline.com/tips-techniques/programming/ techtip-qshell-vs-pase.html 25
  • 26. PHP Batch Jobs on IBM iAlan Seiden Consulting 
 PASE Primer 26
  • 27. PHP Batch Jobs on IBM iAlan Seiden Consulting Calling applications in PASE •If an app runs in AIX it will probably run in PASE
 •Invoke with QP2TERM and QP2SHELL •Interactively with QP2TERM (“TERM” = “terminal”) • Two steps: start QP2TERM, then run application • CALL QP2TERM • /usr/local/zendsvr6/bin/php-cli '/php/sendinvoice.php' fred@example.com Fred 'Y' •From CL or to launch application in one step • CALL QP2SHELL PARM('/usr/local/zendsvr6/bin/php-cli' '/php/sendinvoice.php' &EMAIL &NAME 'Y') • Don’t confuse these with QSHELL environment 27
  • 28. PHP Batch Jobs on IBM iAlan Seiden Consulting Non-PHP example of QP2SHELL CALL PGM(QP2SHELL) PARM('/mypath/C42PDF' '–o' 'invoice.pdf' '–l' + 'tifflist.txt') •Example of calling an AIX binary in PASE •C42PDF binary combines “TYPE IV TIFF” images into a multi-page PDF file •Compiled binary at http://c42pdf.ffii.org •Works well on IBM i 28
  • 29. PHP Batch Jobs on IBM iAlan Seiden Consulting 
 Qshell Primer 29
  • 30. PHP Batch Jobs on IBM iAlan Seiden Consulting Qshell is another UNIX-like environment •Run commands on its command line or launch Qshell environment from CL, etc. •Allows complex shell script utilities •For our purposes, use it similarly to PASE, except you’ll have to concatenate commands into a single string 30
  • 31. PHP Batch Jobs on IBM iAlan Seiden Consulting Using Qshell •Invoke with QSH and QSH CMD() § Interactively • QSH by itself
 § From CL or to launch application in one step • QSH CMD('MYCOMMAND') • Launches a command or application of your choice •Note: QSH is equivalent to STRQSH 31
  • 32. PHP Batch Jobs on IBM iAlan Seiden Consulting 
 Try PHP-CLI 32
  • 33. PHP Batch Jobs on IBM iAlan Seiden Consulting Start PASE session with QP2TERM 33
  • 34. PHP Batch Jobs on IBM iAlan Seiden Consulting Do a simple version check: php-cli -v 34
  • 35. PHP Batch Jobs on IBM iAlan Seiden Consulting Try a ‘hello world’ test <?php // if run from browser, output to browser // if run from command line, output there echo ‘Hello, world!’ ?> 35
  • 36. PHP Batch Jobs on IBM iAlan Seiden Consulting Run “Hello World” script 36
  • 37. PHP Batch Jobs on IBM iAlan Seiden Consulting Output the results to an IFS file Type this into QP2TERM (note ‘redirection’ symbol): Produces a file that I can view in Notepad: 37
  • 38. PHP Batch Jobs on IBM iAlan Seiden Consulting Email with PHP <?php // emailme.php // establish "from" user (optional) ini_set("sendmail_from","sender@example.org"); // Parameters: recipient, subject, body mail("alan@alanseiden.com", "Sent from CL", "CL can call PHP scripts."); ?> 38
  • 39. PHP Batch Jobs on IBM iAlan Seiden Consulting Call the email script from a CL program Now call your CL 39
  • 40. PHP Batch Jobs on IBM iAlan Seiden Consulting I received the message 40
  • 41. PHP Batch Jobs on IBM iAlan Seiden Consulting How to automate it? • Add a job schedule entry (ADDJOBSCDE) for your CL program • (In the UNIX world they call this a “CRON job.”) • ADDJOBSCDE JOB(SNDPRICES) SCDDATE(*NONE) 
 CMD(CALL PGM(MYLIB/PRICEPGM)) 
 SCDDAY(*FRI) SCDTIME(‘23:00’) 
 FRQ(*WEEKLY) RCYACN(*NOSBM) 
 JOBD(MYLIB/PRICEJOBD) 41
  • 42. PHP Batch Jobs on IBM iAlan Seiden Consulting Read parameters in PHP 42
  • 43. PHP Batch Jobs on IBM iAlan Seiden Consulting Command-line arguments • When we use PHP in a website, we receive parameters using the $_GET and $_POST arrays
 • How do we get parameters/arguments when PHP is called from the command line or a CL?
 43
  • 44. PHP Batch Jobs on IBM iAlan Seiden Consulting Two special variables • $argv: array of arguments § $argv[0] is always the PHP script name itself, e.g. helloworld.php § $argv[1], $argv[2], and so on are the actual arguments
 • $argc: count (how many) of arguments • Use it to check that you’ve received what you expected 44
  • 45. PHP Batch Jobs on IBM iAlan Seiden Consulting Args.php gets params with $argc and $argv <?php // args.php // remember, [0] is the script itself. echo "n"; // blank line // check argument count if ($argc > 0) { echo $argc . " argument(s) received, including the script name itself. nn"; foreach ($argv as $num=>$val) { echo "arg $num: $valn"; } } else { echo "We should have had at least one argument: the script name itself."; } // usage: /usr/local/zendsvr6/bin/php-cli /batchphp/args.php firstarg secondarg 45
  • 46. PHP Batch Jobs on IBM iAlan Seiden Consulting Run args.php in QP2TERM (PASE) • cd /usr/local/zendsvr6/bin • php-cli /batchphp/args.php 1 argument(s) received, including the script name itself. arg 0: /batchphp/args.php $
 • php-cli /batchphp/args.php hello ″I like PHP″ 3 argument(s) received, including the script name itself. arg 0: /batchphp/args.php arg 1: hello arg 2: I like PHP $ 46
  • 47. PHP Batch Jobs on IBM iAlan Seiden Consulting CL that passes parameters to PHP /* PHPPARAMS CL */ PGM PARM(&FIRST &SECOND) DCL VAR(&FIRST) TYPE(*CHAR) LEN(25) DCL VAR(&SECOND) TYPE(*CHAR) LEN(25) DCL VAR(&NULL) TYPE(*CHAR) LEN(1) VALUE(X'00') /* Terminate variables with null for safety */ CHGVAR VAR(&FIRST) VALUE(&FIRST *TCAT &NULL) CHGVAR VAR(&SECOND) VALUE(&SECOND *TCAT &NULL) /* Call PHP with command line arguments */ CALL PGM(QP2SHELL) + PARM('/USR/LOCAL/ZENDSVR6/BIN/PHP-CLI' + '/BATCHPHP/ARGS.PHP' + &FIRST &SECOND) ENDPGM 47
  • 48. PHP Batch Jobs on IBM iAlan Seiden Consulting Call that CL with parameters Just like a normal CL program CALL PHPPARAMS PARM('param1' 'param2') 48
  • 49. PHP Batch Jobs on IBM iAlan Seiden Consulting Examples 49
  • 50. PHP Batch Jobs on IBM iAlan Seiden Consulting Examples of batch tasks • Generate and email Excel spreadsheets or HTML- formatted emails
 • Access web services • Create PDF files with dynamic text and graphics • Manipulate IFS stream files 50
  • 51. PHP Batch Jobs on IBM iAlan Seiden Consulting Excel spreadsheets: plain or formatted 51
  • 52. PHP Batch Jobs on IBM iAlan Seiden Consulting How to generate spreadsheets • Simple CSV spreadsheet § Note: change curly quotes to straight quotes in your code function getCsv() { // commas to separate. n for new line $csvStr = “firstname,lastnamenJoe,SmithnAndi,Gutmans”; return $csvStr; } $csvStr = getCsv(); // save it in an IFS file $ret = file_put_contents(‘/dir/names.csv’, $csvStr); • True Excel file with formatting § http://phpexcel.net (.xslx, .pdf...) § These free packages allow complex
 styling, nonscrolling headers, lots more 52
  • 53. PHP Batch Jobs on IBM iAlan Seiden Consulting Generate and send HTML email 53
  • 54. PHP Batch Jobs on IBM iAlan Seiden Consulting Sending authenticated HTML mail require_once 'Zend/Mail.php'; require_once 'Zend/Mail/Transport/Smtp.php'; $mail = new Zend_Mail_Transport_Smtp(‘mail.myhost.com’,array('auth' => 'login', 'username' => ‘myuser’,'password' => ‘mypass’)); Zend_Mail::setDefaultTransport($mail); $mail = new Zend_Mail(); $mail->setFrom($mailFrom, $mailFromName); $mailBody = ‘<HTML><b>Alert</b>: hot tea at buffet</HTML>’; // add addresses foreach ($custEmails as $custEmail) { $mail->addTo(trim($custEmail['email']), trim($custEmail['name'])); } //(foreach ($custEmails as $custEmail) ) $mail->AddTo(‘alan@alanseiden.com’, ‘Alan Seiden’); $mail->setSubject(“Alert of vital importance”; $mail->setBodyHTML($mailBody); // attach CSV file $csvStr = getCsv(); // string $attachment = $mail->createAttachment($csvStr, 'application/csv‘); $attachment->filename = ‘names.csv'; $mail->send(); 54
  • 55. PHP Batch Jobs on IBM iAlan Seiden Consulting Generate a PDF from text provided <?php // Zend_Pdf docs: http://files.zend.com/help/Zend-Framework/zend.pdf.drawing.html require_once 'Zend/Pdf.php'; // **** Get user-supplied text $textToShow = $argv[1]; // assume argument is present // Create new PDF $pdf = new Zend_Pdf(); // Add new page to the document $page = $pdf->newPage(Zend_Pdf_Page::SIZE_A4); $pdf->pages[] = $page; // Set font $page->setFont(Zend_Pdf_Font::fontWithName(Zend_Pdf_Font::FONT_HELVETICA), 40); // Draw text $page->drawText($textToShow, 100, 510); $this->_helper->layout()->disableLayout(); $this->_helper->viewRenderer->setNoRender(); // plus I create an ellipse shape (code not shown here…see zend documentation, above, for how to do that) $pdf->save('/alan/pdffromtext.pdf'); // now save to a file on IFS 55
  • 56. PHP Batch Jobs on IBM iAlan Seiden Consulting Run PDF generator /usr/local/zendsvr6/bin/php-cli /batchphp/ pdffromtext.php "Look, ma! I'm in a PDF!" 56
  • 57. PHP Batch Jobs on IBM iAlan Seiden Consulting Result 57
  • 58. PHP Batch Jobs on IBM iAlan Seiden Consulting 
 Method #2: 
 PHP Job Queue 58
  • 59. PHP Batch Jobs on IBM iAlan Seiden Consulting Job Queue is part of Zend Server •Requires at least Professional Edition •Web-based •More flexible than the CL technique •Easily launched from within PHP •Runs long-running tasks asynchronously 59
  • 60. PHP Batch Jobs on IBM iAlan Seiden Consulting Job Queue allows you to... •Move tasks into a separate execution queue § Off-load to new process, later time, or different server •Execute certain tasks at a specified time § Schedule, optionally repeat at intervals •Use complex parameters •Control from PHP or via Zend Server GUI
 •Launch faster than PHP-CLI 60
  • 61. PHP Batch Jobs on IBM iAlan Seiden Consulting Creating Jobs •Create jobs with createHttpJob() method •Pass parameters § Simple: via query string $_GET § Complex: as an associative array of key => value pairs •Set job options § Name, priority, schedule, etc. § Create deferred or recurring jobs •Launch from PHP scripts or use the Zend Server UI $queue = new ZendJobQueue(); 
 $queue->createHttpJob('http://myIbmi.local/jobs/somejob.php'); 61
  • 62. PHP Batch Jobs on IBM iAlan Seiden Consulting More about Zend Job Queue Specs: http://files.zend.com/help/Zend-Server/jobqueue-global-api.html Tutorial: http://files.zend.com/help/Zend-Server/working_with_jobs.htm API signature for createHttpJob: int ZendJobQueue::createHttpJob ( string $url, array $vars, mixed $options) Example with nested array variables: $queue = new ZendJobQueue(); $queue->createHttpJob( ‘http://yourIBMi.com/send_alert.php’, array(‘from’=> ‘alan@alanseiden.com’, ‘to’=>array(‘someone@example.com’, ‘another@example.com’)), array(‘persistent’=>false) ); 62
  • 63. PHP Batch Jobs on IBM iAlan Seiden Consulting Job Queue Management View job status and manage execution 63
  • 64. PHP Batch Jobs on IBM iAlan Seiden Consulting Other Job Capabilities l Set priority and dependencies l Get job output from PHP l Check job status and queue statistics l Passing custom HTTP headers l Management of jobs l Handling failures and controlling retries l Suspend/resume recurring jobs l Code tracing, monitor 64
  • 65. PHP Batch Jobs on IBM iAlan Seiden Consulting Job Queue Timeout Tip l If task will run for a long time, increase the Job Queue and FastCGI request timeouts l /usr/local/zendsvr6/etc/jqd.ini l Default: zend_jobqueue.http_job_timeout = 120
 l /www/zendsvr6/conf/fastcgi.conf l Default: RequestTimeout="60" • Otherwise you’ll get HTTP 408 errors and unpredictable results in the Job Queue GUI 65
  • 66. PHP Batch Jobs on IBM iAlan Seiden Consulting Creative use of Zend Job Queue l Imagine a web app where user’s navigation path is predictable l User signs in, is redirected to a welcome page, then clicks to see a data-rich dashboard l Dashboard contains several slow, user-specific queries
 l Question: How can job queue enable faster loading of the dashboard? l Answer: run queries as soon as user logs in, asynchronously, using job queue l When user gets to dashboard, gather the pre-fetched data 66
  • 67. PHP Batch Jobs on IBM iAlan Seiden Consulting More examples online l https://github.com/clarkphp/Code-Examples/tree/ master/ZendServerJobQueue l Examples from Zend’s Clark Everetts 67
  • 68. PHP Batch Jobs on IBM iAlan Seiden Consulting 
 Other ideas 68
  • 69. PHP Batch Jobs on IBM iAlan Seiden Consulting Other ways to use batch PHP l Web services to synchronize data l Call from interactive RPG (better would be my “PHP Tricks for RPG Programmers” technique) l OR schedule for nighttime l Use Zend Framework’s “livedocx” service to merge data with .doc templates/overlays to create MS Word .docx files 69
  • 70. PHP Batch Jobs on IBM iAlan Seiden Consulting Contact and tips Alan Seiden Alan Seiden Consulting Ho-Ho-Kus, NJ 70 alan@alanseiden.com ● 201-447-2437 ● twitter: @alanseiden Free newsletter: 
 http://alanseiden.com/tips

Editor's Notes

  1. To retrieve vars from the called script: $params = ZendJobQueue::getCurrentJobParams(); $from = $params[‘from&apos;]); // etc.