This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Message-Id: <9809010013.AA06737@forte.com>
[perl5.git] / README.os390
CommitLineData
9d116dd7
JH
1This is a fully ported perl for OS/390 Release 3. It may work on
2other versions, but that's the one we've tested it on.
3
4If you've downloaded the binary distribution, it needs to be
5installed below /usr/local. Source code distributions have an
6automated `make install` step that means you do not need to extract
7the source code below /usr/local (though that is where it will be
8installed by default). You may need to worry about the networking
9configuration files discussed in the last bullet below.
10
11Gunzip/gzip for OS/390 is discussed at:
12
13 http://www.s390.ibm.com/products/oe/bpxqp1.html
14
15to extract an ASCII tar archive on OS/390, try this:
16
17 pax -o to=IBM-1047,from=ISO8859-1 -r < latest.tar
18
19GNU make for OS/390, which may be required for the build of perl,
20is available from:
21
22 http://www.mks.com/s390/gnu/index.htm
23
24Once you've unpacked the distribution, run Configure (see INSTALL for
25full discussion of the Configure options), and then run make, then
26"make test" then "make install" (this last step may require UID=0
27privileges)
28
29There is a "hints" file for os390 that specifies the correct values
30for most things. Some things to watch out for are
31
32 - this port doesn't support dynamic loading. Although
33 OS/390 has support for DLLs, there are some differences
34 that cause problems for perl.
35
36 - You may see a "WHOA THERE!!!" message for $d_shmatprototype
37 it is OK to keep the recommended "define".
38
39 - Don't turn on the compiler optimization flag "-O". There's
40 a bug in either the optimizer or perl that causes perl to
41 not work correctly when the optimizer is on.
42
43 - Some of the configuration files in /etc used by the
44 networking APIs are either missing or have the wrong
45 names. In particular, make sure that there's either
46 an /etc/resolv.conf or and /etc/hosts, so that
47 gethostbyname() works, and make sure that the file
48 /etc/proto has been renamed to /etc/protocol (NOT
49 /etc/protocols, as used by other Unix systems).
50
64d55c8a
PP
51 - Some of the parser default files in /sample are needed in /etc.
52 In particular be sure that you at least copy /sample/yy* to /etc
53 before running perl's Configure.
54
9d116dd7
JH
55When using perl on OS/390 please keep in mind that the EBCDIC and ASCII
56character sets are different. Perl builtin functions that may behave
57differently under EBCDIC are mentioned in the perlport.pod document.
58
59OpenEdition (UNIX System Services) does not (yet) support the #! means
60of script invokation.
61See:
62
63 head `whence perldoc`
64
65for an example of how to use the "eval exec" trick to ask the shell to
66have perl run your scripts for you.
67
68perl-mvs mailing list: The Perl Institute (http://www.perl.org/)
69maintains a mailing list of interest to all folks building and/or
70using perl on EBCDIC platforms. To subscibe, send a message of:
71
72 subscribe perl-mvs
73
74to majordomo@perl.org.
75
76Regression tests: as the 5.005 kit was was being assembled
77the following "failures" were known to appear on some machines
78during `make test` (mostly due to ASCII vs. EBCDIC conflicts),
79your results may differ:
80
81comp/cpp..........FAILED at test 0
82op/pack...........FAILED at test 58
83op/stat...........Out of memory!
84op/taint..........FAILED at test 73
85lib/errno.........FAILED at test 1
86lib/posix.........FAILED at test 19