Commit | Line | Data |
---|---|---|
ffe25ee3 B |
1 | # vim: syntax=pod |
2 | ||
522b859a JH |
3 | If you read this file _as_is_, just ignore the funny characters you see. |
4 | It is written in the POD format (see pod/perlpod.pod) which is specially | |
5 | designed to be readable as is. | |
6 | ||
7 | =head1 NAME | |
8 | ||
de2902a6 | 9 | perlos400 - Perl version 5 on OS/400 |
522b859a | 10 | |
2b7f2baa | 11 | B<This document needs to be updated, but we don't know what it should say. |
8166b4e0 | 12 | Please submit comments to L<https://github.com/Perl/perl5/issues>.> |
2b7f2baa | 13 | |
522b859a JH |
14 | =head1 DESCRIPTION |
15 | ||
16 | This document describes various features of IBM's OS/400 operating | |
17 | system that will affect how Perl version 5 (hereafter just Perl) is | |
18 | compiled and/or runs. | |
19 | ||
20 | By far the easiest way to build Perl for OS/400 is to use the PASE | |
21 | (Portable Application Solutions Environment), for more information see | |
635d4d9b | 22 | L<http://www.iseries.ibm.com/developer/factory/pase/index.html> |
522b859a JH |
23 | This environment allows one to use AIX APIs while programming, and it |
24 | provides a runtime that allows AIX binaries to execute directly on the | |
25 | PowerPC iSeries. | |
26 | ||
27 | =head2 Compiling Perl for OS/400 PASE | |
28 | ||
29 | The recommended way to build Perl for the OS/400 PASE is to build the | |
30 | Perl 5 source code (release 5.8.1 or later) under AIX. | |
31 | ||
32 | The trick is to give a special parameter to the Configure shell script | |
33 | when running it on AIX: | |
34 | ||
35 | sh Configure -DPASE ... | |
36 | ||
37 | The default installation directory of Perl under PASE is /QOpenSys/perl. | |
38 | This can be modified if needed with Configure parameter -Dprefix=/some/dir. | |
39 | ||
40 | Starting from OS/400 V5R2 the IBM Visual Age compiler is supported | |
41 | on OS/400 PASE, so it is possible to build Perl natively on OS/400. | |
42 | The easier way, however, is to compile in AIX, as just described. | |
43 | ||
64e35db4 RGS |
44 | If you don't want to install the compiled Perl in AIX into /QOpenSys |
45 | (for packaging it before copying it to PASE), you can use a Configure | |
46 | parameter: -Dinstallprefix=/tmp/QOpenSys/perl. This will cause the | |
47 | "make install" to install everything into that directory, while the | |
48 | installed files still think they are (will be) in /QOpenSys/perl. | |
49 | ||
522b859a JH |
50 | If building natively on PASE, please do the build under the /QOpenSys |
51 | directory, since Perl is happier when built on a case sensitive filesystem. | |
52 | ||
53 | =head2 Installing Perl in OS/400 PASE | |
54 | ||
55 | If you are compiling on AIX, simply do a "make install" on the AIX box. | |
56 | Once the install finishes, tar up the /QOpenSys/perl directory. Transfer | |
57 | the tarball to the OS/400 using FTP with the following commands: | |
58 | ||
59 | > binary | |
60 | > site namefmt 1 | |
61 | > put perl.tar /QOpenSys | |
62 | ||
63 | Once you have it on, simply bring up a PASE shell and extract the tarball. | |
64 | ||
65 | If you are compiling in PASE, then "make install" is the only thing you | |
66 | will need to do. | |
67 | ||
68 | The default path for perl binary is /QOpenSys/perl/bin/perl. You'll | |
69 | want to symlink /QOpenSys/usr/bin/perl to this file so you don't have | |
70 | to modify your path. | |
71 | ||
72 | =head2 Using Perl in OS/400 PASE | |
73 | ||
74 | Perl in PASE may be used in the same manner as you would use Perl on AIX. | |
75 | ||
76 | Scripts starting with #!/usr/bin/perl should work if you have | |
77 | /QOpenSys/usr/bin/perl symlinked to your perl binary. This will not | |
78 | work if you've done a setuid/setgid or have environment variable | |
79 | PASE_EXEC_QOPENSYS="N". If you have V5R1, you'll need to get the | |
80 | latest PTFs to have this feature. Scripts starting with | |
81 | #!/QOpenSys/perl/bin/perl should always work. | |
82 | ||
954a4c1b JH |
83 | =head2 Known Problems |
84 | ||
61074b56 JH |
85 | When compiling in PASE, there is no "oslevel" command. Therefore, |
86 | you may want to create a script called "oslevel" that echoes the | |
87 | level of AIX that your version of PASE runtime supports. If you're | |
88 | unsure, consult your documentation or use "4.3.3.0". | |
89 | ||
90 | If you have test cases that fail, check for the existence of spool files. | |
91 | The test case may be trying to use a syscall that is not implemented | |
92 | in PASE. To avoid the SIGILL, try setting the PASE_SYSCALL_NOSIGILL | |
93 | environment variable or have a handler for the SIGILL. If you can | |
94 | compile programs for PASE, run the config script and edit config.sh | |
95 | when it gives you the option. If you want to remove fchdir(), which | |
96 | isn't implement in V5R1, simply change the line that says: | |
97 | ||
98 | d_fchdir='define' | |
99 | ||
100 | to | |
101 | ||
102 | d_fchdir='undef' | |
103 | ||
104 | and then compile Perl. The places where fchdir() is used have | |
105 | alternatives for systems that do not have fchdir() available. | |
954a4c1b | 106 | |
522b859a JH |
107 | =head2 Perl on ILE |
108 | ||
109 | There exists a port of Perl to the ILE environment. This port, however, | |
110 | is based quite an old release of Perl, Perl 5.00502 (August 1998). | |
111 | (As of July 2002 the latest release of Perl is 5.8.0, and even 5.6.1 | |
112 | has been out since April 2001.) If you need to run Perl on ILE, though, | |
635d4d9b | 113 | you may need this older port: L<http://www.cpan.org/ports/#os400> |
522b859a JH |
114 | Note that any Perl release later than 5.00502 has not been ported to ILE. |
115 | ||
116 | If you need to use Perl in the ILE environment, you may want to consider | |
117 | using Qp2RunPase() to call the PASE version of Perl. | |
118 | ||
119 | =head1 AUTHORS | |
120 | ||
121 | Jarkko Hietaniemi <jhi@iki.fi> | |
122 | Bryan Logan <bryanlog@us.ibm.com> | |
123 | David Larson <larson1@us.ibm.com> | |
124 | ||
125 | =cut |