Remove Access for Web (RMVACCWEB)

The Remove IBM i Access for Web (RMVACCWEB) command is used to remove the IBM i Access for Web configuration from the web application servers:

This command will remove the configuration that was defined using the Configure Access for Web (CFGACCWEB) command.

This command will not delete IBM i Access for Web from the system. This command will only remove the IBM i Access for Web configuration from the specified web application server.

This command will not delete user data that was generated while using IBM i 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 CFGACCWEB 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 IBM i Access for Web configuration could be removed using the web application server's administration interface. This is not recommended! The RMVACCWEB command will clean up internal configuration information that the web application server's administration interface will not.

Restrictions:

Parameters

Keyword Description Choices Notes
APPSVRTYPE Web application server type *WAS50, *WAS50EXP, *WAS51, *WAS51EXP, *WAS60, *WAS60ND, *WAS61BASE, *WAS61EXP, *WAS61ND, *WAS70BASE, *WAS70EXP, *WAS70ND, *WAS80BASE, *WAS80EXP, *WAS80ND, *WAS85BASE, *WAS85EXP, *WAS85ND, *INTAPPSVR, *WP50, *WP51, *WP60, *WP60ND, *WP61BASE, *WP61ND, *WP70, *WP80, *WSE, *ASFTOMCAT 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
INSTANCE Instance name Character value, *ADMIN Optional
TCSVRNAME Tomcat server name Character value Optional
WASINSDIR WebSphere install directory Path name, *DEFAULT Optional
WPUSRID WebSphere Portal user ID Character value Optional
WPPWD WebSphere Portal password Character value Optional
WPURL WebSphere Portal config URL Character value Optional
WPPTYPE WebSphere Portal portlet type *STD, *IBM Optional
WPDFTPAG WebSphere Portal default pages *DELETE, *NODELETE Optional
WASUSRID WebSphere user ID Character value, *NONE Optional
WASPWD WebSphere password Character value, *NONE Optional

Web application server type (APPSVRTYPE)

Specifies a web application server that contains an IBM i Access for Web configuration to be removed.

This is a required parameter.

*WAS50
WebSphere Application Server V5.0 for iSeries
*WAS50EXP
WebSphere Application Server V5.0 - Express for iSeries
*WAS51
WebSphere Application Server V5.1 for iSeries
*WAS51EXP
WebSphere Application Server V5.1 - Express for iSeries
*WAS60
WebSphere Application Server V6.0 for OS/400
*WAS60ND
WebSphere Application Server Network Deployment V6.0 for OS/400
*WAS61BASE
WebSphere Application Server V6.1 for i5/OS
*WAS61EXP
WebSphere Application Server - Express V6.1 for i5/OS
*WAS61ND
WebSphere Application Server Network Deployment V6.1 for i5/OS
*WAS70BASE
WebSphere Application Server V7.0 for IBM i
*WAS70EXP
WebSphere Application Server - Express V7.0 for IBM i
*WAS70ND
WebSphere Application Server Network Deployment V7.0 for IBM i
*WAS80BASE
WebSphere Application Server V8.0 for IBM i
*WAS80EXP
WebSphere Application Server - Express V8.0 for IBM i
*WAS80ND
WebSphere Application Server Network Deployment V8.0 for IBM i
*WAS85BASE
WebSphere Application Server V8.5 for IBM i
*WAS85EXP
WebSphere Application Server - Express V8.5 for IBM i
*WAS85ND
WebSphere Application Server Network Deployment V8.5 for IBM i
*INTAPPSVR
IBM integrated Web application server for i
*WP50
WebSphere Portal V5.0
*WP51
WebSphere Portal V5.1
*WP60
WebSphere Portal V6.0 running on WebSphere Application Server V6.0 for OS/400 ("Base edition")
*WP60ND
WebSphere Portal V6.0 running on WebSphere Application Server Network Deployment V6.0 for OS/400
*WP61BASE
WebSphere Portal V6.1 running on WebSphere Application Server ("Base edition")
*WP61ND
WebSphere Portal V6.1 running on WebSphere Application Server Network Deployment
*WP70
WebSphere Portal V7.0
*WP80
WebSphere Portal V8.0
*WSE
Workplace Services Express
*ASFTOMCAT
Apache Software Foundation (ASF) Tomcat

Web server instance name (WASINST)

Specifies an IBM WebSphere Application Server instance that contains an IBM i 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/*WP51/*WSE, this parameter is the WebSphere instance that WebSphere Portal has been configured to run within.

*DEFAULT
When *DEFAULT is specified, IBM i Access for Web will be removed from the instance called 'default'.
name
Specify the name of the WebSphere instance that contains an IBM i Access for Web configuration to remove. This is the same instance name that was used when the Configure Access for Web (CFGACCWEB) command was run.

Web server profile name (WASPRF)

Specifies an IBM WebSphere Application Server profile that contains an IBM i 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

*DEFAULT
When *DEFAULT is specified, IBM i Access for Web will be removed from the profile called 'default'.
name
Specify the name of the WebSphere profile that contains an IBM i Access for Web configuration to remove. This is the same profile name that was used when the Configure Access for Web (CFGACCWEB) command was run.

Application server name (APPSVR)

Specifies the existing application server to which IBM i 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 IBM i Access for Web from one of the following web application servers:

*DEFAULT
The following applies when the APPSVRTYPE parameter is set to *WAS50/*WAS51/*WAS60/*WAS60ND/*WAS61BASE/*WAS61EXP/*WAS61ND/ *WAS70BASE/*WAS70EXP/*WAS70ND/*WAS80BASE/*WAS80EXP/*WAS80ND/ *WAS85BASE/*WAS85EXP/*WAS85ND:
  • When the WASINST/WASPRF parameter is set to *DEFAULT, this value will be set to 'server1'
  • When the WASINST/WASPRF parameter is set to something other than *DEFAULT, this value will be set to the value specified for the WASINST/WASPRF parameter.

The following applies when the APPSVRTYPE parameter is set to *WAS50EXP/*WAS51EXP:

  • When the WASINST parameter is set to *DEFAULT, this value will be set to 'default'.
  • When the WASINST parameter is set to something other than *DEFAULT, this value will be set to the value specified in the WASINST parameter.
name
Specify the name of the application server within the WebSphere instance/profile where IBM i Access for Web is to be removed.

Instance name (INSTANCE)

Specifies an IBM integrated Web application server for i instance that contains an IBM i Access for Web configuration to remove.

This parameter is only applicable when the Web application server type (APPSVRTYPE) parameter is set to

*ADMIN
When the INSTANCE parameter is set to *ADMIN, IBM i Access for Web will be removed from the Admin integrated Web application server instance.
name
Specify the name of the IBM integrated Web application server for IBM i instance that contains an IBM i Access for Web configuration to remove. This is the same instance name that was used when the Configure Access for Web (CFGACCWEB) command was run.

Tomcat server name (TCSVRNAME)

This parameter specifies the name of an Apache Software Foundation (ASF) Tomcat server that contains an IBM i Access for Web configuration to remove.

A parameter value is required when *ASFTOMCAT is specified for the Web application server type (APPSVRTYPE) parameter.

name
Specify the name of an existing ASF Tomcat server.

WebSphere install directory (WASINSDIR)

A version of WebSphere Application Server has been configured to run IBM i Access for Web. This parameter specifies the directory in the IBM i integrated file system where that version of WebSphere Application Server was installed.

Newer versions of WebSphere Application Server can be installed to multiple locations in the integrated file system. This value tells IBM i Access for Web which WebSphere Application Server installation was configured to run IBM i Access for Web.

This parameter is only applicable when the Web application server type (APPSVRTYPE) parameter is set to one of the following web application servers

*DEFAULT
When *DEFAULT is specified, the path used will be based on the value specified in the Web application server type (APPSVRTYPE) parameter.
  • *WAS61BASE - /QIBM/ProdData/WebSphere/AppServer/V61/Base
  • *WAS61EXP - /QIBM/ProdData/WebSphere/AppServer/V61/Express
  • *WAS61ND - /QIBM/ProdData/WebSphere/AppServer/V61/ND
  • *WAS70BASE - /QIBM/ProdData/WebSphere/AppServer/V7/Base
  • *WAS70EXP - /QIBM/ProdData/WebSphere/AppServer/V7/Express
  • *WAS70ND - /QIBM/ProdData/WebSphere/AppServer/V7/ND
  • *WAS80BASE - /QIBM/ProdData/WebSphere/AppServer/V8/Base
  • *WAS80EXP - /QIBM/ProdData/WebSphere/AppServer/V8/Express
  • *WAS80ND - /QIBM/ProdData/WebSphere/AppServer/V8/ND
  • *WAS85BASE - /QIBM/ProdData/WebSphere/AppServer/V85/Base
  • *WAS85EXP - /QIBM/ProdData/WebSphere/AppServer/V85/Express
  • *WAS85ND - /QIBM/ProdData/WebSphere/AppServer/V85/ND
  • *WP61BASE - /QIBM/ProdData/WebSphere/AppServer/V61/Base
  • *WP61ND - /QIBM/ProdData/WebSphere/AppServer/V61/ND
  • *WP70
    • If both Base and Network Deployment editions are installed, a runtime error will be displayed stating that WebSphere install directory (WASINSDIR) must be specified.
    • If there is a single installation of the Base or Network Deployment editions, that location is used.
    • If there are multiple installations of the Base edition, the following location is used. If none of the installations are in this default location, a runtime error will be displayed stating that WebSphere install directory (WASINSDIR) must be specified.
      • /QIBM/ProdData/WebSphere/AppServer/V7/Base
    • If there are multiple installations of the Network Deployment edition, the following location is used. If none of the installations are in this default location, a runtime error will be displayed stating that WebSphere install directory (WASINSDIR) must be specified.
      • /QIBM/ProdData/WebSphere/AppServer/V7/ND
  • *WP80
    • If there is a single installation of the Network Deployment edition, that location is used.
    • If there are multiple installations of the Network Deployment edition, the following location is used. If none of the installations are in this default location, a runtime error will be displayed stating that WebSphere install directory (WASINSDIR) must be specified.
      • /QIBM/ProdData/WebSphere/AppServer/V8/ND
path-name
Specify the installation path of WebSphere Application Server.

WebSphere Portal user ID (WPUSRID)

Specifies the IBM WebSphere Portal administrative user ID that will be used to remove the IBM i 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 system 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 WebSphere Portal or WSE is specified for the Web application server type (APPSVRTYPE) parameter.

character-value
Specify the administrative user ID.

WebSphere Portal password (WPPWD)

Specifies the password for the IBM WebSphere Portal administrative user ID specified for the WPUSRID parameter.

This value is sent to the system 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 WebSphere Portal or WSE is specified for the Web application server type (APPSVRTYPE) parameter.

character-value
Specify the password for the IBM WebSphere Portal administrative user.

WebSphere Portal config URL (WPURL)

Specifies the universal resource locator (URL) to access the WebSphere Portal configuration servlet. This servlet will remove the IBM i Access for Web configuration information in WebSphere Portal.

This URL is comprised of the following elements:

Examples for this value could be

A parameter value is required when WebSphere Portal or WSE is specified for the Web application server type (APPSVRTYPE) parameter.

character-value
Specify the URL to access the WebSphere Portal configuration servlet.

WebSphere Portal portlet type (WPPTYPE)

Specifies the type of portlets to be removed from the WebSphere Portal pages. IBM i Access for Web provides two portal applications: standard and IBM.

This parameter is only applicable when the Web application server type (APPSVRTYPE) parameter is set to one of the following web application servers

*STD
Remove the standard portlets configuration. The standard portal application is a set of portlets written to the Java Specification Requests (JSR) 168 Portlet Specification.
*IBM
Remove the IBM portlets configuration. The IBM portal application is a set of portlets written to the IBM Portlet API.

WebSphere Portal default pages (WPDFTPAG)

When removing the IBM i Access for Web portlets from the WebSphere Portal configuration, the default WebSphere Portal pages that may have been created using the CFGACCWEB command can be deleted.

*DELETE
Delete the default IBM i Access for Web pages that were created when the CFGACCWEB command was run.
*NODELETE
The default IBM i Access for Web pages that were created when the CFGACCWEB command was run will not be deleted.

WebSphere user ID (WASUSRID)

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 IBM i 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, integrated Web application server, or ASF Tomcat environments.

character-value
Specify the user ID.

For additional information, please refer to the WebSphere Security information in the IBM i InfoCenter information http://www.ibm.com/systems/i/infocenter/

WebSphere password (WASPWD)

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 IBM i 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, integrated Web application server, or ASF Tomcat environments.

character-value
Specify the password for the user ID.

For additional information, please refer to the WebSphere Security information in the IBM i InfoCenter information http://www.ibm.com/systems/i/infocenter/

Examples

Example 1: Removing the Configuration from integrated Web application server for i 

RMVACCWEB   APPSVRTYPE(*INTAPPSVR) INSTANCE(iwaias)

This command removes the IBM i Access for Web configuration from a user created integrated Web application server instance named iwaias.

Example 2: Removing the Configuration from WebSphere Application Server V8.0 for IBM i 

RMVACCWEB   APPSVRTYPE(*WAS80BASE) WASPRF(iwa80base)
            APPSVR(iwa80base)

This command removes the IBM i Access for Web configuration from the WebSphere Application Server V8.0 for IBM i profile named iwa80base. This profile contains an application server named iwa80base.

Example 3: Removing the Configuration from WebSphere Application Server - Express V8.5 for IBM i 

RMVACCWEB   APPSVRTYPE(*WAS85EXP) WASPRF(iwa85exp)
            APPSVR(iwa85exp)

This command removes the IBM i Access for Web configuration from the WebSphere Application Server - Express V8.5 for IBM i profile named iwa85exp. This profile contains an application server named iwa85exp.

Example 4: Removing the Configuration from WebSphere Portal V7.0 

RMVACCWEB   APPSVRTYPE(*WP70) WASPRF(iwawps70)
            WASINSDIR('/QIBM/ProdData/WebSphere/AppServer/V7/Base')
            WPUSRID(wpsadmin) WPPWD(wpspassword)
            WPURL('mysystem.mydomain.com/wps/config')
            WPPTYPE(*STD) WPDFTPAG(*DELETE)

This command removes the IBM i Access for Web configuration from WebSphere Portal V7.0 running on WebSphere Application Server V7.0 ("Base edition"). WebSphere Portal was configured in a WebSphere Application Server profile named iwawps70. This example specifies the WebSphere Application Server profile name and installation directory, the WebSphere Portal administrator user ID and password, and the URL to the portal configuration servlet. This example removes the standard portlets and deletes the default IBM i Access for Web WebSphere Portal pages.

Example 5: Removing the Configuration from WebSphere Portal V8.0 

RMVACCWEB   APPSVRTYPE(*WP80) WASPRF(iwawps80)
            WASINSDIR('/QIBM/ProdData/WebSphere/AppServer/V8/ND')
            WPUSRID(wpsadmin) WPPWD(wpspassword)
            WPURL('mysystem.mydomain.com/wps/config')
            WPPTYPE(*STD) WPDFTPAG(*DELETE)

This command removes the IBM i Access for Web configuration from WebSphere Portal V8.0 running on WebSphere Application Server Network Deployment V8.0. WebSphere Portal was configured in a WebSphere Application Server profile named iwawps80. This example specifies the WebSphere Application Server profile name and installation directory, the WebSphere Portal administrator user ID and password, and the URL to the portal configuration servlet. This example removes the standard portlets and deletes the default IBM i Access for Web WebSphere Portal pages.

Error messages

*ESCAPE Messages

IAW0004
Remove IBM i Access for Web command failed.
IAW000E
The TCSVRNAME parameter is required.
IAW0011
The WPUSRID, WPPWD, and WPURL parameters are required.