Module mod_ibm_si

Important: 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 http://www.ibm.com/servers/eserver/iseries/software/http/services/service.htm Link outside Information Center for more information.

Summary

The module mod_ibm_si specifies behavior between associated HTTP Server (powered by Apache) servers and WebSphere® Application Servers.

Directives

AppServer

Module: mod_ibm_si
Syntax: AppServer server_name [*ALL start | nostart ] [end | noend ]
Default: none
Context: server config
Override: none
Origin: iSeries™
Usage Considerations: 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
Example: AppServer ITD start end
Example: AppServer ADMIN start noend
Example: AppServer NODO nostart noend

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.

Note: For duplicate names, the last one is specified and used by the server configuration.
Parameter One: server_name
  • The server_name parameter value specifies the HTTP Server (powered by Apache) to be associated with the application server.
Parameter Two: *ALL
  • The *ALL parameter specifies that this directive applies to all application servers associated with the instance named on the WASInstance directive. For example, AppServer *ALL start end
Parameter Three: start | nostart |
  • The start parameter value specifies the application server to start when the associated HTTP Server (powered by Apache) starts.
  • The nostart parameter value specifies the application server to not start when the associated HTTP Server (powered by Apache) starts.
Parameter Four: end | noend
  • The end parameter value specifies the application server to end when the associated HTTP Server (powered by Apache) ends.
  • The noend parameter value specifies the application server to not end when the associated HTTP Server (powered by Apache) ends.

WASInstance

Module: mod_ibm_si
Syntax: WASInstance name ProductID ProductID_option
Default: none
Context: server config
Override: none
Origin: iSeries
Usage Considerations: 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
Example: WASInstance SYSINST 5722XXX 2
Example: WASInstance ITD 5722IWE 2
Example: WASInstance DEF 5733WS5 2
Example : WASInstance ITD 5722E51 2

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 instance directive.

Parameter One: name
  • The name parameter value is the name of the application server. Mixed case is allowed.
Parameter Two: ProductID
  • The ProductId parameter value specifies the product. Valid values include:
    • 5722IWE
    • 5722WS5
    • 5722E51
    • 5733W51
    • 5733W60
    • 5722XXX (intended for system instance application server, SYSINST)
Parameter Three: ProductID_option
  • The ProductID_options parameter value specifies any valid product options. The option number is a number from 0 to 99 where 0 is *BASE. Valid values include:
    • 2 for ProductID parameter value 5722IWE (WebSphere Application Server- Express V5.0)
    • 2 for ProductID parameter value 5733WS5 (WebSphere Application Server Base and PME/WebSphere Portal/IBM Workplace™ V5.0)
    • 2 for ProductID parameter value 5722E51 (WebSphere Application Server - Express V5.1)
    • 2 for ProductID parameter value 5733W51 (WebSphere Application Server Base V5.1)
    • 1, 2, or 3 for ProductID parameter value 5733W60 (WebSphere Application Server V6.0 Express=1, Base=2, Network Deployment=3)