Name | Synopsis | Description | Options | Operands | Examples | Exit Status | See Also
set-web-context-param [--help] --name=context-param-name {--value=value|--ignoreDescriptorItem={false|true}} [--description=description] application-name[/module]
The set-web-context-param subcommand sets a servlet context-initialization parameter of one of the following items:
A deployed web application
A web module in a deployed Java Platform, Enterprise Edition (Java EE) application
The application must already be deployed. Otherwise, an error occurs.
This subcommand enables you to change the configuration of a deployed application without the need to modify the application's deployment descriptors and repackage and redeploy the application.
This subcommand is supported in remote mode only.
Displays the help text for the subcommand.
The name of the servlet context-initialization parameter that is to be set.
The value to which the servlet context-initialization parameter is to be set.
Either the --value option or the --ignoreDescriptorItem option must be set.
Specifies whether the servlet context-initialization parameter is ignored if it is set in the application's deployment descriptor. When a parameter is ignored, the application behaves as if the parameter had never been set in the application's deployment descriptor. The behavior of an application in this situation depends on the application.
The possible values are as follows:
The value is not ignored (default).
The value is ignored.
Either the --value option or the --ignoreDescriptorItem option must be set.
Do not use the --ignoreDescriptorItem option to unset a servlet context-initialization parameter that has previously been set by using the set-web-context-param subcommand. Instead, use the unset-web-context-param(1) subcommand for this purpose.
An optional textual description of the context parameter that is being set.
The name of the application. This name can be obtained from the Administration Console or by using the list-applications(1) subcommand.
The application must already be deployed. Otherwise, an error occurs.
The relative path to the module within the application's enterprise archive (EAR) file. The path to the module is specified in the module element of the application's application.xml file.
module is required only if the servlet context-initialization parameter applies to a web module of a Java EE application. If specified, module must follow application-name, separated by a slash (/).
For example, the application.xml file for the myApp application might specify the following web module:
<module> <web> <web-uri>myWebModule.war</web-uri> </web> </module>
The module would be specified as the operand of this command as myApp/myWebModule.war.
This example sets the servlet context-initialization parameter javax.faces.STATE_SAVING_METHOD of the web application basic-ezcomp to client. The description The location where the application's state is preserved is provided for this parameter.
asadmin> set-web-context-param --name=javax.faces.STATE_SAVING_METHOD --description="The location where the application's state is preserved" --value=client basic-ezcomp Command set-web-context-param executed successfully. |
This example ignores the servlet context-initialization parameter javax.faces.PROJECT_STAGE of the web application basic-ezcomp.
asadmin> set-web-context-param --name=javax.faces.PROJECT_STAGE --ignoreDescriptorItem=true basic-ezcomp Command set-web-context-param executed successfully. |
Name | Synopsis | Description | Options | Operands | Examples | Exit Status | See Also