|
XL C/C++ or XL C for AIX compiler installation in OS/400 PASE
You can compile and build OS/400 PASE applications using either the XL C/C++ Enterprise Edition V7.0 for AIX compiler or the XL C Enterprise Edition V7.0 for AIX compiler. You may use one of the following strategies:
- Cross-compile from AIX
- Compile within OS/400 PASE
The XL C/C++ AIX compiler (5724-I11) is the successor product to IBM XL C/C++ for AIX Version 6.0 (5765-F56). The XL C Enterprise Edition V7.0 for AIX (5724-I10) is the successor product to IBM XL C for AIX (5765-F57). Either of the predecessor products may still be used with OS/400 PASE.
Irrespective of which compiler is used, it must be separately ordered. For more information, see the XL C/C++ AIX compiler web site or the XL C AIX compiler web site.
Installation instructions
OS/400 PASE does not support the AIX smit or installp utilities typically used to install applications on an AIX system. Installation of the XL C/C++ for AIX or XL C for AIX products is accomplished through a "non-default installation" script included on the respective compiler's installation media.
The following steps will install the XL C/C++ for AIX or XL XL C for AIX product on iSeries OS/400 PASE:
Note: ... indicates a command that should be entered as one line.
- Verify you have the necessary prerequisites:
In addition to the compiler installation media (5724-I11 for XL C/C++ for AIX or 5724-I10 for XL XL C for AIX), you will also need the following installed on your iSeries system to successfully install and use the compiler:
- 5722SS1 Option 33 - OS/400 PASE itself
- 5722SS1 Option 13 - System Openness Includes containing the compiler header files found in the /usr/include IFS directory
- 5799PTL - iSeries Tools For Developers PRPQ. The compiler installation scripts require Perl. Perl (along with many other useful development tools) is included in the separately available iSeries Tools For Developers PRPQ.
- Insert the compiler product installation CD into the iSeries CDROM device
- Sign on to OS/400 with a user profile that has *ALLOBJ authority.
The compiler product files will be owned by this user profile.
- Start an interactive OS/400 PASE terminal session by entering this CL command:
call qp2term
- Restore the appropriate compiler installation script by entering these commands:
for XL C/C++ for AIX:
cd /
restore -qf /QOPT/CDROM/USR/SYS/INST.IMA/VACPP.NDI...
... ./usr/vacpp/bin/vacppndi
for XL XL C for AIX:
cd /
restore -qf /QOPT/CDROM/USR/SYS/INST.IMA/VAC.NDI...
... ./usr/vac/bin/vacndi
- Run the installation script to install the XL C/C++ for AIX compiler
We recommend installing into the /QOpenSys/xlc70 directory. You can choose a different destination by changing the value of the -b option in the command.
Based on the compiler you are installing, enter one of the following commands:
for XL C/C++ for AIX:
/QIBM/ProdData/DeveloperTools/pase/bin/perl
/usr/vacpp/bin/vacppndi...
... -i -d /QOPT/CDROM/USR/SYS/INST.IMA -b /QOpenSys/xlc70
for XL XL C for AIX:
/QIBM/ProdData/DeveloperTools/pase/bin/perl
/usr/vac/bin/vacndi...
... -i -d /QOPT/CDROM/USR/SYS/INST.IMA -b /QOpenSys/xlc70
Note that your web browser may display these commands across multiple lines, however the command should be entered as a single command string in the QP2TERM command line.
The compiler is now installed for use in OS/400 PASE.
The XL C/C++ for AIX compiler commands such as xlC can be found in directory /QOpenSys/xlc70/usr/vacpp/bin/ you may want to add this directory to your $PATH environment variable.
The XL C/C++ for AIX compiler documentation can be found in Adobe Acrobat format in directory /QOpenSys/xlc70/usr/vacpp/doc/en_US/pdf/
The XL C for AIX compiler commands such as xlc and cc can be found in directory /QOpenSys/xlc70/usr/vac/bin/ you may want to add this directory to your $PATH environment variable.
The XL C for AIX compiler documentation can be found in Adobe Acrobat format in directory /QOpenSys/xlc70/usr/vac/ doc/en_US/pdf/
PTF update instructions
Installation of PTF's for the XL C/C++ for AIX or XL C for AIX products is accomplished using the same "non-default installation" script that is used for the initial compiler installation. The following steps will install PTF's for the XL C/C++ for AIX or XL C for AIX product on iSeries OS/400 PASE:
Note: ... indicates a command that should be entered as one line.
You must have already installed the compiler(s) using the steps above prior to installing any PTF updates
Obtain the PTF package files to be installed
You can download compressed TAR images of the compiler PTF packages from the support downloads section of the XL C/C++ for AIX web site.
Uncompress and then untar the PTF package files. If you have downloaded the compressed TAR images to the /QOpenSys/vacptf/ directory, you can use these commands from a QP2TERM command line to do this:
cd /QOpenSys/vacptf
uncompress <filename.tar.Z>
tar -xvf <filename.tar>
Create a file containing a list of the PTF packages to be installed.
Use these commands from a QP2TERM command line to do this:
cd /QOpenSys/vacptf
ls *.bff > vacptflist.txt
Run the installation script to install the PTF's
Based on the compiler you are updating, enter one of the following commands from the QP2TERM command line:
for XL C/C++ for AIX:
/QIBM/ProdData/DeveloperTools/pase/bin/perl
/usr/vacpp/bin/vacppndi...
... -d /QOpenSys/vacptf -b /QOpenSys/xlc70...
... -u /QOpenSys/vacptf/vacptflist.txt
for XL C for AIX:
/QIBM/ProdData/DeveloperTools/pase/bin/perl
/usr/vac/bin/vacndi...
... -d /QOpenSys/vacptf -b /QOpenSys/xlc70...
... -u /QOpenSys/vacptf/vacptflist.txt
The installation script will create a compressed TAR backup of the existing compiler files prior to the PTF update. If you use the directories as shown in these instructions, this file will be named /QOpenSys/xlc70.backup.tar.Z If a problem is encountered with the installation of the PTF update or the PTF update itself, you can restore from this backup to "uninstall" the PTF update.
|
