[Version 5.0.2]JavaServer Pages attribute assembly settings

Use the JavaServer Pages (JSP) attributes page to set JSP attributes that are used by servlets that implement JSP processing behavior.

To view this page in the Application Assembly Tool, click

Web Modules > component_instance > Assembly Property Extensions 

[Version 5.0.2]Or use the Assembling applications with the Assembly Toolkit to set the JavaServer Pages attribute assembly settings.

JSP Attribute (Name)
Specifies the name of an attribute.
Data type String
JSP Attribute (Value)
Specifies the value of an attribute.
Data type String
Supported JSP attributes
The WebSphere JSP container supports the following JSP attributes:
classdebuginfo
Indicates the compiler should include debugging information in the generated class file.
classdebuginfo true or false

Default is false.

classpath
Specifies an additional classpath for compiling the generated servlets.
classpath classpath or null

Default is null.

deprecation
Indicates the compiler should generate deprecation warnings when compiling the generated Java source.
deprecation true or false

Default is false.

disableJspRuntimeCompilation
Indicates the runtime behavior of the JSP compiler. If this option is set to true, the JSP compiler does not compile or translate the JSP files, and the JSP engine only loads precompiled classfiles.
disableJspRuntimeCompilation true or false

Default is false.

ieClassID
Indicates the Java plugin COM class ID for Internet Explorer. The <jsp:plugin> tags use this value.
ieClassID classid

Default is clsid:8AD9C840-044E-11D1-B3E9-00805F499D93.

javaEncoding
Indicates the Java platform encoding to use to generate the JSP page servlet.
javaEncoding encoding value

Default is UTF-8.

jspCompilerPath
Indicates the path of the compiler to use for compiling JSP pages.
jspCompilerPath path name or null

Default is null.

keepgenerated
Indicates the Java files generated by the JSP compiler during the translation phase of the processing should be kept.
keepgenerated true or false

Default is false.

largefile
Specifies support for large files. When the Java code is generated, the HTML data in a JSP file is stored separately instead of being saved as constant string data in the generated servlet.
largefile true or false

Default is false.

mappedfile
Indicates the compiler should generate Java source that includes a print statement for every line in the JSP file. Use this option for debugging purposes only. It is not recommended for production environments because the mappedfile option generates too many out.print() statements.
mappedfile true or false

Default is false.

Reload Enabled
Specifies whether to enable class reloading when application files are updated.

JavaServer pages (JSP) files, a Web container reloads a Web module only when the IBM extension reloadingEnabled in the ibm-web-ext.xmi file is set to true. You can set reloadingEnabled to true when editing your Web module's extended deployment descriptors in an assembly tool.

To enable reloading of a Web module, where you also want reloading of EJB and non-Web modules enabled:

  1. Set the IBM extension reloadingEnabled in the ibm-web-ext.xmi file to true.
  2. Set this Reload Enabled property to true.
  3. Set the Reload Interval property to a value greater than zero (for example, 1 to 2147483647).

To enable reloading of a Web module only, and not enable reloading of EJB or non-Web modules:

  1. Set the IBM extension reloadingEnabled in the ibm-web-ext.xmi file to true.
  2. Set the IBM extension reload interval attribute in the ibm-web-ext.xmi file to a value greater than zero (for example, 1 to 2147483647).
  3. Set this Reload Enabled property to false.

To disable reloading of a Web module, set the IBM extension reloadingEnabled in the ibm-web-ext.xmi file to false. Or, if the Web module has the IBM extension reloadingEnabled in the ibm-web-ext.xmi file set to true, to disable reloading using the administrative console:

  1. Set this Reload Enabled property to true.
  2. Set the Reload Interval property to zero (0).
Data type Boolean
Default false
Reload Interval
Specifies the number of seconds to scan the application's file system for updated files. The default is the value of the reload interval attribute in the IBM extension (META-INF/ibm-application-ext.xmi) file of the EAR file.

To enable reloading, specify a value greater than zero (for example, 1 to 2147483647). To disable reloading, specify zero (0).

The reload interval specified here overrides the value specified in the IBM extensions for each non-Web module in the EAR file (which in turn overrides the reload interval specified in the IBM extensions for the application in the EAR file). The reload interval attribute takes effect only if class reloading is enabled.

The range is from 0 to 2147483647. The default is 1 second.

Data type Integer
Units Seconds
scratchdir
Specifies the directory where the generated classfiles are created.
scratchdir directory name.

Default is [WAS_INSTALL_ROOT]/temp.

Note: The system property com.ibm.websphere.servlet.temp.dir can be used to set the scratchdir option on a server-wide basis. This setting, if it is present, overrides the system property.

usePageTagPool
Enables or disables the reuse of custom tag handlers on an individual JavaServer Page basis.
usePageTagPool true or false

Default is false.

Note: Enabling custom tag handler reuse might reveal problems in your tag handler code regarding the tags ability to be reused. A custom tag handler should always do two things:

  1. The release() method of the tag handler should reset its state and release any private resources that it might have used. The JSP engine guarantees the release() method will be called before the tag handler is garbage collected.
  2. In the doEndTag() method, all instance states associated with this instance must be reset.
useThreadTagPool
Enables or disables the reuse of custom tag handlers on a per request thread basis.
useThreadTagPool true or false

Default is false.

The note in the usePageTagPool attribute description also applies to theuseThreadTagPool attribute.

verbose
Indicates the compiler should generate verbose output when compiling the generated Java source code.
verbose true or false

Default is false.


Related concepts
JavaServer Pages files
Related reference
Assembly property extensions
Disabling JavaServer Pages run-time compilation[Version 5.0.1 and later]
Web applications: Resources for learning



Searchable topic ID:   uweb_rjatt
Last updated: Jun 21, 2007 9:56:50 PM CDT    WebSphere Application Server for z/OS, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.websphere.zseries.doc/info/zseries/ae/uweb_rjatt.html

Library | Support | Terms of Use | Feedback