httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mccre...@apache.org
Subject cvs commit: httpd-docs-1.3/htdocs/manual install-tpf.html readme-tpf.html
Date Thu, 01 Jul 2004 19:48:18 GMT
mccreedy    2004/07/01 12:48:18

  Modified:    htdocs/manual install-tpf.html readme-tpf.html
  Log:
  Minor changes to TPF-specific docs: httpd-docs-1.3/htdocs/manual/install-tpf.html and readme-tpf.html
  
  Revision  Changes    Path
  1.23      +64 -7     httpd-docs-1.3/htdocs/manual/install-tpf.html
  
  Index: install-tpf.html
  ===================================================================
  RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/install-tpf.html,v
  retrieving revision 1.22
  retrieving revision 1.23
  diff -u -r1.22 -r1.23
  --- install-tpf.html	21 Aug 2003 03:07:29 -0000	1.22
  +++ install-tpf.html	1 Jul 2004 19:48:18 -0000	1.23
  @@ -21,7 +21,7 @@
         [ <a href="#download">Download</a>
         | <a href="#compilation">Compilation</a>
         | <a href="#installation">Installation</a>
  -      | <a href="#visualage">VisualAge</a>&nbsp;]
  +      | <a href="#linkmap">Link Map</a>&nbsp;]
       </center>
       <hr />
   
  @@ -539,8 +539,7 @@
         module will contain no link map data.<br />
   
          If you require a link map refer to the
  -       <a href="#visualage">instructions below</a> on
  -       creating one with VisualAge TPF.<br />
  +       <a href="#linkmap">instructions below</a><br />
          &nbsp;</li>
   
         <li>Load (<tt>ZOLDR LOAD</tt>) and activate (<tt>ZOLDR
  @@ -663,12 +662,70 @@
         &nbsp;&nbsp;&nbsp;(where <i>xx.xx.xx.xx</i> is your IP
         address)</li>
       </ol>
  -    <a id="visualage" name="visualage"></a> 
  +    <a id="linkmap" name="linkmap"></a> 
   
       <center>
  -      <h2>Using VisualAge TPF</h2>
  +      <h2>Generating an Apache Link Map</h2>
       </center>
  -    VisualAge TPF can be used to generate link maps for Apache:
  +    <p>Three different tools can be used to generate a link map for Apache:
  +    TPF Build Tools, TPF Toolkit, and VisualAge TPF.</p>
  +
  +    <h3>TPF Build Tools on OS/390 UNIX</h3>
  +    
  +    <ol>
  +       <li>Download and install the 
  +           <a href="http://www.ibm.com/software/htp/tpf/download/bldtools.htm">TPF
Build Tools</a> 
  +	   if you have not already done so.</li>
  +       <li>Follow the instructions to set up any necessary variables for your installation.</li>
  +       <li>Create a shell script in your Apache <code>src</code> directory
similar to this text:<br />
  +           <code><br />
  +           ld -M --dlm -O'&lt;your-dsd-dsn&gt;(CHTA&lt;vv&gt;)' \<br
/>
  +           CSTRTD40 \<br />
  +           CINET640 \<br />
  +           buildmark.o \<br />
  +           modules.o \<br />
  +           ap/ap_base64.o \<br />
  +           .<br />
  +           .<br />
  +           .<br />
  +           regex/regexec.o \<br />
  +           regex/regfree.o<br />
  +           </code><br />
  +           In your script...
  +           <ul>
  +              <li>Each line must end with a backwards slash (\) except for the last
line.
  +                  Be sure there are no trailing blanks after the backward slashes. </li>
  +              <li>Replace the two items in angle brackets (&lt; &gt;) with
your dataset name and program version.</li>
  +              <li>Add any additional libraries prior to the first ".o" line.</li>
  +              <li>Add a line for each .o to be linked into your configuration of
Apache.</li>
  +           </ul><br />
  +       </li>
  +       <li>Change the shell script's permission settings to executable using the
<code>chmod</code> command.</li>
  +       <li>Run the script.</li>
  +    </ol>
  +
  +
  +    <h3>TPF Toolkit</h3>
  +    <ol>
  +    <li>Copy the sample <tt>linkhttp.dlm</tt> file from the <tt>src/os/tpf/samples</tt>
  +        directory to your Apache <tt>src</tt> directory on OS/390 UNIX.
  +    </li>
  +    <li>This sample file contains the components for the default
  +        configuration of Apache.  Add and delete components (such as modules)
  +        as necessary so it matches your configuration of Apache.
  +        Basically, it should match your link JCL with the "<tt>.../apache/src</tt>"
  +        portion of the filenames removed.
  +    </li>
  +    <li>Change items in angle brackets (&lt; &gt;) to also match your JCL.
  +        Be sure to remove the angle brackets as well.
  +    </li>
  +    <li>In the TPF Toolkit create a project with your modified dlm file as its sole
contents.
  +    </li>
  +    <li>Right click on the dlm file in your new project and choose "Build DLM".
  +    </li>
  +    </ol>
  +
  +    <h3>VisualAge TPF</h3>
       <ol>
       <li>Copy the sample <tt>linkhttp.dlm</tt> file from the <tt>src/os/tpf/samples</tt>
           directory to your Apache <tt>src</tt> directory on OS/390 UNIX.
  @@ -694,7 +751,7 @@
         | <a href="#download">Download</a>
         | <a href="#compilation">Compilation</a>
         | <a href="#installation">Installation</a>
  -      | <a href="#visualage">VisualAge</a>&nbsp;]
  +      | <a href="#linkmap">Link Map</a>&nbsp;]
       </center>
     </body>
   </html>
  
  
  
  1.16      +29 -6     httpd-docs-1.3/htdocs/manual/readme-tpf.html
  
  Index: readme-tpf.html
  ===================================================================
  RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/readme-tpf.html,v
  retrieving revision 1.15
  retrieving revision 1.16
  diff -u -r1.15 -r1.16
  --- readme-tpf.html	18 Dec 2002 00:20:03 -0000	1.15
  +++ readme-tpf.html	1 Jul 2004 19:48:18 -0000	1.16
  @@ -37,20 +37,43 @@
       step-by-step installation instructions.&nbsp;</p>
   
       <p>This port builds upon the <a
  -    href="http://httpd.apache.org/docs/ebcdic.html">EBCDIC
  -    changes</a> previously made to Apache.&nbsp;<br />
  +    href="http://httpd.apache.org/docs/ebcdic.html">EBCDIC changes</a>
  +    previously made to Apache.&nbsp;<br />
        <a id="configuration_files"
       name="configuration_files"></a></p>
   
  +    <p>If you would like to be notified when new versions of Apache 
  +    are released consider joining the 
  +    <a href="http://httpd.apache.org/lists.html">announcements list</a>.
  +    </p>
  +
       <center>
         <h2>Apache Configuration Files</h2>
       </center>
  -    The distributed configuration files (httpd.conf-dist and
  -    mime.types, both located in the conf subdirectory) work on TPF.
  -    Performance considerations may dictate setting KeepAlive to
  +    <p>The distributed configuration files (httpd.conf-dist and
  +    mime.types, both located in the conf subdirectory) work on TPF
  +    with the following caveats:</p>
  +    <ul>
  +
  +    <li>Apache on TPF does not support listening on multiple ports.</li>
  +
  +    <li>Performance considerations may dictate setting KeepAlive to
       "Off" (the default is "On") or lowering the Timeout value from
       the default 300 seconds (5 minutes) in order to reduce the
  -    number of active ECBs on your system.<br />
  +    number of active ECBs on your system.</li>
  +
  +    <li>The default value of MaxRequestsPerChild is zero (infinity).
  +    A non-zero value is recommended on TPF to control resource
  +    utilization (such as heap storage) by the long running Apache
  +    child ECBs.</li>
  +
  +    <li>Unlike on Unix systems, newly created Apache child processes
  +    on TPF re-read the various configuration files (such as httpd.conf
  +    and mime.types).  Be sure to stop and restart Apache after changing 
  +    configuration files so that the Apache parent process and all child 
  +    processes are in sync.</li>
  +
  +    </ul>
   
       <p>Apache on TPF does not support listening on multiple ports.</p>
   
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


Mime
View raw message