X-Git-Url: https://perl5.git.perl.org/perl5.git/blobdiff_plain/f110302ff2b10c8a78f4ac9328290a9273bb7578..38a400f2228b6ee92ec8af033bbfb0983cb04c7b:/README.os390 diff --git a/README.os390 b/README.os390 index 3011ad6..645d10e 100644 --- a/README.os390 +++ b/README.os390 @@ -5,7 +5,7 @@ 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 and z/OS +perlos390 - building and installing Perl for OS/390 and z/OS =head1 SYNOPSIS @@ -26,19 +26,36 @@ running the Configure script for Perl. 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 +http://www.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-1.ibm.com/servers/eserver/zseries/zos/unix/faq/bpxqp1.html + http://www.ibm.com/servers/eserver/zseries/zos/unix/bpxa1ty1.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 @@ -73,7 +90,7 @@ and be sure to also set the environment variable _C89_CCMODE=1 (exporting _C89_CCMODE=1 is also a good idea for users of GNU make). You might also want to have GNU groff for OS/390 installed before -running the `make install` step for Perl. +running the "make install" step for Perl. There is a syntax error in the /usr/include/sys/socket.h header file that IBM supplies with USS V2R7, V2R8, and possibly V2R9. The problem with @@ -203,9 +220,9 @@ header /usr/include/sys/socket.h. =head2 Testing Anomalies with Perl on OS/390 -The `make test` step runs a Perl Verification Procedure, usually before +The "make test" step runs a Perl Verification Procedure, usually before installation. You might encounter STDERR messages even during a successful -run of `make test`. Here is a guide to some of the more commonly seen +run of "make test". Here is a guide to some of the more commonly seen anomalies: =over 4 @@ -214,20 +231,6 @@ anomalies: A message of the form: - comp/cpp.............ERROR CBC3191 ./.301989890.c:1 The character $ is not a - valid C source character. - FSUM3065 The COMPILE step ended with return code 12. - FSUM3017 Could not compile .301989890.c. Correct the errors and try again. - ok - -indicates that the t/comp/cpp.t test of Perl's -P command line switch has -passed but that the particular invocation of c89 -E in the cpp script does -not suppress the C compiler check of source code validity. - -=item * - -A message of the form: - io/openpid...........CEE5210S The signal SIGHUP was received. CEE5210S The signal SIGHUP was received. CEE5210S The signal SIGHUP was received. @@ -257,7 +260,7 @@ from an account with write access to the directory entry for /tmp. Out of Memory! -Recent perl test suite is quite memory hunrgy. In addition to the comments +Recent perl test suite is quite memory hungry. 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 environment variable wins. @@ -393,11 +396,11 @@ Thanks to John Goodyear for dynamic loading help. L, L, L, L. - http://www-1.ibm.com/servers/eserver/zseries/zos/unix/bpxa1toy.html + http://www.ibm.com/servers/eserver/zseries/zos/unix/bpxa1toy.html - http://www.redbooks.ibm.com/abstracts/sg245944.html + http://www.redbooks.ibm.com/redbooks/SG245944.html - http://www-1.ibm.com/servers/eserver/zseries/zos/unix/bpxa1ty1.html#opensrc + http://www.ibm.com/servers/eserver/zseries/zos/unix/bpxa1ty1.html#opensrc http://www.xray.mpe.mpg.de/mailing-lists/perl-mvs/ @@ -407,16 +410,13 @@ 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 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 + http://lists.perl.org/list/perl-mvs.html There are web archives of the mailing list at: