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

150 lines
9.1 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="Module mod_env" />
<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="rzaiemod_env" />
<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>Module mod_env</title>
</head>
<body id="rzaiemod_env"><a name="rzaiemod_env"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<!--Java sync-link--><h1 class="topictitle1">Module mod_env</h1>
<div><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><strong>Summary</strong></p>
<p>This module allows the HTTP Server CGI and SSI environment to inherit environment
variables.</p>
<p><strong>Directives</strong></p>
<ul><li><a href="#passenv">PassEnv</a></li>
<li><a href="#setenv">SetEnv</a></li>
<li><a href="#unsetenv">UnsetEnv</a></li>
</ul>
</div>
<div class="hr" id="passenv"><a name="passenv"><!-- --></a><h2 class="topictitle2">PassEnv</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_env </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: PassEnv <em>variable [variable ...] </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="passenv__passenv_context"><a name="passenv__passenv_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="passenv__passenv_origin"><a name="passenv__passenv_origin"><!-- --></a>Apache </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: PassEnv LD_LIBRARY_PATH </td>
</tr>
</tbody>
</table>
</div>
<p>The PassEnv directive specifies one or more environment variables to pass
to the CGI scripts. The variables originate from the server's own environment.
See <a href="rzaieenvvar.htm">Environment variables on HTTP Server</a> for more information.</p>
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>variable </em></dt>
<dd><ul><li>The <em>variable</em> parameter is any valid environment variable. </li>
</ul>
</dd>
</dl>
</div>
</div>
<div class="hr" id="setenv"><a name="setenv"><!-- --></a><h2 class="topictitle2">SetEnv</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_env </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: SetEnv <em>variable [value]</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="setenv__setenv_context"><a name="setenv__setenv_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>: FileInfo</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="setenv__setenv_origin"><a name="setenv__setenv_origin"><!-- --></a>Apache</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Examples</a></strong>: <ul><li>SetEnv SPECIAL_PATH /QIBM/bin </li>
<li>SetEnv QIBM_CGI_LIBRARY_LIST "MIME;CGIURL;CGILIBL"</li>
</ul>
</td>
</tr>
</tbody>
</table>
</div>
<p>The SetEnv directive allows you to set an environment variable that is
passed on to CGI scripts. See <a href="rzaieenvvar.htm">Environment variables on HTTP Server</a> for
more information.</p>
<dl class="block"><dt class="dlterm"><strong>Parameter One</strong>: <em>variable </em></dt>
<dd><ul><li>The <em>variable</em> parameter is any valid EBCDIC characters except the
equal sign (=), the null-terminator (X'00') and blank (X'40'). The name must
be enclosed in quotation marks if it contains any non-alphanumeric character. </li>
</ul>
</dd>
</dl>
<dl class="block"><dt class="dlterm"><strong>Parameter Two</strong>: <em>[value] </em></dt>
<dd><ul><li>The <em>[value]</em> parameter is optional and can include partial URLs.
The case is preserved when lowercase characters are specified. Valid values
include all EBCDIC characters. The value must be enclosed in quotation marks
if it contains any non-alphanumeric character or blanks. Lowercase characters
for the library names will not work if this directive is used to change the
library list. When changing the library list values, the libraries need to
be separated by a semicolon. </li>
</ul>
</dd>
</dl>
</div>
</div>
<div class="hr" id="unsetenv"><a name="unsetenv"><!-- --></a><h2 class="topictitle2">UnsetEnv</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_env </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: UnsetEnv <em>variable [variable ...] </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="unsetenv__unsetenv_context"><a name="unsetenv__unsetenv_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="unsetenv__unsetenv_origin"><a name="unsetenv__unsetenv_origin"><!-- --></a>Apache </span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: UnsetEnv LD_LIBRARY_PATH </td>
</tr>
</tbody>
</table>
</div>
<p>The UnsetEnv directive removes one or more environment variables from those
passed on to CGI scripts. See <a href="rzaieenvvar.htm">Environment variables on HTTP Server</a> for
more information.</p>
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>variable </em></dt>
<dd><ul><li>The <em>variable</em> parameter is any valid environment variable. </li>
</ul>
</dd>
</dl>
</div>
</div>
</body>
</html>