friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
master
ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/straccweb2.htm

371 lines
15 KiB
HTML
Raw Permalink Blame History

<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Start Access for Web (STRACCWEB2)</title>
</head>
<body bgcolor="white">
<a name="STRACCWEB2.Top_Of_Page"></a>
<h2>Start Access for Web (STRACCWEB2)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#STRACCWEB2.PARAMETERS.TABLE">Parameters</a><br>
<a href="#STRACCWEB2.COMMAND.EXAMPLES">Examples</a><br>
<a href="#STRACCWEB2.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="STRACCWEB2"></a>
<p>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.
</p>
<p>This command will start a configuration that was created using the Configure Access for Web (CFGACCWEB2) command.
</p>
<p>iSeries Access for Web must be started before it's functions can be accessed.
</p>
<p>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 <i>/QIBM/UserData/Access/Web2/logs/cmds.log</i>.
</p>
<p>iSeries Access for Web can also be started using the web application server's administration interface.
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>You must have all object (*ALLOBJ) special authority to run this command.
</li>
<li>iSeries Access for Web must be configured using the CFGACCWEB2 command before running this command.
</li>
<li>This command is only available for the following web application servers:
<ul>
<li>WebSphere Application Server V5.0 for iSeries
</li>
<li>WebSphere Application Server V5.0 - Express for iSeries
</li>
<li>WebSphere Application Server V5.1 for iSeries
</li>
<li>WebSphere Application Server V5.1 - Express for iSeries
</li>
<li>WebSphere Application Server V6.0 for iSeries
</li>
<li>WebSphere Application Server Network Deployment V6.0 for iSeries
</li>
</ul>
</li>
<li>WebSphere Application Server specific restrictions:
<ul>
<li>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.
</li>
<li>The application server configured within the WebSphere instance/profile must be running before executing this command.
</li>
</ul>
</li>
<li>The administration interface for the following web application servers should be used to start the iSeries Access for Web configuration:
<ul>
<li>WebSphere Portal
</li>
<li>Apache Software Foundation (ASF) Tomcat
</li>
</ul>
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="STRACCWEB2.PARAMETERS.TABLE">Parameters</a></h3>
<table border="1" cellpadding="4" cellspacing="0">
<!-- col1="10" col2="15" col3="30" col4="10" -->
<tr>
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
</tr>
<tr>
<td valign="top"><a href="#STRACCWEB2.APPSVRTYPE"><b>APPSVRTYPE</b></a></td>
<td valign="top">Web application server type</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#STRACCWEB2.WASINST"><b>WASINST</b></a></td>
<td valign="top">Web server instance name</td>
<td valign="top"><i>Character value</i>, <b><u>*DEFAULT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STRACCWEB2.WASPRF"><b>WASPRF</b></a></td>
<td valign="top">Web server profile name</td>
<td valign="top"><i>Character value</i>, <b><u>*DEFAULT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STRACCWEB2.APPSVR"><b>APPSVR</b></a></td>
<td valign="top">Application server name</td>
<td valign="top"><i>Character value</i>, <b><u>*DEFAULT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STRACCWEB2.WASUSRID"><b>WASUSRID</b></a></td>
<td valign="top">WebSphere user ID</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STRACCWEB2.WASPWD"><b>WASPWD</b></a></td>
<td valign="top">WebSphere password</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#STRACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="STRACCWEB2.APPSVRTYPE"></a>
<h3>Web application server type (APPSVRTYPE)</h3>
<p>Specifies a web application server that contains a iSeries Access for Web configuration to be started.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b>*WAS50</b></dt>
<dd>WebSphere Application Server V5.0 for iSeries
</dd>
<dt><b>*WAS50EXP</b></dt>
<dd>WebSphere Application Server V5.0 - Express for iSeries
</dd>
<dt><b>*WAS51</b></dt>
<dd>WebSphere Application Server V5.1 for iSeries
</dd>
<dt><b>*WAS51EXP</b></dt>
<dd>WebSphere Application Server V5.1 - Express for iSeries
</dd>
<dt><b>*WAS60</b></dt>
<dd>WebSphere Application Server V6.0 for OS/400
</dd>
<dt><b>*WAS60ND</b></dt>
<dd>WebSphere Application Server Network Deployment V6.0 for OS/400
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRACCWEB2.WASINST"></a>
<h3>Web server instance name (WASINST)</h3>
<p>Specifies an IBM WebSphere Application Server instance that contains an iSeries Access for Web configuration to start.
</p>
<p>This parameter is only applicable when the <b>Web application server type (APPSVRTYPE)</b> parameter is set to one of the following web application servers
</p>
<ul>
<li>*WAS50 - WebSphere Application Server V5.0 for iSeries
</li>
<li>*WAS50EXP - WebSphere Application Server V5.0 - Express for iSeries
</li>
<li>*WAS51 - WebSphere Application Server V5.1 for iSeries
</li>
<li>*WAS51EXP - WebSphere Application Server V5.1 - Express for iSeries
</li>
</ul>
<dl>
<dt><b><u>*DEFAULT</u></b></dt>
<dd>When *DEFAULT is specified, iSeries Access for Web will be started within the instance called 'default'.
</dd>
<dt><b><i>name</i></b></dt>
<dd>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.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRACCWEB2.WASPRF"></a>
<h3>Web server profile name (WASPRF)</h3>
<p>Specifies an IBM WebSphere Application Server profile that contains an iSeries Access for Web configuration to start.
</p>
<p>This parameter is only applicable when the <b>Web application server type (APPSVRTYPE)</b> parameter is set to one of the following web application servers
</p>
<ul>
<li>*WAS60 - WebSphere Application Server V6.0 for OS/400
</li>
<li>*WAS60ND - WebSphere Application Server Network Deployment V6.0 for OS/400
</li>
</ul>
<dl>
<dt><b><u>*DEFAULT</u></b></dt>
<dd>When *DEFAULT is specified, iSeries Access for Web will be started within the profile called 'default'.
</dd>
<dt><b><i>name</i></b></dt>
<dd>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.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRACCWEB2.APPSVR"></a>
<h3>Application server name (APPSVR)</h3>
<p>Specifies the existing application server to which iSeries Access for Web has been configured and is to be started.
</p>
<p>A WebSphere instance/profile can contain one or more application servers. The application server provides the environment in which deployed web applications execute.
</p>
<p>This parameter is only applicable when the <b>Web application server type (APPSVRTYPE)</b> parameter is set to start iSeries Access for Web for one of the following web application servers:
</p>
<ul>
<li>*WAS50 - WebSphere Application Server V5.0 for iSeries
</li>
<li>*WAS50EXP - WebSphere Application Server V5.0 - Express for iSeries
</li>
<li>*WAS51 - WebSphere Application Server V5.1 for iSeries
</li>
<li>*WAS51EXP - WebSphere Application Server V5.1 - Express for iSeries
</li>
<li>*WAS60 - WebSphere Application Server V6.0 for OS/400
</li>
<li>*WAS60ND - WebSphere Application Server Network Deployment V6.0 for OS/400
</li>
</ul>
<dl>
<dt><b><u>*DEFAULT</u></b></dt>
<dd>The following applies when the APPSVRTYPE parameter is set to *WAS50/*WAS51/*WAS60/*WAS60ND:
<ul>
<li>When the WASINST/WASPRF parameter is set to *DEFAULT, this value will be set to 'server1'
</li>
<li>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.
</li>
</ul>
<p>The following applies when the APPSVRTYPE parameter is set to *WAS50EXP/*WAS51EXP:
</p>
<ul>
<li>When the WASINST parameter is set to *DEFAULT, this value will be set to 'default'.
</li>
<li>When the WASINST parameter is set to something other than *DEFAULT, this value will be set to the value specified in the WASINST parameter.
</li>
</ul>
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the application server within the WebSphere instance/profile where iSeries Access for Web is to be started.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRACCWEB2.WASUSRID"></a>
<h3>WebSphere user ID (WASUSRID)</h3>
<p>If the WebSphere application server instance/profile specified in the WASINST/WASPRF and APPSVR parameters has security enabled, this parameter is required.
</p>
<p>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.
</p>
<p>The WASUSRID and WASPWD parameters provide the required authentication information.
</p>
<p>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.
</p>
<p>This parameter does not apply to the WebSphere Portal or ASF Tomcat environments.
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the user ID.
</dd>
</dl>
<p>For additional information, please refer to the WebSphere Security information in the iSeries InfoCenter information http://www.ibm.com/servers/eserver/iseries/infocenter/
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRACCWEB2.WASPWD"></a>
<h3>WebSphere password (WASPWD)</h3>
<p>If the WebSphere application server instance/profile specified in the WASINST/WASPRF and APPSVR parameters has security enabled, this parameter is required.
</p>
<p>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.
</p>
<p>The WASUSRID and WASPWD parameters provide the required authentication information.
</p>
<p>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.
</p>
<p>This parameter does not apply to the WebSphere Portal or ASF Tomcat environments.
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the password for the user ID.
</dd>
</dl>
<p>For additional information, please refer to the WebSphere Security information in the iSeries InfoCenter information http://www.ibm.com/servers/eserver/iseries/infocenter/
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="STRACCWEB2.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Starting iSeries Access for Web in a WebSphere Application Server V5.0 for iSeries</b>
</p>
<p>
<pre>
STRACCWEB2 APPSVRTYPE(*WAS50) WASINST(DEPTXYZ)
APPSVR(XYZSERVER)
</pre>
</p>
<p>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.
</p>
<p><b>Example 2: Starting iSeries Access for Web in a WebSphere Application Server V5.0 - Express for iSeries</b>
</p>
<p>
<pre>
STRACCWEB2 APPSVRTYPE(*WAS50EXP) WASINST(MYINST)
APPSVR(*DEFAULT)
</pre>
</p>
<p>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.
</p>
<p><b>Example 3: Starting iSeries Access for Web in a WebSphere Application Server V6.0 for OS/400</b>
</p>
<p>
<pre>
STRACCWEB2 APPSVRTYPE(*WAS60) WASPRF(default)
APPSVR(server1)
</pre>
</p>
<p>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.
</p>
<p><b>Example 4: Starting iSeries Access for Web in a WebSphere Application Server Network Deployment V6.0 for OS/400</b>
</p>
<p>
<pre>
STRACCWEB2 APPSVRTYPE(*WAS60ND) WASPRF(default)
APPSVR(server1)
</pre>
</p>
<p>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.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="STRACCWEB2.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>IAW0002</b></dt>
<dd>Start iSeries Access for Web command failed.
</dd>
<dt><b>IAW000B</b></dt>
<dd>Value specified for parameter APPSVRTYPE is not valid.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink