End Access for Web (ENDACCWEB)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The End IBM i Access for Web (ENDACCWEB) command is used to end, or stop, the running IBM i Access for Web configuration within the web application server IBM WebSphere Application Server.
This command will end the running configuration that was defined using the Configure Access for Web (CFGACCWEB) command.
When the command runs, status information will be displayed indicating what the command is processing. As the command runs, detailed status information and error information will also be logged to stream file /QIBM/UserData/Access/Web2/logs/cmds.log.
The IBM i Access for Web configuration can also be ended (stopped) using the web application server's administration interface.
Restrictions:
- You must have all object (*ALLOBJ) special authority to run this command.
- IBM i Access for Web must be configured using the CFGACCWEB command before running this command.
- This command is only available for the following web application servers:
- WebSphere Application Server V6.1 for i5/OS
- WebSphere Application Server - Express V6.1 for i5/OS
- WebSphere Application Server Network Deployment V6.1 for i5/OS
- WebSphere Application Server V7.0 for IBM i
- WebSphere Application Server - Express V7.0 for IBM i
- WebSphere Application Server Network Deployment V7.0 for IBM i
- WebSphere Application Server V8.0 for IBM i
- WebSphere Application Server - Express V8.0 for IBM i
- WebSphere Application Server Network Deployment V8.0 for IBM i
- WebSphere Application Server V8.5 for IBM i
- WebSphere Application Server - Express V8.5 for IBM i
- WebSphere Application Server Network Deployment V8.5 for IBM i
- WebSphere Application Server specific restrictions:
- The WebSphere Application Server subsystem must be running before running this command. Refer to the WebSphere documentation for information on starting the WebSphere subsystem.
- The application server configured within the WebSphere profile must be running before executing this command.
- The administration interface for the following web application servers should be used to end the IBM i Access for Web configuration:
- WebSphere Portal
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| APPSVRTYPE | Web application server type | *WAS61BASE, *WAS61EXP, *WAS61ND, *WAS70BASE, *WAS70EXP, *WAS70ND, *WAS80BASE, *WAS80EXP, *WAS80ND, *WAS85BASE, *WAS85EXP, *WAS85ND | Required, Positional 1 |
| WASPRF | Web server profile name | Character value, *DEFAULT | Optional |
| APPSVR | Application server name | Character value, *DEFAULT | Optional |
| WASINSDIR | WebSphere install directory | Path name, *DEFAULT | Optional |
| WASUSRID | WebSphere user ID | Character value, *NONE | Optional |
| WASPWD | WebSphere password | Character value, *NONE | Optional |
| Top |
Web application server type (APPSVRTYPE)
Specifies a web application server that contains an IBM i Access for Web configuration to be ended.
This is a required parameter.
- *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
| Top |
Web server profile name (WASPRF)
Specifies an IBM WebSphere Application Server profile that contains an IBM i Access for Web configuration to end.
- *DEFAULT
- When *DEFAULT is specified, IBM i Access for Web will be ended within the profile called 'default'.
- name
- Specify the name of the WebSphere profile that contains an IBM i Access for Web configuration to end. This is the same profile name that was used when the Configure Access for Web (CFGACCWEB) command was run.
| Top |
Application server name (APPSVR)
Specifies the existing application server to which IBM i Access for Web has been configured and is to be ended.
A WebSphere profile can contain one or more application servers. The application server provides the environment in which deployed web applications execute.
- *DEFAULT
- When the WASPRF parameter is set to *DEFAULT, this value will be set to 'server1'
When the WASPRF parameter is set to something other than *DEFAULT, this value will be set to the value specified for the WASPRF parameter.
- name
- Specify the name of the application server within the WebSphere instance/profile where IBM i Access for Web is to be ended.
| Top |
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
- *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
- *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
- path-name
- Specify the installation path of WebSphere Application Server.
| Top |
WebSphere user ID (WASUSRID)
If the WebSphere application server profile specified in the WASPRF and APPSVR parameters has security enabled, this parameter is required.
When this command runs it will make changes to the WebSphere profile configuration or the running state of the IBM i Access for Web web application. When WebSphere security has been enabled for an 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.
- 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/
| Top |
WebSphere password (WASPWD)
If the WebSphere application server profile specified in the WASPRF and APPSVR parameters has security enabled, this parameter is required.
When this command runs it will make changes to the WebSphere profile configuration or the running state of the IBM i Access for Web web application. When WebSphere security has been enabled for an 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.
- 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/
| Top |
Examples
Example 1: Ending IBM i Access for Web for WebSphere Application Server V8.0 for IBM i
ENDACCWEB APPSVRTYPE(*WAS80BASE) WASPRF(iwa80base)
APPSVR(iwa80base)
This command ends the IBM i Access for Web configuration within WebSphere Application Server V8.0 for IBM i. In this example, the configuration within the user created profile iwa80base is ended.
Example 2: Ending IBM i Access for Web in a WebSphere Application Server - Express V8.5 for IBM i
ENDACCWEB APPSVRTYPE(*WAS85EXP) WASPRF(iwa85exp)
APPSVR(iwa85exp)
This command ends the IBM i Access for Web configuration within WebSphere Application Server - Express V8.5 for IBM i. In this example, the configuration within the user created profile iwa85exp is ended.
| Top |
| Top |