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

187 lines
11 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_ibm_si" />
<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_ibm_si" />
<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_ibm_si</title>
</head>
<body id="rzaiemod_ibm_si"><a name="rzaiemod_ibm_si"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<!--Java sync-link--><h1 class="topictitle1">Module mod_ibm_si</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>The module mod_ibm_si specifies behavior between associated HTTP Server
(powered by Apache) servers and WebSphere<sup>®</sup> Application Servers.</p>
<p><strong>Directives</strong></p>
<ul><li><a href="#appserver">AppServer</a></li>
<li><a href="#wasinstance">WASInstance</a></li>
</ul>
</div>
<div class="hr" id="appserver"><a name="appserver"><!-- --></a><h2 class="topictitle2">AppServer</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_ibm_si</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: AppServer <em>server_name [*ALL start | nostart
] [end | noend ]</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="appserver__appserver_context"><a name="appserver__appserver_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="appserver__appserver_origin"><a name="appserver__appserver_origin"><!-- --></a>iSeries™</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__UsageConsiderations">Usage Considerations</a></strong>: A LoadModule is required in
the configuration file prior to using the directive. The statement should
be as follows: LoadModule isi_module /QSYS.LIB/QHTTPSVR.LIB/QZISI.SRVPGM</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: AppServer ITD start end</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: AppServer ADMIN start noend</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: AppServer NODO nostart noend</td>
</tr>
</tbody>
</table>
</div>
<p>The AppServer directive is only effective if directive WASInstance declares
the WAS instance name for the application server. The AppServer directive
specifies the load module to start the application server when the HTTP Server
(powered by Apache) is started. The AppServer directive also ends the application
server when the same HTTP Server (powered by Apache) is stopped. More than
one directive is allowed but with different HTTP Server (powered by Apache)
names. </p>
<div class="note"><span class="notetitle">Note:</span> For duplicate names, the last one is specified and used by the server
configuration.</div>
<blockquote><dl><dt class="dlterm"><strong>Parameter One</strong>: <em>server_name</em></dt>
<dd><ul><li>The <em>server_name</em> parameter value specifies the HTTP Server (powered
by Apache) to be associated with the application server.</li>
</ul>
</dd>
</dl>
<dl><dt class="dlterm"><strong>Parameter Two</strong>: <em>*ALL</em></dt>
<dd><ul><li>The <em>*ALL</em> parameter specifies that this directive applies to all
application servers associated with the instance named on the WASInstance
directive. For example, <samp class="codeph">AppServer *ALL start end</samp></li>
</ul>
</dd>
</dl>
<dl><dt class="dlterm"><strong>Parameter Three</strong>: <em>start | nostart | </em></dt>
<dd><ul><li>The <em>start</em> parameter value specifies the application server to start
when the associated HTTP Server (powered by Apache) starts.</li>
<li>The <em>nostart</em> parameter value specifies the application server to
not start when the associated HTTP Server (powered by Apache) starts.</li>
</ul>
</dd>
</dl>
<dl><dt class="dlterm"><strong>Parameter Four</strong>: <em>end | noend</em></dt>
<dd><ul><li>The <em>end</em> parameter value specifies the application server to end
when the associated HTTP Server (powered by Apache) ends.</li>
<li>The <em>noend</em> parameter value specifies the application server to not
end when the associated HTTP Server (powered by Apache) ends.</li>
</ul>
</dd>
</dl>
</blockquote>
</div>
</div>
<div class="hr" id="wasinstance"><a name="wasinstance"><!-- --></a><h2 class="topictitle2">WASInstance</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_ibm_si</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: WASInstance <em>name ProductID ProductID_option</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="wasinstance__wasinstance_context"><a name="wasinstance__wasinstance_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="wasinstance__wasinstance_origin"><a name="wasinstance__wasinstance_origin"><!-- --></a>iSeries</span></td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__UsageConsiderations">Usage Considerations</a></strong>: A LoadModule is required in
the configuration file prior to using the directive. The statement should
be as follows: LoadModule isi_module /QSYS.LIB/QHTTPSVR.LIB/QZISI.SRVPGM</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: WASInstance SYSINST 5722XXX 2</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: WASInstance ITD 5722IWE 2 </td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: WASInstance DEF 5733WS5 2</td>
</tr>
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong> : WASInstance ITD 5722E51 2</td>
</tr>
</tbody>
</table>
</div>
<p>The WASInstance directive specifies the application server instance its
associated product and product option for functions, other than directive,
involving application servers under the identified instance. If 5722XXX is
used, it should be for the WebSphere Application Server instance name SYSINST
to run under the HTTP Server. The directive requires an accompanying APPSERVER
ADMIN START <em>instance</em> directive.</p>
<blockquote><dl><dt class="dlterm"><strong>Parameter One</strong>: <em>name</em></dt>
<dd><ul><li>The <em>name</em> parameter value is the name of the application server.
Mixed case is allowed.</li>
</ul>
</dd>
</dl>
<dl><dt class="dlterm"><strong>Parameter Two</strong>: <em>ProductID</em></dt>
<dd><ul><li>The <em>ProductId</em> parameter value specifies the product. Valid values
include:<ul><li>5722IWE</li>
<li>5722WS5</li>
<li>5722E51</li>
<li>5733W51</li>
<li>5733W60</li>
<li>5722XXX (intended for system instance application server, SYSINST)</li>
</ul>
</li>
</ul>
</dd>
</dl>
<dl><dt class="dlterm"><strong>Parameter Three</strong>: <em>ProductID_option</em></dt>
<dd><ul><li>The <em>ProductID_options</em> parameter value specifies any valid product
options. The option number is a number from 0 to 99 where 0 is *BASE. Valid
values include:<ul><li>2 for <em>ProductID</em> parameter value 5722IWE (WebSphere Application
Server- Express V5.0)</li>
<li>2 for <em>ProductID</em> parameter value 5733WS5 (WebSphere Application
Server Base and PME/WebSphere Portal/IBM Workplace™ V5.0)</li>
<li>2 for <em>ProductID</em> parameter value 5722E51 (WebSphere Application
Server - Express V5.1)</li>
<li>2 for <em>ProductID</em> parameter value 5733W51 (WebSphere Application
Server Base V5.1)</li>
<li>1, 2, or 3 for <em>ProductID</em> parameter value 5733W60 (WebSphere Application
Server V6.0 Express=1, Base=2, Network Deployment=3)</li>
</ul>
</li>
</ul>
</dd>
</dl>
</blockquote>
</div>
</div>
</body>
</html>