home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _a5d97921fb886b3dd79a9ea874b23950 < prev    next >
Text File  |  2000-03-23  |  7KB  |  179 lines
  1. <HTML>
  2. <HEAD>
  3. <TITLE>README.os390 - building and installing Perl for OS/390.</TITLE>
  4. <LINK REL="stylesheet" HREF="../../Active.css" TYPE="text/css">
  5. <LINK REV="made" HREF="mailto:">
  6. </HEAD>
  7.  
  8. <BODY>
  9. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  10. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  11. <STRONG><P CLASS=block> README.os390 - building and installing Perl for OS/390.</P></STRONG>
  12. </TD></TR>
  13. </TABLE>
  14.  
  15. <A NAME="__index__"></A>
  16. <!-- INDEX BEGIN -->
  17.  
  18. <UL>
  19.  
  20.     <LI><A HREF="#name">NAME</A></LI>
  21.     <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
  22.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  23.     <UL>
  24.  
  25.         <LI><A HREF="#unpacking">Unpacking</A></LI>
  26.         <LI><A HREF="#setup and utilities">Setup and utilities</A></LI>
  27.         <LI><A HREF="#configure">Configure</A></LI>
  28.         <LI><A HREF="#build, test, install">Build, test, install</A></LI>
  29.         <LI><A HREF="#usage hints">Usage Hints</A></LI>
  30.         <LI><A HREF="#extensions">Extensions</A></LI>
  31.     </UL>
  32.  
  33.     <LI><A HREF="#authors">AUTHORS</A></LI>
  34.     <LI><A HREF="#see also">SEE ALSO</A></LI>
  35.     <UL>
  36.  
  37.         <LI><A HREF="#mailing list">Mailing list</A></LI>
  38.     </UL>
  39.  
  40.     <LI><A HREF="#history">HISTORY</A></LI>
  41. </UL>
  42. <!-- INDEX END -->
  43.  
  44. <HR>
  45. <P>
  46. <H1><A NAME="name">NAME</A></H1>
  47. <P>README.os390 - building and installing Perl for OS/390.</P>
  48. <P>
  49. <HR>
  50. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  51. <P>This document will help you Configure, build, test and install Perl
  52. on OS/390 Unix System Services.</P>
  53. <P>
  54. <HR>
  55. <H1><A NAME="description">DESCRIPTION</A></H1>
  56. <P>This is a fully ported perl for OS/390 Release 3, 5 and 6.
  57. It may work on other versions, but those are the ones we've 
  58. tested it on.</P>
  59. <P>You may need to carry out some system configuration tasks before 
  60. running the Configure script for perl.</P>
  61. <P>
  62. <H2><A NAME="unpacking">Unpacking</A></H2>
  63. <P>Gunzip/gzip for OS/390 is discussed at:</P>
  64. <PRE>
  65.    <A HREF="http://www.s390.ibm.com/products/oe/bpxqp1.html">http://www.s390.ibm.com/products/oe/bpxqp1.html</A></PRE>
  66. <P>to extract an ASCII tar archive on OS/390, try this:</P>
  67. <PRE>
  68.    pax -o to=IBM-1047,from=ISO8859-1 -r < latest.tar</PRE>
  69. <P>
  70. <H2><A NAME="setup and utilities">Setup and utilities</A></H2>
  71. <P>Be sure that your yacc installation is in place including any necessary
  72. parser template files. If you have not already done so then be sure to:</P>
  73. <PRE>
  74.   cp /samples/yyparse.c /etc</PRE>
  75. <P>This may also be a good time to ensure that your /etc/protocol file 
  76. and either your /etc/resolv.conf or /etc/hosts files are in place.</P>
  77. <P>GNU make for OS/390, which may be required for the build of perl, 
  78. is available from:</P>
  79. <PRE>
  80.   <A HREF="http://www.mks.com/s390/gnu/index.htm">http://www.mks.com/s390/gnu/index.htm</A></PRE>
  81. <P>
  82. <H2><A NAME="configure">Configure</A></H2>
  83. <P>Once you've unpacked the distribution, run ``sh Configure'' (see INSTALL 
  84. for a full discussion of the Configure options).  There is a ``hints'' file 
  85. for os390 that specifies the correct values for most things.  Some things
  86. to watch out for include:</P>
  87. <UL>
  88. <LI>
  89. Some of the parser default template files in /samples are needed in /etc.
  90. In particular be sure that you at least copy /samples/yyparse.c to /etc
  91. before running perl's Configure.  This step ensures successful extraction
  92. of EBCDIC versions of parser files such as perly.c.
  93. <P></P>
  94. <LI>
  95. This port doesn't support dynamic loading.  Although
  96. OS/390 has support for DLLs, there are some differences
  97. that cause problems for perl.
  98. <P></P>
  99. <LI>
  100. You may see a ``WHOA THERE!!!'' message for $d_shmatprototype
  101. it is OK to keep the recommended ``define''.
  102. <P></P>
  103. <LI>
  104. Don't turn on the compiler optimization flag ``-O''.  There's
  105. a bug in either the optimizer or perl that causes perl to
  106. not work correctly when the optimizer is on.
  107. <P></P>
  108. <LI>
  109. Some of the configuration files in /etc used by the
  110. networking APIs are either missing or have the wrong
  111. names.  In particular, make sure that there's either
  112. an /etc/resolv.conf or and /etc/hosts, so that
  113. <A HREF="../../lib/Pod/perlfunc.html#item_gethostbyname"><CODE>gethostbyname()</CODE></A> works, and make sure that the file
  114. /etc/proto has been renamed to /etc/protocol (NOT
  115. /etc/protocols, as used by other Unix systems).
  116. <P></P></UL>
  117. <P>
  118. <H2><A NAME="build, test, install">Build, test, install</A></H2>
  119. <P>Simply put:</P>
  120. <PRE>
  121.     sh Configure
  122.     make
  123.     make test</PRE>
  124. <P>if everything looks ok then:</P>
  125. <PRE>
  126.     make install</PRE>
  127. <P>this last step may or may not require UID=0 privileges depending
  128. on how you answered the questions that Configure asked and whether
  129. or not you have write access to the directories you specified.</P>
  130. <P>
  131. <H2><A NAME="usage hints">Usage Hints</A></H2>
  132. <P>When using perl on OS/390 please keep in mind that the EBCDIC and ASCII
  133. character sets are different.  Perl builtin functions that may behave
  134. differently under EBCDIC are mentioned in the perlport.pod document.</P>
  135. <P>OpenEdition (UNIX System Services) does not (yet) support the #! means 
  136. of script invokation.
  137. See:</P>
  138. <PRE>
  139.     head `whence perldoc`</PRE>
  140. <P>for an example of how to use the ``eval exec'' trick to ask the shell to
  141. have perl run your scripts for you.</P>
  142. <P>
  143. <H2><A NAME="extensions">Extensions</A></H2>
  144. <P>You can build xs based extensions to Perl for OS/390 but will need to
  145. follow the instructions in ExtUtils::MakeMaker for building statically
  146. linked perl binaries.  In most cases people have reported better 
  147. results with GNU make rather than the system's /bin/make.</P>
  148. <P>
  149. <HR>
  150. <H1><A NAME="authors">AUTHORS</A></H1>
  151. <P>David Fiander and Peter Prymmer.</P>
  152. <P>
  153. <HR>
  154. <H1><A NAME="see also">SEE ALSO</A></H1>
  155. <P><EM>INSTALL</EM>, <A HREF="../../lib/Pod/perlport.html">the perlport manpage</A>, <A HREF="../../lib/ExtUtils/MakeMaker.html">the ExtUtils::MakeMaker manpage</A>.</P>
  156. <P>
  157. <H2><A NAME="mailing list">Mailing list</A></H2>
  158. <P>The Perl Institute (http://www.perl.org/) maintains a perl-mvs 
  159. mailing list of interest to all folks building and/or
  160. using perl on EBCDIC platforms.  To subscibe, send a message of:</P>
  161. <PRE>
  162.     subscribe perl-mvs</PRE>
  163. <P>to <A HREF="mailto:majordomo@perl.org.">majordomo@perl.org.</A></P>
  164. <P>
  165. <HR>
  166. <H1><A NAME="history">HISTORY</A></H1>
  167. <P>This document was originally written by David Fiander for the 5.005
  168. release of Perl.</P>
  169. <P>This document was podified for the 5.005_03 release of perl 11 March 1999.</P>
  170. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  171. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  172. <STRONG><P CLASS=block> README.os390 - building and installing Perl for OS/390.</P></STRONG>
  173. </TD></TR>
  174. </TABLE>
  175.  
  176. </BODY>
  177.  
  178. </HTML>
  179.