mccreedy 2002/12/17 16:20:03
Modified: htdocs/manual install-tpf.html readme-tpf.html
Log:
Additional information for Apache users on TPF.
Revision Changes Path
1.20 +55 -45 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.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- install-tpf.html 27 Sep 2002 22:17:49 -0000 1.19
+++ install-tpf.html 18 Dec 2002 00:20:03 -0000 1.20
@@ -418,6 +418,18 @@
</li>
<li>
+ Edit include/ap_config.h if you want to use the <tt>sigaction()</tt>
function.<br />
+
+ <p>The <tt>sigaction()</tt> function supersedes the
<tt>signal()</tt> interface and should be used in preference.
+ This function was implemented with APAR PJ26188 which shipped with
PUT10.</p>
+
+ <p>To use <tt>sigaction()</tt> remove <tt>#define
NO_USE_SIGACTION</tt> in the TPF section of ap_config.h.</p>
+
+ <p>The change will only take effect after Apache is (re)compiled.</p>
+
+ </li>
+
+ <li>
Edit include/ap_config.h if you do <em>not</em> want the
scoreboard kept in shared memory.<br />
@@ -427,22 +439,16 @@
maintaining the scoreboard (which holds current Apache
children status). The default behavior for Apache on TPF is
to use shared memory. This reduces file activity for the
- parent Apache ECB and improves performance. If you are on a
- pre-PUT10 system you must change ap_config.h to use either
- system heap or the file system.</p>
- To use system heap for the scoreboard replace
- <tt>#define USE_SHMGET_SCOREBOARD</tt> with
- <tt>#define USE_TPF_SCOREBOARD</tt> in the TPF section
- of ap_config.h.<br />
- <br />
- If you prefer instead to use the file system, remove both
- <tt>#define USE_SHMGET_SCOREBOARD</tt> and
- <tt>#define USE_TPF_SCOREBOARD</tt> from the TPF
- section of ap_config.h<br />
- <br />
- The change will only take effect after Apache is
- (re)compiled.<br />
-
+ parent Apache ECB and improves performance.</p>
+
+ <p>If you are on a pre-PUT10 system, or for some reason
+ you do not want to use shared memory for the scoreboard,
+ you must remove
"<tt>#define USE_SHMGET_SCOREBOARD</tt>" from the TPF
+ section of ap_config.h</p>
+
+ <p>The change will only take effect after Apache is
+ (re)compiled.</p>
+
</li>
<li>
@@ -456,16 +462,20 @@
<ul>
<li>
- The following compilation warning is expected and can
- be ignored:<br />
+ The following two compilation warnings may or may not occur.
+ They should be ignored:<br />
<br />
-
-
util_uri.c: <tt>Function argument
assignment between types "unsigned char*" and "const
unsigned char*" is not allowed.</tt>
<br />
<br />
+ main/http_main.c:
+ <tt>Infinite loop detected in function child_main.
+ Program may not stop.</tt>
+ <br />
+ <br />
+
</li>
<li>If during compilation you get a warning about a
@@ -533,6 +543,10 @@
<br />
A JCL condition code of 4 is expected since the C load
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 />
</li>
<li>Load (<tt>ZOLDR LOAD</tt>) and activate (<tt>ZOLDR
@@ -656,36 +670,32 @@
<tt><b>http://<i>xx.xx.xx.xx</i></b></tt>
(where <i>xx.xx.xx.xx</i> is your IP
address)</li>
+
</ol>
<a id="visualage" name="visualage"></a>
<center>
- <h2>Compiling with VisualAge TPF</h2>
+ <h2>Using VisualAge TPF</h2>
</center>
- It is not required that <tt>make</tt> be used to compile Apache
- for TPF: Individual programs may be compiled using IBM's
- VisualAge TPF product. This is particularly useful when
- compiling selected programs for the Debug Tool.
-
- <p>The following VisualAge compile settings are required:</p>
-
- <ul>
- <li><i>"DEFINE - Define preprocessor macro name(s)"</i> must
- include <b><tt>TPF, CHARSET_EBCDIC, _POSIX_SOURCE,</tt></b>
- and <b><tt>USE_HSREGEX</tt></b>
- </li>
-
- <li><i>"LSEARCH - Path for user include files"</i> must
- include <b><tt>../src/include</tt></b> and
- <b><tt>../src/os/tpf</tt></b>
- </li>
-
- <li><i>"DLL - Generate DLL code"</i> must be checked
- </li>
-
- <li><i>"LONGNAME - Support long names"</i> must be checked
- </li>
- </ul>
+ VisualAge TPF can be used to generate link maps for Apache:
+ <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 VisualAge TPF create a container with your modified dlm file as
its sole contents.
+ </li>
+ <li>Right click on the dlm file in your new container and choose "Build
DLM".
+ </li>
+ </ol>
<hr />
<center>
1.15 +4 -1 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.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- readme-tpf.html 27 Sep 2002 22:17:50 -0000 1.14
+++ readme-tpf.html 18 Dec 2002 00:20:03 -0000 1.15
@@ -51,6 +51,9 @@
"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 />
+
+ <p>Apache on TPF does not support listening on multiple ports.</p>
+
<a id="whats_available" name="whats_available"></a>
<center>
@@ -114,7 +117,7 @@
<li>mod_access.c <em>(Use of mod_access directives
"<tt>allow from</tt>" & "<tt>deny from</tt>"
- with host <u>names</u> (verses ip addresses) requires
+ with host <u>names</u> (versus ip addresses) requires
PUT10) </em></li>
<li>mod_actions.c </li>
