X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=README.os390;h=d3b299bb08f33445e1858a69b2c9c485f318a1af;hb=f8952f9c0d30f65af1114a6384b97ad7770dce81;hp=578d5a3c7ce82540d0afb2cc2086d55ffbb19a8b;hpb=1e32511cda17f148fd0dbe53ae3841f0a204adcc;p=p5sagit%2Fp5-mst-13.2.git diff --git a/README.os390 b/README.os390 index 578d5a3..d3b299b 100644 --- a/README.os390 +++ b/README.os390 @@ -5,12 +5,12 @@ about pod in pod/perlpod.pod or the short summary in the INSTALL file. =head1 NAME -README.os390 - building and installing Perl for OS/390. +README.os390 - building and installing Perl for OS/390 and z/OS =head1 SYNOPSIS This document will help you Configure, build, test and install Perl -on OS/390 Unix System Services. +on OS/390 (aka z/OS) Unix System Services. =head1 DESCRIPTION @@ -21,16 +21,41 @@ the ones we've tested it on. You may need to carry out some system configuration tasks before running the Configure script for Perl. + +=head2 Tools + +The z/OS Unix Tools and Toys list may prove helpful and contains links +to ports of much of the software helpful for building Perl. +http://www-1.ibm.com/servers/eserver/zseries/zos/unix/bpxa1toy.html + + =head2 Unpacking Perl distribution on OS/390 +If using ftp remember to transfer the distribution in binary format. + Gunzip/gzip for OS/390 is discussed at: - http://www.s390.ibm.com/products/oe/bpxqp1.html + http://www-1.ibm.com/servers/eserver/zseries/zos/unix/faq/bpxqp1.html to extract an ASCII tar archive on OS/390, try this: pax -o to=IBM-1047,from=ISO8859-1 -r < latest.tar +or + + zcat latest.tar.Z | pax -o to=IBM-1047,from=ISO8859-1 -r + +If you get lots of errors of the form + + tar: FSUM7171 ...: cannot set uid/gid: EDC5139I Operation not permitted. + +you didn't read the above and tried to use tar instead of pax, you'll +first have to remove the (now corrupt) perl directory + + rm -rf perl-... + +and then use pax. + =head2 Setup and utilities for Perl on OS/390 Be sure that your yacc installation is in place including any necessary @@ -44,10 +69,9 @@ The IBM document that described such USS system setup issues was SC28-1890-07 "OS/390 UNIX System Services Planning", in particular Chapter 6 on customizing the OE shell. -GNU make for OS/390, which is recommended for the build of perl (as well as -building CPAN modules and extensions), is available from: - - http://www.mks.com/s390/gnu/index.htm +GNU make for OS/390, which is recommended for the build of perl (as +well as building CPAN modules and extensions), is available from the +L. Some people have reported encountering "Out of memory!" errors while trying to build Perl using GNU make binaries. If you encounter such @@ -253,16 +277,16 @@ Out of Memory! Recent perl test suite is quite memory hunrgy. In addition to the comments above on memory limitations it is also worth checking for _CEE_RUNOPTS in your environment. Perl now has (in miniperlmain.c) a C #pragma -to set CEE run options, but the enviroment variable wins. +to set CEE run options, but the environment variable wins. -The C code ask for: +The C code asks for: #pragma runopts(HEAP(2M,500K,ANYWHERE,KEEP,8K,4K) STACK(,,ANY,) ALL31(ON)) The important parts of that are the second argument (the increment) to HEAP, and allowing the stack to be "Above the (16M) line". If the heap -increment is too small then when perl (for example loading unicode/Name.pl) trys -to create a "big" (400K+) string it cannot fit in a single segement +increment is too small then when perl (for example loading unicode/Name.pl) tries +to create a "big" (400K+) string it cannot fit in a single segment and you get "Out of Memory!" - even if there is still plenty of memory available. @@ -386,7 +410,7 @@ Thanks to John Goodyear for dynamic loading help. L, L, L, L. - http://www.mks.com/s390/gnu/index.htm + http://www-1.ibm.com/servers/eserver/zseries/zos/unix/bpxa1toy.html http://www.redbooks.ibm.com/abstracts/sg245944.html @@ -400,14 +424,11 @@ L, L, L, L. =head2 Mailing list for Perl on OS/390 -The Perl Institute (http://www.perl.org/) maintains a perl-mvs -mailing list of interest to all folks building and/or -using perl on all EBCDIC platforms (not just OS/390). -To subscribe, send a message of: - - subscribe perl-mvs +If you are interested in the VM/ESA, z/OS (formerly known as OS/390) +and POSIX-BC (BS2000) ports of Perl then see the perl-mvs mailing list. +To subscribe, send an empty message to perl-mvs-subscribe@perl.org. -to majordomo@perl.org. See also: +See also: http://lists.perl.org/showlist.cgi?name=perl-mvs @@ -423,6 +444,8 @@ release of Perl. This document was podified for the 5.005_03 release of Perl 11 March 1999. +Updated 28 November 2001 for broken URLs. + Updated 12 November 2000 for the 5.7.1 release of Perl. Updated 15 January 2001 for the 5.7.1 release of Perl.