2.8.20 unset-web-context-param

Synopsis

asadmin [asadmin-options] unset-web-context-param [--help]
    --name=context-param-name application-name[/module]

Storage location

Application Server installation directory/javaee/glassfish/bin

Function

The unset-web-context-param subcommand of asadmin unsets 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.

When a parameter is unset, its value reverts to the value, if any, that is set in the application's DD. This subcommand enables you to change the configuration of a deployed application without the need to modify the application's DD and repackage and redeploy the application.

This subcommand is supported in remote mode only.

Precondition

• The environment entry must already be set.

• Domain Administration Server (DAS) is running.

• The application must already be deployed.

Files

The path to the module is specified in the module element of the application's application.xml file.

Arguments

--help | -?

Displays the help text for the subcommand.

--name=context-param-name

Specifies the name of the servlet context-initialization parameter that is to be unset.

Type: String

The following values can be specified:

• Name of the variable

Default value: N/A

application-name

Specifies the name of the application.

Type: String

The following values can be specified:

• Name of the application

Default value: N/A

module

Specifies 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.

Type: String

The following values can be specified:

• Name of the application module

Default value: N/A

asadmin unset-web-context-param --name=javax.faces.STATE_SAVING_METHOD 
basic-ezcomp

Exit Status

Exit Status	Explanation
0	subcommand executed successfully.
1	error in executing the subcommand.