Lines Matching full:perl
9 perlos390 - building and installing Perl for z/OS (previously called OS/390)
13 This document will help you Configure, build, test and install Perl
18 This is a ported Perl for z/OS. It has been tested on z/OS 2.4 and
24 Perl can support either, but you have to compile it explicitly for one or the
25 other. You could have both an ASCII perl, and an EBCDIC perl on the same
26 machine. If you use ASCII mode and an ASCII perl, the Encode module shipped
27 with perl can be used to translate files from various EBCDIC code pages for
28 handling by perl, and then back on output
30 This document describes how to build a 64-bit Dynamic Perl, either ASCII or
42 If you want the latest development version of Perl, you will need git.
50 =head2 Building a 64-bit Dynamic ASCII Perl
52 For building from an official stable release of Perl, go to
53 L<https://www.perl.org/get.html> and choose any one of the
55 name of that tarball will be something like 'perl-V.R.M,tar,gz', where V.R.M is
56 the version/release/modification of the perl you are downloading. Do
58 gunzip perl-V.R.M.tar.gz
62 tar -xvf perl-V.R.M.tar
64 pax -r -f perl-V.R.M.tar
67 whatever you like; for these instructions, 'perl' is assumed to be the name.
70 git on z/OS, clone Perl:
72 git clone https://github.com/Perl/perl5.git perl
74 Either way, once you have a 'perl' directory containing the source, cd into it,
77 cd perl
81 deploying it to F</usr/local/perl/ascii>:
85 ./Configure -Dprefix=/usr/local/perl/ascii -des -Dusedevel \
93 Run GNU make to build Perl
97 Run tests to ensure Perl is working correctly. Currently, there are about a
102 Install Perl into F</usr/local/perl/ascii>:
106 =head2 Building a 64-bit Dynamic EBCDIC Perl
108 You will need a working perl on some box with connectivity to the destination
109 machine. On z/OS, it could be an ASCII perl, or a previous EBCDIC one.
110 Many machines will already have a pre-built perl already running, or one can
111 easily be downloaded from L<https://www.perl.org/get.html>.
113 Follow the directions above in "Building a 64-bit Dynamic ASCII Perl" as far as
114 getting a populated 'perl' directory. Then come back here to proceed.
116 The downloaded perl will need to be converted to 1047 EBCDIC. To do this:
118 cd perl
123 version/release/modification of Perl you are uploading:
126 tar cf - --format=ustar perl-V.R.M | gzip --best > perl-V.R.M.tar.gz
132 put perl-V.R.M.tar.gz
137 gunzip perl-V.R.M.tar.gz
141 tar -xvf perl-V.R.M.tar
143 pax -r -f perl-V.R.M.tar
145 You now have the source code for the EBCDIC Perl on z/OS and can proceed to
150 deploying it to F</usr/local/perl/ebcdic>:
154 ./Configure -Dprefix=/usr/local/perl/ebcdic -des -Dusedevel \
162 Run GNU make to build Perl
166 Run tests to ensure Perl is working correctly.
171 running the "make install" step for Perl.
173 Install Perl into F</usr/local/perl/ebcdic>:
177 EBCDIC Perl is still a work in progress. All the core code works as far as we
190 Some CPAN modules come bundled with the downloaded perl. And a few of those
195 Config::Perl::V
219 =head2 Setup and utilities for Perl on OS/390
248 CPAN with newer versions (like Encode) without rebuilding all of the perl
251 The instructions above will create a dynamic Perl. If you do not want to
257 Optimization has not been turned on yet. There may be issues if Perl
260 =head2 Build Anomalies with Perl on OS/390
262 "Out of memory!" messages during the build of Perl are most often fixed
277 =head2 Testing Anomalies with Perl on OS/390
279 The "make test" step runs a Perl Verification Procedure, usually before
287 a 31-bit Perl.
289 If you _are_ building a 31-bit Perl, the constrained environment may mean you
290 need to change memory options for Perl.
293 in your environment. Perl now has (in miniperlmain.c) a C #pragma for 31-bit only
302 increment is too small then when perl (for example loading unicode/Name.pl) tries
307 A related issue is use with perl's malloc. Perl's malloc uses C<sbrk()>
315 =head2 Usage Hints for Perl on z/OS
317 When using Perl on z/OS please keep in mind that the EBCDIC and ASCII
319 set issues. Perl builtin functions that may behave differently under
324 working with Perl on USS.
326 =head2 Modules and Extensions for Perl on z/OS (Static Only)
328 Pure Perl (that is non XS) modules may be installed via the usual:
330 perl Makefile.PL
335 If you built perl with dynamic loading capability then that would also
336 be the way to build XS based extensions. However, if you built perl with
339 building statically linked perl binaries. In the simplest configurations
340 building a static perl + XS extension boils down to:
342 perl Makefile.PL
344 make perl
347 make -f Makefile.aperl inst_perl MAP_TARGET=perl
349 =head2 Running Perl on z/OS
351 To run the 64-bit Dynamic Perl environment, update your PATH and LIBPATH
352 to include the location you installed Perl into, and then run the perl you
355 If you are running the ASCII/EBCDIC Bi-Modal Perl environment, you also need to
356 set up your ASCII/EBCDIC Bi-Modal environment variables, and ensure any Perl
372 export PATH=/usr/local/perl/ascii:$PATH
373 export LIBPATH=/usr/local/perl/ascii/lib:$LIBPATH
394 for building various z/OS Perl configurations and has some useful tools in the
395 'bin' directory you may want to use for building z/OS Perl yourself.
401 Updated 03 October 2019 for perl-5.33.3+
409 Updated 15 January 2001 for the 5.7.1 release of Perl.
411 Updated 12 November 2000 for the 5.7.1 release of Perl.
413 This document was podified for the 5.005_03 release of Perl 11 March 1999.
416 release of Perl.