X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=README.os390;h=d3b299bb08f33445e1858a69b2c9c485f318a1af;hb=484fdf61e8653b10160ba1e8011888f52ab6825a;hp=cc550f07010d3da9fdf05f7610ef7b76d79b4bf3;hpb=210b36aa2e9e009554be8970c3315c2658c0384f;p=p5sagit%2Fp5-mst-13.2.git

diff --git a/README.os390 b/README.os390
index cc550f0..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</Tools>.
 
 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>.
 
-    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<INSTALL>, L<perlport>, L<perlebcdic>, L<ExtUtils::MakeMaker>.
 
 =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.