You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by mc...@apache.org on 2004/07/01 21:48:18 UTC
cvs commit: httpd-docs-1.3/htdocs/manual install-tpf.html readme-tpf.html
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> ]
+ | <a href="#linkmap">Link Map</a> ]
</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 />
</li>
<li>Load (<tt>ZOLDR LOAD</tt>) and activate (<tt>ZOLDR
@@ -663,12 +662,70 @@
(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'<your-dsd-dsn>(CHTA<vv>)' \<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 (< >) 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 (< >) 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> ]
+ | <a href="#linkmap">Link Map</a> ]
</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. </p>
<p>This port builds upon the <a
- href="http://httpd.apache.org/docs/ebcdic.html">EBCDIC
- changes</a> previously made to Apache. <br />
+ href="http://httpd.apache.org/docs/ebcdic.html">EBCDIC changes</a>
+ previously made to Apache. <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>