Set JSF engine parameters

WAS does not support the modification of deployment descriptor extension parameters through the admin console or through admin scripting.

To add, change or delete JSF engine configuration parameters...

 

1. Open the WEB-INF/web.xml file.

   JSP engine configuration parameters are stored in a Web module's configuration directory or in a Web modules's binaries directory in the WEB-INF/web.xml file. Open the WEB-INF/web.xml file from:

   • The configuration directory, as in the following example: {WAS_ROOT}/profiles/profilename/config/cells/cellname/applications/enterpriseappname/ deployments/deployedname/webmodulename

   • The binaries directory if an application was deployed into WAS with the flag "Use Binary Configuration" set to true. An example of a binaries directory is: {WAS_ROOT}/profiles/profilename/installedApps/nodename/EnterpriseAppName/WebModuleName/

2. Edit the WEB-INF/web.xml file.

   • To add configuration parameters, use the following format:

     <context-param>
         <description>descriptive text</description>
         <param-name>parameter name</param-name>
         <param-value>parameter value</param-value>
     </context-param>
     

   • To delete configuration parameters, either delete the line from the file, or enclose the statement with <!-- --> tags.

3. Save the file.

4. Restart the Enterprise Application. It is not necessary to restart the server for parameter changes to take effect. However, some JSP engine configuration parameters affect the Java source code that is generated for a JSP. If such a parameter is changed, then retranslate the JSP files in the Web module to regenerate Java source. Use the batch compiler to retranslate all JSPs in a Web module. The batch compiler uses the JSP engine configuration parameters that we have set in web.xml, unless you specifically override them. The topic JSP engine configuration parameters" identifies the parameters that affect the generated Java source.

 

Example

The following is a sample of the WEB-INF/web.xml file. The lines in bold text are JSP engine configuration parameters.

<?xml version="1.0" encoding="UTF-8"?>
<webappext:WebAppExtension xmi:version="2.0" 
    xmlns:xmi=http://www.omg.org/XMI
   
    xmlns:webappext="webappext.xmi" 
    xmlns:webapplication="webapplication.xmi" xmi:id="WebAppExtension_1"   
   reloadInterval="9" reloadingEnabled="true" defaultErrorPage="error.jsp" additionalClassPath="" 
   fileServingEnabled="true" directoryBrowsingEnabled="false" serveServletsByClassnameEnabled="true" 
   autoRequestEncoding="true" autoResponseEncoding="false"
   <webApp href="WEB-INF/web.xml#WebApp_1"/>
   <jspAttributes xmi:id="JSPAttribute_1" name="useThreadTagPool" value="true"/>
   <jspAttributes xmi:id="JSPAttribute_2" name="verbose" value="false"/>
   <jspAttributes xmi:id="JSPAttribute_3" name="deprecation" value="false"/>
   <jspAttributes xmi:id="JSPAttribute_4" name="reloadEnabled" value="true"/>
   <jspAttributes xmi:id="JSPAttribute_5" name="reloadInterval" value="5"/>
   <jspAttributes xmi:id="JSPAttribute_6" name="keepgenerated" value="true"/>
   <!--<jspAttributes xmi:id="JSPAttribute_7" name="trackDependencies" value="true"/> -->
   
</webappext:WebAppExtension>

JSF engine configuration parameters

 

Related concepts

Java Server Faces

 

Related tasks

Set Java Server Faces implementation
Manage Java Server Faces implementations using scripting