X-Git-Url: https://perl5.git.perl.org/perl5.git/blobdiff_plain/0f5a2e590c3bb0e4ece26f74eeb3121063d229ad..e368b3bddfac0a2de936fe626b4a3221d42bc756:/README.vmesa diff --git a/README.vmesa b/README.vmesa index 43c5219..f11f5d8 100644 --- a/README.vmesa +++ b/README.vmesa @@ -7,7 +7,7 @@ INSTALL file. =head1 NAME -README.vmesa - building and installing Perl for VM/ESA. +perlvmesa - building and installing Perl for VM/ESA. =head1 SYNOPSIS @@ -21,25 +21,25 @@ other versions, but that's the one we've tested it on. If you've downloaded the binary distribution, it needs to be installed below /usr/local. Source code distributions have an -automated `make install` step that means you do not need to extract +automated "make install" step that means you do not need to extract the source code below /usr/local (though that is where it will be installed by default). You may need to worry about the networking configuration files discussed in the last bullet below. -=head2 Unpacking +=head2 Unpacking Perl Distribution on VM/ESA To extract an ASCII tar archive on VM/ESA, try this: pax -o to=IBM-1047,from=ISO8859-1 -r < latest.tar -=head2 Setup and utilities +=head2 Setup Perl and utilities on VM/ESA GNU make for VM/ESA, which may be required for the build of perl, is available from: - http://pucc.princeton.edu/~neale/vmoe.html +L -=head2 Configure +=head2 Configure Perl on VM/ESA Once you've unpacked the distribution, run Configure (see INSTALL for full discussion of the Configure options), and then run make, then @@ -56,16 +56,18 @@ for most things. Some things to watch out for are: this port does support dynamic loading but it's not had much testing =item * - - Don't turn on the compiler optimization flag "-O". There's - a bug in the compiler (APAR PQ18812) that generates some bad code - the optimizer is on. + +Don't turn on the compiler optimization flag "-O". There's +a bug in the compiler (APAR PQ18812) that generates some bad code +the optimizer is on. =item * - - As VM/ESA doesn't fully support the fork() API programs relying on - this call will not work. I've replaced fork()/exec() with spawn() - and the standalone exec() with spawn(). This has a side effect when - opening unnamed pipes in a shell script: there is no child process - generated under. + +As VM/ESA doesn't fully support the fork() API programs relying on +this call will not work. I've replaced fork()/exec() with spawn() +and the standalone exec() with spawn(). This has a side effect when +opening unnamed pipes in a shell script: there is no child process +generated under. =item * @@ -77,18 +79,18 @@ statements in the preprocessor output (.i) file. =back -=head2 testing anomalies +=head2 Testing Anomalies of Perl on VM/ESA -The `make test` step runs a Perl Verification Procedure, usually before -installation. As the 5.6.1 kit was was being assembled +The "make test" step runs a Perl Verification Procedure, usually before +installation. As the 5.6.1 kit was being assembled the following "failures" were known to appear on some machines -during `make test` (mostly due to ASCII vs. EBCDIC conflicts), +during "make test" (mostly due to ASCII vs. EBCDIC conflicts), your results may differ: [the list of failures being compiled] -=head2 Usage Hints - +=head2 Usage Hints for Perl on VM/ESA + When using perl on VM/ESA please keep in mind that the EBCDIC and ASCII character sets are different. Perl builtin functions that may behave differently under EBCDIC are mentioned in the perlport.pod document. @@ -110,25 +112,29 @@ Neale Ferguson. L, L, L. -=head2 Mailing list +=head2 Mailing list for Perl on VM/ESA -If you are interested in the VM and OS/390 ports of perl then see the -perl-mvs mailing list: The Perl Institute (http://www.perl.org/) -maintains a mailing list of interest to all folks building and/or -using perl on EBCDIC platforms. To subscribe, send a message of: +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. - subscribe perl-mvs +See also: -to majordomo@perl.org. +L - See also: +There are web archives of the mailing list at: - http://lists.perl.org/showlist.cgi?name=perl-mvs +=over 4 -There are web archives of the mailing list at: +=item * + +L + +=item * + +L - http://www.xray.mpe.mpg.de/mailing-lists/perl-mvs/ - http://archive.develooper.com/perl-mvs@perl.org/ +=back =cut