ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzaie_5.4.0.1/rzaieremoved_directives.htm

213 lines
13 KiB
HTML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="topic" />
<meta name="DC.Title" content="Directives no longer supported on HTTP Server (powered by Apache)" />
<meta name="abstract" content="This topic provides information about what directives are no longer supported by HTTP Server (powered by Apache)." />
<meta name="description" content="This topic provides information about what directives are no longer supported by HTTP Server (powered by Apache)." />
<meta name="copyright" content="(C) Copyright IBM Corporation 2002,2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2002,2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzaieremoved_directives" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>Directives no longer supported on HTTP Server (powered by Apache)</title>
</head>
<body id="rzaieremoved_directives"><a name="rzaieremoved_directives"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<!--Java sync-link--><h1 class="topictitle1">Directives no longer supported on HTTP Server (powered by Apache)</h1>
<div><p>This topic provides information about what directives are no longer
supported by HTTP Server (powered by Apache).</p>
<div class="important"><span class="importanttitle">Important:</span> Information
for this topic supports the latest PTF levels for HTTP Server for i5/OS .
It is recommended that you install the latest PTFs to upgrade to the latest
level of the HTTP Server for i5/OS. Some of the topics documented here are
not available prior to this update. See <a href="http://www-03.ibm.com/servers/eserver/iseries/software/http/services/service.html" target="_blank">http://www.ibm.com/servers/eserver/iseries/software/http/services/service.htm</a> <img src="www.gif" alt="Link outside Information Center" /> for more information. </div>
<p>The following directives are no longer supported on HTTP Server (powered
by Apache). </p>
<p><strong>Directives</strong></p>
<ul><li><a href="#addmodule">AddModule</a></li>
<li><a href="#clearmodulelist">ClearModuleList</a></li>
<li><a href="#iconpath">IconPath</a></li>
<li><a href="#port">Port</a></li>
</ul>
</div>
<div class="hr" id="addmodule"><a name="addmodule"><!-- --></a><h2 class="topictitle2">AddModule</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: core</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: AddModule <em>module [module ...] </em></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: none</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="addmodule__addmodule_context"><a name="addmodule__addmodule_context"><!-- --></a>server config</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="addmodule__addmodule_origin"><a name="addmodule__addmodule_origin"><!-- --></a>Apache</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: AddModule mod_cgi </td>
</tr>
</tbody>
</table>
</div>
<p>The AddModule directive allows the server to activate specific modules
in the server after a ClearModuleList has been performed. The server comes
with a pre-loaded list of active modules. Only those modules are valid.
A list of valid modules can be obtained using the '-l' option on the command
line. The example above would activate the module mod_cgi. If this module
is already active then the directive will be ignored. </p>
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>module </em></dt>
<dd><ul><li><em>Module</em> is any valid module in the pre-loaded list that came with
the HTTP Server.</li>
</ul>
</dd>
</dl>
<p>See also <a href="#clearmodulelist">ClearModuleList</a>.</p>
</div>
</div>
<div class="hr" id="clearmodulelist"><a name="clearmodulelist"><!-- --></a><h2 class="topictitle2">ClearModuleList</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: core</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: ClearModuleList</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: none</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="clearmodulelist__clearmodulelist_context"><a name="clearmodulelist__clearmodulelist_context"><!-- --></a>server
config</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="clearmodulelist__clearmodulelist_origin"><a name="clearmodulelist__clearmodulelist_origin"><!-- --></a>Apache</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: ClearModuleList</td>
</tr>
</tbody>
</table>
</div>
<p>The ClearModuleList directive will clear the built-in list of active modules
provided by the server. To reactivate this module list use the <a href="#addmodule">AddModule</a> directive.
</p>
</div>
</div>
<div class="hr" id="iconpath"><a name="iconpath"><!-- --></a><h2 class="topictitle2">IconPath</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_auto_index</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: IconPath</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: IconPath /icons</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="iconpath__iconpath_context"><a name="iconpath__iconpath_context"><!-- --></a>server config,
virtual host, directory, .htaccess</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="iconpath__iconpath_origin"><a name="iconpath__iconpath_origin"><!-- --></a>iSeries™</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: IconPath /myicons/small/ </td>
</tr>
</tbody>
</table>
</div>
<p>The IconPath directive to specify URL information to be added at the beginning
of each icon-URL specified on the following directives: </p>
<ul><li>AddIcon </li>
<li>AddIconByType </li>
<li>AddIconByEncoding </li>
<li>DefaultIcon </li>
</ul>
<p>The value that you specify on this directive is added to the icon-URL value
on each of the other directives to form the full request URL for each icon.
The following path and directory is the default location for icons: </p>
<pre class="block">/QIBM/ProdData/HTTPA/icons</pre>
<p><strong>Special Usage Considerations</strong>: </p>
<ul><li>You must enable your server for serving the icons from the default location
by adding the following statement to your configuration: <pre>Alias /icons /QIBM/ProdData/HTTPA/icons</pre>
</li>
<li>You must use this directive in your configuration before any of the other
icon directives that are to use the path (DefaultIcon, AddIcon, AddIconByType,
and AddIconByEncoding).</li>
</ul>
<p>For example, a configuration containing: </p>
<pre class="block">Alias /icons/small /QIBM/ProdData/HTTPA/icons/small
IconPath /icons/small/
AddIcon blank.gif ^^BLANKICON^^</pre>
<p>This causes the server to generate a request for the directory list icon
as /icons/small/blank.gif. The server uses the alias directive to resolve
the request to the proper file. This is different from Apache than on other
platforms. </p>
<p>On another platform you would use: </p>
<pre class="block">Alias /icons /full/icon/path
AddIcon /icons/blank.gif ^^BLANKICON^^</pre>
<p>IconPath is an iSeries specific directive for Apache; therefore,
precautions must be taken if the Apache configuration file is modified manually.
On the iSeries, you would use: </p>
<pre class="block">Alias /icons /QIBM/ProdData/HTTPA/icons
AddIcon blank.gif ^^BLANKICON^^</pre>
<p>Since IconPath is set to /icons/ by default, it will be prepended to 'blank.gif'
when the AddIcon directive is used. </p>
</div>
</div>
<div class="hr" id="port"><a name="port"><!-- --></a><h2 class="topictitle2">Port</h2>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: core</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: Port <em>number</em></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: Port 80</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="port__port_context"><a name="port__port_context"><!-- --></a>server config</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="port__port_origin"><a name="port__port_origin"><!-- --></a>Apache</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: Port 8080</td>
</tr>
</tbody>
</table>
</div>
<p>The Port directive has two behaviors:</p>
<ul><li>In the absence of any Listen directives specifying a port number, a Port
directive given in the "main server" (for example, outside any &lt;VirtualHost&gt;
section) sets the network port on which the server listens. If there are any
Listen directives specifying the port number then Port has no effect on what
address the server listens at. The use of the Listen directive causes all
Port directives to be ignored. </li>
<li>The Port directive sets the SERVER_PORT environment variable (for CGI
and SSI), and is used when the server must generate a URL that refers to itself
(for example when creating an external redirect to itself). This behavior
is modified by UseCanonicalName. </li>
</ul>
<p>In no event does a Port setting affect what ports a VirtualHost responds
on, the VirtualHost directive itself is used for that. The primary behavior
of Port should be considered to be similar to that of the ServerName directive.
The ServerName and Port together specify what you consider to be the <em>canonical</em> address
of the server. (See also UseCanonicalName.)</p>
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>number </em></dt>
<dd><ul><li>Where <em>number</em> is a number from 0 to 65535; some port number (especially
below 1024) are reserved for particular protocols. The standard port for http
protocol is 80.</li>
</ul>
</dd>
</dl>
<div class="note"><span class="notetitle">Note:</span> The <a href="rzaiemod_core.htm#listen">Listen</a> directive
is used as an alterative to Port.</div>
</div>
</div>
</body>
</html>