Enhance some macro robustness.

[perl5.git] / README.os390

diff --git a/README.os390 b/README.os390
index cc550f0..d3b299b 100644 (file)
--- 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
 
 
 =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
 
 =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
 
 
 =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.
 
 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
 
 =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:
 
 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
 
 
 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
 =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.
 
 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</Tools>.

 
 Some people have reported encountering "Out of memory!" errors while
 trying to build Perl using GNU make binaries.  If you encounter such
 
 Some people have reported encountering "Out of memory!" errors while
 trying to build Perl using GNU make binaries.  If you encounter such


@@ -386,7 +410,7 @@ Thanks to John Goodyear for dynamic loading help.
 
 L<INSTALL>, L<perlport>, L<perlebcdic>, L<ExtUtils::MakeMaker>.
 
 
 L<INSTALL>, L<perlport>, L<perlebcdic>, L<ExtUtils::MakeMaker>.
 

-    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
 
 
     http://www.redbooks.ibm.com/abstracts/sg245944.html
 


@@ -400,14 +424,11 @@ L<INSTALL>, L<perlport>, L<perlebcdic>, L<ExtUtils::MakeMaker>.
 
 =head2 Mailing list for Perl on OS/390
 
 
 =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
 
 
     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.
 
 
 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.
 Updated 12 November 2000 for the 5.7.1 release of Perl.
 
 Updated 15 January 2001 for the 5.7.1 release of Perl.