Start Access for Web (STRACCWEB)
Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Start IBM i Access for Web (STRACCWEB) command is used to start the IBM i Access for Web configuration within the web application server IBM WebSphere Application Server.
This command will start a configuration that was created using the Configure Access for Web (CFGACCWEB) command.
IBM i Access for Web must be started before it's functions can be accessed.
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.
IBM i Access for Web can also be started 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 start 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 a IBM i Access for Web configuration to be started.
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 start.
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, IBM i Access for Web will be started within the profile called 'default'.
- name
- Specify the name of the WebSphere profile that contains an IBM i Access for Web configuration to start. 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 started.
A WebSphere 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 start IBM i Access for Web for 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 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 started.
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 a 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: Starting IBM i Access for Web for WebSphere Application Server V8.0 for IBM i
STRACCWEB APPSVRTYPE(*WAS80BASE) WASPRF(iwa80base) APPSVR(iwa80base)
This command starts 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 started.
Example 2: Starting IBM i Access for Web for WebSphere Application Server - Express V8.5 for IBM i
STRACCWEB APPSVRTYPE(*WAS85EXP) WASPRF(iwa85exp) APPSVR(iwa85exp)
This command starts 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 started.
Top |
Top |