| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Remove iSeries Access for Web (RMVACCWEB2) command is used to remove the iSeries Access for Web configuration from the web application servers:
This command will remove the configuration that was defined using the Configure Access for Web (CFGACCWEB2) command.
This command will not delete iSeries Access for Web from the server. This command will only remove the iSeries Access for Web configuration from the specified web application server.
This command will not delete user data that was generated while using iSeries Access for Web. User data was written to the following locations based on the value specified for the Web application server type (APPSVRTYPE) parameter when the configuration was defined using the CFGACCWEB2 command:
When the command runs status information will be displayed indicating what the command is processing. As the command runs, detailed status and error information will also be logged to stream file /QIBM/UserData/Access/Web2/logs/cmds.log.
The iSeries Access for Web configuration could be removed using the web application server's administration interface. This is not recommended! The RMVACCWEB2 command will clean up internal configuration information that the web application server's administration interface will not.
Restrictions:
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| APPSVRTYPE | Web application server type | Character value | Required, Positional 1 |
| WASINST | Web server instance name | Character value, *DEFAULT | Optional |
| WASPRF | Web server profile name | Character value, *DEFAULT | Optional |
| APPSVR | Application server name | Character value, *DEFAULT | Optional |
| TCSVRNAME | Tomcat server name | Character value | Optional |
| WPUSRID | WebSphere Portal user ID | Character value | Optional |
| WPPWD | WebSphere Portal password | Character value | Optional |
| WPURL | WebSphere Portal config URL | Character value | Optional |
| WPDFTPAG | WebSphere Portal default pages | *DELETE, *NODELETE | Optional |
| WASUSRID | WebSphere user ID | Character value, *NONE | Optional |
| WASPWD | WebSphere password | Character value, *NONE | Optional |
| Top |
Specifies a web application server that contains an iSeries Access for Web configuration to be removed.
This is a required parameter.
| Top |
Specifies an IBM WebSphere Application Server instance that contains an iSeries Access for Web configuration to remove.
This parameter is only applicable when the Web application server type (APPSVRTYPE) parameter is set to one of the following web application servers
When the Web application server type (APPSVRTYPE) parameter is set to *WP50, this parameter is the WebSphere instance that WebSphere Portal has been configured to run within.
| Top |
Specifies an IBM WebSphere Application Server profile that contains an iSeries Access for Web configuration to remove.
This parameter is only applicable when the Web application server type (APPSVRTYPE) parameter is set to one of the following web application servers
| Top |
Specifies the existing application server to which iSeries Access for Web has been configured and is to be removed.
A WebSphere instance/profile can contain one or more application servers. The application server provides the environment in which deployed web applications execute.
This parameter is only applicable when the Web application server type (APPSVRTYPE) parameter is set to remove iSeries Access for Web from one of the following web application servers:
The following applies when the APPSVRTYPE parameter is set to *WAS50EXP/*WAS51EXP:
| Top |
This parameter specifies the name of an Apache Software Foundation (ASF) Tomcat server that contains an iSeries Access for Web configuration to remove.
A parameter value is required when *ASFTOMCAT is specified for the Web application server type (APPSVRTYPE) parameter.
| Top |
Specifies the IBM WebSphere Portal administrative user ID that will be used to remove the iSeries Access for Web configuration in WebSphere Portal.
Changes to the WebSphere Portal configuration require a user ID be specified to make the changes. This is the same administrator level user ID that would be used to login to the WebSphere Portal user interface to perform administrator level functions.
This value is sent to the server unencrypted using an HTTP connection. If the connection could be compromised, this command should only be run within a protected intranet environment.
A parameter value is required when *WP50 is specified for the Web application server type (APPSVRTYPE) parameter.
| Top |
Specifies the password for the IBM WebSphere Portal administrative user ID specified for the WPUSRID parameter.
This value is sent to the server unencrypted using an HTTP connection. If the connection could be compromised, this command should only be run within a protected intranet environment.
A parameter value is required when *WP50 is specified for the Web application server type (APPSVRTYPE) parameter.
| Top |
Specifies the universal resource locator (URL) to access the WebSphere Portal configuration servlet. This servlet will remove the iSeries Access for Web configuration information in WebSphere Portal.
This URL is comprised of the following elements:
An example for this value would be 'server_name.your_company.com/wps/config'.
A parameter value is required when *WP50 is specified for the Web application server type (APPSVRTYPE) parameter.
| Top |
When removing the iSeries Access for Web portlets from the WebSphere Portal configuration, the default WebSphere Portal pages that may have been created using the CFGACCWEB2 command can be deleted.
| Top |
If the WebSphere application server instance/profile specified in the WASINST/WASPRF and APPSVR parameters has security enabled, this parameter is required.
When this command runs it will make changes to the WebSphere instance/profile configuration or the running state of the iSeries Access for Web web application. When WebSphere security has been enabled for an instance/profile, authentication information must be supplied to make those changes.
The WASUSRID and WASPWD parameters provide the required authentication information.
To determine what value to specify for this parameter, refer to the Authentication Mechanisms and User Registries settings under the Security configuration in the WebSphere administration console.
This parameter does not apply to the WebSphere Portal or ASF Tomcat environments.
For additional information, please refer to the WebSphere Security information in the iSeries InfoCenter information http://www.ibm.com/servers/eserver/iseries/infocenter/
| Top |
If the WebSphere application server instance/profile specified in the WASINST/WASPRF and APPSVR parameters has security enabled, this parameter is required.
When this command runs it will make changes to the WebSphere instance/profile configuration or the running state of the iSeries Access for Web web application. When WebSphere security has been enabled for an instance/profile, authentication information must be supplied to make those changes.
The WebSphere user ID (WASUSRID) and WebSphere password (WASPWD) parameters provide the required authentication information.
To determine what value to specify for this parameter, refer to the Authentication Mechanisms and User Registries settings under the Security configuration in the WebSphere administration console.
This parameter does not apply to the WebSphere Portal or ASF Tomcat environments.
For additional information, please refer to the WebSphere Security information in the iSeries InfoCenter information http://www.ibm.com/servers/eserver/iseries/infocenter/
| Top |
Example 1: Removing the Configuration from WebSphere Application Server V5.0 for iSeries
RMVACCWEB2 APPSVRTYPE(*WAS50) WASINST(DEPTXYZ)
APPSVR(XYZSERVER)
This command will remove the iSeries Access for Web configuration from a user created WebSphere instance named DEPTXYZ within WebSphere Application Server for iSeries V5.0.
Example 2: Removing the Configuration from WebSphere Application Server V5.0 - Express for iSeries
RMVACCWEB2 APPSVRTYPE(*WAS50EXP) WASINST(MYINST)
APPSVR(*DEFAULT)
This command will remove the iSeries Access for Web configuration from the instance named MYINST in the WebSphere Application Server V5.0 - Express for iSeries configuration.
Example 3: Removing the Configuration from WebSphere Application Server V6.0 for OS/400
RMVACCWEB2 APPSVRTYPE(*WAS60) WASPRF(default)
APPSVR(server1)
This command will remove the iSeries Access for Web configuration from the profile named default, application server named server1, in the WebSphere Application Server V6.0 for OS/400 configuration.
Example 4: Removing the Configuration from WebSphere Application Server Network Deployment V6.0 for OS/400
RMVACCWEB2 APPSVRTYPE(*WAS60ND) WASPRF(default)
APPSVR(server1)
This command will remove the iSeries Access for Web configuration from the profile named default, application server named server1, in the WebSphere Application Server Network Deployment V6.0 for OS/400 configuration.
Example 5: Removing the Configuration from WebSphere Portal
RMVACCWEB2 APPSVRTYPE(*WP50) WPUSRID(wpsadmin)
WPPWD(wpspassword)
WPURL('myserver.mydomain.com/wps/config')
WPDFTPAG(*DELETE)
This command will remove the iSeries Access for Web configuration from WebSphere Portal V5.0. This example inputs the WebSphere Portal administrator user ID and password, the URL to the portal configuration servlet, and tells the command to delete the default iSeries Access for Web WebSphere Portal pages.
Example 6: Removing the Configuration from ASF Tomcat
CFGACCWEB2 APPSVRTYPE(*ASFTOMCAT) TCSVRNAME(TOMCAT)
This command will remove the iSeries Access for Web configuration from the Apache Software Foundation (ASF) Tomcat server named TOMCAT.
| Top |
*ESCAPE Messages
| Top |