PASE for i

IBM i
Version 7.3
Programming
IBM PASE for i
IBM

IBM i
Version 7.3
Programming
IBM PASE for i
IBM

Note
Before using this information and the product it supports, read the information in “Notices” on page 69.
This edition applies to IBM i 7.3 (product number 5770-SS1) and to all subsequent releases and modifications until
otherwise indicated in new editions. This version does not run on all reduced instruction set computer (RISC)
models nor does it run on CISC models.
This document may contain references to Licensed Internal Code. Licensed Internal Code is Machine Code and is
licensed to you under the terms of the IBM License Agreement for Machine Code.
© Copyright IBM Corporation 2000, 2013.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.

Contents
IBM PASE for i ............ 1
What's new for IBM i 7.3 .......... 1
PDF file for IBM PASE for i ......... 1
IBM PASE for i overview .......... 2
IBM PASE for i concepts ......... 2
IBM PASE for i as a useful option for application
development ............. 4
Installing IBM PASE for i .......... 5
Planning for IBM PASE for i ......... 5
Preparing programs to run in IBM PASE for i ... 7
Analyzing program compatibility with IBM PASE
for i ................ 7
Compiling your AIX source ........ 8
Installing AIX compilers on IBM i ..... 10
Installing the AIX compilers from the
installation media ......... 10
PTF update instructions ....... 11
Copying the IBM PASE for i program to your
system ............... 12
Case sensitivity ........... 12
Line-terminating characters in integrated file
system files ............ 13
Transferring files .......... 14
Customizing IBM PASE for i programs to use
IBM i functions ............ 15
Copying header files ......... 15
Copying export files ......... 16
IBM PASE for i APIs for accessing IBM i
functions ............. 17
Using IBM PASE for i programs in the IBM i
environment .............. 17
Running IBM PASE for i programs and
procedures ............. 17
Running an IBM PASE for i program with
QP2SHELL() ............ 18
Running an IBM PASE for i program with
QP2TERM() ............ 19
Running an IBM PASE for i program from
within IBM i programs ........ 19
Examples: Running an IBM PASE for i
program from within IBM i programs .. 19
Calling an IBM PASE for i procedure from
within IBM i programs ........ 21
Example 1: Calling an IBM PASE for i
procedure from within IBM i programs .. 21
Example 2: An IBM i ILE program that
uses pointer arguments in a call to an IBM
PASE for i procedure ........ 22
Using IBM PASE for i native methods from
Java ............... 27
Working with environment variables .... 27
Calling IBM i programs and procedures from
your IBM PASE for i programs ....... 27
Calling ILE procedures ........ 28
Examples: Calling ILE procedures .... 29
Calling IBM i programs from IBM PASE for i 35
Example: Calling IBM i programs from
IBM PASE for i .......... 36
Running IBM i commands from IBM PASE for
i................ 37
Example: Running IBM i commands from
IBM PASE for i .......... 38
How IBM PASE for i programs interact with IBM
i................. 38
Communications .......... 39
Database ............. 39
Example: Calling Db2 for i CLI functions in
an PASE for i program ....... 40
Data encoding ........... 46
File systems ............ 47
Globalization ............ 48
Message services .......... 49
Printing output from IBM PASE for i
applications ............ 50
Pseudo-terminal (PTY)......... 50
Security ............. 51
Work management .......... 53
Debugging your IBM PASE for i programs .... 53
Optimizing performance .......... 53
IBM PASE for i shells and utilities ....... 54
IBM PASE for i commands ........ 54
IBM PASE for i system utility ....... 63
IBM PASE for i qsh, qsh_inout, and qsh_out
commands.............. 66
Examples: IBM PASE for i ......... 67
Related information for IBM PASE for i ..... 67
Notices .............. 69
Programming interface information ...... 71
Trademarks .............. 71
Terms and conditions ........... 71
© Copyright IBM Corp. 2000, 2013 iii