| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Start IBM i Access for Web (STRACCWEB2) 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 (CFGACCWEB2) 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:
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| APPSVRTYPE | Web application server type | Character value | 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 |
Specifies a web application server that contains a IBM i Access for Web configuration to be started.
This is a required parameter.
| Top |
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
| Top |
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:
When the WASPRF parameter is set to something other than *DEFAULT, this value will be set to the value specified for the WASPRF parameter.
| Top |
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
| Top |
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.
For additional information, please refer to the WebSphere Security information in the IBM i InfoCenter information http://www.ibm.com/systems/i/infocenter/
| Top |
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.
For additional information, please refer to the WebSphere Security information in the IBM i InfoCenter information http://www.ibm.com/systems/i/infocenter/
| Top |
Example 1: Starting IBM i Access for Web for WebSphere Application Server V6.1 for i5/OS
STRACCWEB2 APPSVRTYPE(*WAS61BASE) WASPRF(iwa61base)
APPSVR(iwa61base)
This command will start the IBM i Access for Web configuration within WebSphere Application Server V6.1 for i5/OS. In this example, the configuration within the user created profile iwa61base will be started.
Example 2: Starting IBM i Access for Web for WebSphere Application Server - Express V7.0 for IBM i
STRACCWEB2 APPSVRTYPE(*WAS70EXP) WASPRF(iwa70exp)
APPSVR(iwa70exp)
This command will start the IBM i Access for Web configuration within WebSphere Application Server - Express V7.0 for IBM i. In this example, the configuration within the user created profile iwa70exp will be started.
| Top |
*ESCAPE Messages
| Top |