Penguin
Recent Changes
Blame: perlvmesa(1)
EditPageHistoryDiffInfoLikePages
Annotated edit history of perlvmesa(1) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 PERLVMESA
2 !!!PERLVMESA
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 AUTHORS
7 SEE ALSO
8 ----
9 !!NAME
10
11
12 README .vmesa - building and installing Perl for VM/ESA .
13 !!SYNOPSIS
14
15
16 This document will help you Configure, build, test and
17 install Perl on VM/ESA .
18 !!DESCRIPTION
19
20
21 This is a fully ported perl for VM/ESA
22 2.3.0. It may work on other versions, but that's the
23 one we've tested it on.
24
25
26 If you've downloaded the binary distribution, it needs
27 to be installed below /usr/local. Source code distributions
28 have an automated `make install` step that means you do not
29 need to extract the source code below /usr/local (though
30 that is where it will be installed by default). You may need
31 to worry about the networking configuration files discussed
32 in the last bullet below.
33
34
35 __Unpacking__
36
37
38 To extract an ASCII tar archive on
39 VM/ESA , try this:
40
41
42 pax -o to=IBM-1047,from=ISO8859-1 -r
43
44
45 __Setup and utilities__
46
47
48 GNU make for VM/ESA , which may be required
49 for the build of perl, is available from:
50
51
52 http://pucc.princeton.edu/~neale/vmoe.html
53
54
55 __Configure__
56
57
58 Once you've unpacked the distribution, run Configure
59 (see INSTALL for full discussion of the Configure
60 options), and then run make, then ``make test'' then ``make
61 install'' (this last step may require UID=0
62 privileges).
63
64
65 There is a ``hints'' file for vmesa that specifies the
66 correct values for most things. Some things to watch out for
67 are:
68
69
70 this port does support dynamic loading but it's not had
71 much testing
72
73
74 Don't turn on the compiler optimization flag ``-O''.
75 There's a bug in the compiler ( APAR PQ18812 )
76 that generates some bad code the optimizer is
77 on.
78
79
80 As VM/ESA doesn't fully support the
81 ''fork()'' API programs relying on this call
82 will not work. I've replaced ''fork()''/''exec()''
83 with ''spawn()'' and the standalone ''exec()'' with
84 ''spawn()''. This has a side effect when opening unnamed
85 pipes in a shell script: there is no child process generated
86 under.
87
88
89 At the moment the hints file for VM/ESA
90 basically bypasses all of the automatic configuration
91 process. This is because Configure relies on: 1. The header
92 files living in the Byte File System (you could put the
93 there if you want); 2. The C preprocessor including the
94 #include statements in the preprocessor output (.i)
95 file.
96
97
98 __testing anomalies__
99
100
101 The `make test` step runs a Perl Verification
102 Procedure, usually before installation. As the 5.6.1 kit was
103 was being assembled the following ``failures'' were known to
104 appear on some machines during `make test` (mostly due
105 to ASCII vs. EBCDIC conflicts), your
106 results may differ:
107
108
109 [[the list of failures being
110 compiled]
111
112
113 __Usage Hints__
114
115
116 When using perl on VM/ESA please keep in
117 mind that the EBCDIC and ASCII
118 character sets are different. Perl builtin functions
119 that may behave differently under EBCDIC are
120 mentioned in the perlport.pod document.
121
122
2 perry 123 !OpenEdition ( UNIX System Services) does not
1 perry 124 (yet) support the #! means of script invocation.
125 See:
126
127
128 head `whence perldoc`
129 for an example of how to use the ``eval exec'' trick to ask the shell to have perl run your scripts for you.
130 !!AUTHORS
131
132
133 Neale Ferguson.
134 !!SEE ALSO
135
136
137 INSTALL , perlport, perlebcdic.
138
139
140 __Mailing list__
141
142
143 If you are interested in the VM and
144 OS/390 ports of perl then see the perl-mvs mailing
145 list: The Perl Institute (http://www.perl.org/) maintains a
146 mailing list of interest to all folks building and/or using
147 perl on EBCDIC platforms. To subscribe, send a
148 message of:
149
150
151 subscribe perl-mvs
152 to majordomo@perl.org.
153
154
155 See also:
156 http://lists.perl.org/showlist.cgi?name=perl-mvs
157 There are web archives of the mailing list at:
158
159
160 http://www.xray.mpe.mpg.de/mailing-lists/perl-mvs/
161 http://archive.develooper.com/perl-mvs@perl.org/
162 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.