Start Access for Web (STRACCWEB2)

The Start iSeries Access for Web (STRACCWEB2) command is used to start the iSeries 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.

iSeries 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.

iSeries 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.
iSeries Access for Web must be configured using the CFGACCWEB2 command before running this command.
This command is only available for the following web application servers:
- WebSphere Application Server V5.0 for iSeries
- WebSphere Application Server V5.0 - Express for iSeries
- WebSphere Application Server V5.1 for iSeries
- WebSphere Application Server V5.1 - Express for iSeries
- WebSphere Application Server V6.0 for iSeries
- WebSphere Application Server Network Deployment V6.0 for iSeries
WebSphere Application Server specific restrictions:
- The WebSphere Application Server subsystem must be running and in a ready state before running this command. Refer to the WebSphere documentation for information on starting the WebSphere subsystem and determining when it reaches a ready state.
- The application server configured within the WebSphere instance/profile must be running before executing this command.
The administration interface for the following web application servers should be used to start the iSeries Access for Web configuration:
- WebSphere Portal
- Apache Software Foundation (ASF) Tomcat

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
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 a iSeries Access for Web configuration to be started.

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

Web server instance name (WASINST)

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

*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

*DEFAULT: When *DEFAULT is specified, iSeries Access for Web will be started within the instance called 'default'.
name: Specify the name of the WebSphere instance that contains an iSeries Access for Web configuration to start. This is the same instance name that was used when the Configure Access for Web (CFGACCWEB2) command was run.

Web server profile name (WASPRF)

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

*WAS60 - WebSphere Application Server V6.0 for OS/400
*WAS60ND - WebSphere Application Server Network Deployment V6.0 for OS/400

*DEFAULT: When *DEFAULT is specified, iSeries Access for Web will be started within the profile called 'default'.
name: Specify the name of the WebSphere profile that contains an iSeries Access for Web configuration to start. This is the same profile name that was used when the Configure Access for Web (CFGACCWEB2) command was run.

Application server name (APPSVR)

Specifies the existing application server to which iSeries Access for Web has been configured and is to be started.

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 start iSeries Access for Web for one of the following web application servers:

*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

*DEFAULT

The following applies when the APPSVRTYPE parameter is set to *WAS50/*WAS51/*WAS60/*WAS60ND:

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 iSeries Access for Web is to be started.

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 iSeries Access for Web web application. When WebSphere security has been enabled for a 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.

character-value: Specify the user ID.

For additional information, please refer to the WebSphere Security information in the iSeries InfoCenter information http://www.ibm.com/servers/eserver/iseries/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 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.

character-value: Specify the password for the user ID.

For additional information, please refer to the WebSphere Security information in the iSeries InfoCenter information http://www.ibm.com/servers/eserver/iseries/infocenter/

Examples

Example 1: Starting iSeries Access for Web in a WebSphere Application Server V5.0 for iSeries

STRACCWEB2   APPSVRTYPE(*WAS50)  WASINST(DEPTXYZ)
             APPSVR(XYZSERVER)

This command will start the iSeries Access for Web configuration within WebSphere Application Server V5.0 for iSeries. In this example, the configuration within the user created instance DEPTXYZ will be started.

Example 2: Starting iSeries Access for Web in a WebSphere Application Server V5.0 - Express for iSeries

STRACCWEB2   APPSVRTYPE(*WAS50EXP)  WASINST(MYINST)
             APPSVR(*DEFAULT)

This command will start the iSeries Access for Web configuration within WebSphere Application Server V5.0 - Express for iSeries. In this example, the configuration within the user created instance MYINST will be started.

Example 3: Starting iSeries Access for Web in a WebSphere Application Server V6.0 for OS/400

STRACCWEB2   APPSVRTYPE(*WAS60)  WASPRF(default)
             APPSVR(server1)

This command will start the iSeries Access for Web configuration within WebSphere Application Server V6.0 for OS/400. In this example, the configuration within a profile called default and an application server named server1 will be started.

Example 4: Starting iSeries Access for Web in a WebSphere Application Server Network Deployment V6.0 for OS/400

STRACCWEB2   APPSVRTYPE(*WAS60ND)  WASPRF(default)
             APPSVR(server1)

This command will start the iSeries Access for Web configuration within WebSphere Application Server Network Deployment V6.0 for OS/400. In this example, the configuration within a profile called default and an application server named server1 will be started.