perlvmesa(1)

1PERLVMESA(1)           Perl Programmers Reference Guide           PERLVMESA(1)
2
3
4

NAME

6       README.vmesa - building and installing Perl for VM/ESA.
7

SYNOPSIS

9       This document will help you Configure, build, test and install Perl on
10       VM/ESA.
11

DESCRIPTION

13       This is a fully ported perl for VM/ESA 2.3.0.  It may work on other
14       versions, but that's the one we've tested it on.
15
16       If you've downloaded the binary distribution, it needs to be installed
17       below /usr/local.  Source code distributions have an automated "make
18       install" step that means you do not need to extract the source code
19       below /usr/local (though that is where it will be installed by
20       default).  You may need to worry about the networking configuration
21       files discussed in the last bullet below.
22
23       Unpacking Perl Distribution on VM/ESA
24
25       To extract an ASCII tar archive on VM/ESA, try this:
26
27          pax -o to=IBM-1047,from=ISO8859-1 -r < latest.tar
28
29       Setup Perl and utilities on VM/ESA
30
31       GNU make for VM/ESA, which may be required for the build of perl, is
32       available from:
33
34         http://vm.marist.edu/~neale/vmoe.html
35
36       Configure Perl on VM/ESA
37
38       Once you've unpacked the distribution, run Configure (see INSTALL for
39       full discussion of the Configure options), and then run make, then
40       "make test" then "make install" (this last step may require UID=0 priv‐
41       ileges).
42
43       There is a "hints" file for vmesa that specifies the correct values for
44       most things.  Some things to watch out for are:
45
46       ·   this port does support dynamic loading but it's not had much test‐
47           ing
48
49       ·   Don't turn on the compiler optimization flag "-O".  There's a bug
50           in the compiler (APAR PQ18812) that generates some bad code the
51           optimizer is on.
52
53       ·   As VM/ESA doesn't fully support the fork() API programs relying on
54           this call will not work. I've replaced fork()/exec() with spawn()
55           and the standalone exec() with spawn(). This has a side effect when
56           opening unnamed pipes in a shell script: there is no child process
57           generated under.
58
59       ·   At the moment the hints file for VM/ESA basically bypasses all of
60           the automatic configuration process.  This is because Configure
61           relies on: 1. The header files living in the Byte File System (you
62           could put the there if you want); 2. The C preprocessor including
63           the #include statements in the preprocessor output (.i) file.
64
65       Testing Anomalies of Perl on VM/ESA
66
67       The "make test" step runs a Perl Verification Procedure, usually before
68       installation.  As the 5.6.1 kit was being assembled the following
69       "failures" were known to appear on some machines during "make test"
70       (mostly due to ASCII vs. EBCDIC conflicts), your results may differ:
71
72       [the list of failures being compiled]
73
74       Usage Hints for Perl on VM/ESA
75
76       When using perl on VM/ESA please keep in mind that the EBCDIC and ASCII
77       character sets are different.  Perl builtin functions that may behave
78       differently under EBCDIC are mentioned in the perlport.pod document.
79
80       OpenEdition (UNIX System Services) does not (yet) support the #! means
81       of script invocation.  See:
82
83           head `whence perldoc`
84
85       for an example of how to use the "eval exec" trick to ask the shell to
86       have perl run your scripts for you.
87

AUTHORS

89       Neale Ferguson.
90

NAME

SYNOPSIS

DESCRIPTION

AUTHORS

SEE ALSO