System i: Programming i5/OS PASE - IBM
System i: Programming i5/OS PASE - IBM
System i: Programming i5/OS PASE - IBM
Create successful ePaper yourself
Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.
|<br />
Contents<br />
<strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> . . . . . . . . . . . . . 1<br />
What’s new for V6R1 . . . . . . . . . . . 1<br />
PDF file for <strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> . . . . . . . . . . 2<br />
<strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> overview . . . . . . . . . . . 3<br />
<strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> concepts . . . . . . . . . . 3<br />
<strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> as a useful option for application<br />
development . . . . . . . . . . . . . 5<br />
Installing <strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> . . . . . . . . . . . 6<br />
Planning for <strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> . . . . . . . . . . 6<br />
Preparing programs to run in <strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> . . . . 8<br />
Analyzing your program’s compatibility with<br />
<strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> . . . . . . . . . . . . . 8<br />
Compiling your AIX source . . . . . . . . 9<br />
Installing AIX compilers on <strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong>. . . 11<br />
Installing the AIX compilers from the<br />
installation media . . . . . . . . . 11<br />
PTF update instructions . . . . . . . 13<br />
Copying the <strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> program to your<br />
system . . . . . . . . . . . . . . . 14<br />
Case sensitivity . . . . . . . . . . . 14<br />
Line-terminating characters in integrated file<br />
system files . . . . . . . . . . . . 15<br />
Transferring files . . . . . . . . . . 16<br />
Customizing <strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> programs to use <strong>i5</strong>/<strong>OS</strong><br />
functions . . . . . . . . . . . . . . 17<br />
Copying header files . . . . . . . . . 17<br />
Copying export files . . . . . . . . . 18<br />
<strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> APIs for accessing <strong>i5</strong>/<strong>OS</strong><br />
functions . . . . . . . . . . . . . 19<br />
Using <strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> programs in the <strong>i5</strong>/<strong>OS</strong><br />
environment . . . . . . . . . . . . . . 19<br />
Running <strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> programs and procedures 19<br />
Running an <strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> program with<br />
QP2SHELL() . . . . . . . . . . . . 20<br />
Running an <strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> program with<br />
QP2TERM() . . . . . . . . . . . . 21<br />
Running an <strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> program from within<br />
<strong>i5</strong>/<strong>OS</strong> programs . . . . . . . . . . . 21<br />
Examples: Running an <strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong><br />
program from within <strong>i5</strong>/<strong>OS</strong> programs . . 21<br />
Calling an <strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> procedure from within<br />
<strong>i5</strong>/<strong>OS</strong> programs . . . . . . . . . . . 23<br />
Example 1: Calling an <strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong><br />
procedure from within <strong>i5</strong>/<strong>OS</strong> programs . . 23<br />
Example 2: An <strong>i5</strong>/<strong>OS</strong> ILE program that<br />
uses pointer arguments in a call to an<br />
<strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> procedure . . . . . . . 24<br />
Using <strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> native methods from Java 29<br />
Working with environment variables . . . . 29<br />
Calling <strong>i5</strong>/<strong>OS</strong> programs and procedures from<br />
your <strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> programs . . . . . . . . 29<br />
Calling ILE procedures . . . . . . . . 30<br />
Examples: Calling ILE procedures . . . . 31<br />
Calling <strong>i5</strong>/<strong>OS</strong> programs from <strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> . . 37<br />
Example: Calling <strong>i5</strong>/<strong>OS</strong> programs from<br />
<strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> . . . . . . . . . . . 38<br />
Running <strong>i5</strong>/<strong>OS</strong> commands from <strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> 39<br />
Example: Running <strong>i5</strong>/<strong>OS</strong> commands from<br />
<strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> . . . . . . . . . . . 40<br />
How <strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> programs interact with <strong>i5</strong>/<strong>OS</strong> 40<br />
Communications . . . . . . . . . . 41<br />
Database . . . . . . . . . . . . . 41<br />
Example: Calling DB2 for <strong>i5</strong>/<strong>OS</strong> CLI<br />
functions in an <strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> program . . . 42<br />
Data encoding . . . . . . . . . . . 48<br />
File systems . . . . . . . . . . . . 49<br />
Globalization . . . . . . . . . . . . 50<br />
Message services . . . . . . . . . . 51<br />
Printing output from <strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> applications 52<br />
Pseudo-terminal (PTY). . . . . . . . . 52<br />
Security . . . . . . . . . . . . . 53<br />
Work management . . . . . . . . . . 55<br />
Debugging your <strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> programs . . . . . 55<br />
Optimizing performance . . . . . . . . . . 56<br />
<strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> shells and utilities . . . . . . . . 56<br />
<strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> commands . . . . . . . . . 57<br />
<strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> system utility . . . . . . . . 65<br />
<strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> qsh, qsh_inout, and qsh_out<br />
commands. . . . . . . . . . . . . . 68<br />
Examples: <strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> . . . . . . . . . . 69<br />
Related information for <strong>i5</strong>/<strong>OS</strong> <strong>PASE</strong> . . . . . . 70<br />
Appendix. Notices . . . . . . . . . . 73<br />
<strong>Programming</strong> interface information . . . . . . 74<br />
Trademarks . . . . . . . . . . . . . . 75<br />
Terms and conditions . . . . . . . . . . . 75<br />
© Copyright <strong>IBM</strong> Corp. 2000, 2008 iii
Change language