ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/cfgaccweb2.htm

937 lines
41 KiB
HTML

<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Configure Access for Web (CFGACCWEB2)</title>
</head>
<body bgcolor="white">
<a name="CFGACCWEB2.Top_Of_Page"></a>
<h2>Configure Access for Web (CFGACCWEB2)</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="#CFGACCWEB2.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CFGACCWEB2.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CFGACCWEB2.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CFGACCWEB2"></a>
<p>The Configure iSeries Access for Web (CFGACCWEB2) command is used to configure iSeries Access for Web for the following web serving environments:
</p>
<ul>
<li>IBM WebSphere Application Server V5.0 for iSeries
</li>
<li>IBM WebSphere Application Server V5.0 - Express for iSeries
</li>
<li>IBM WebSphere Application Server V5.1 for iSeries
</li>
<li>IBM WebSphere Application Server V5.1 - Express for iSeries
</li>
<li>IBM WebSphere Application Server V6.0 for OS/400
</li>
<li>IBM WebSphere Application Server Network Deployment V6.0 for OS/400
</li>
<li>IBM WebSphere Portal V5.0
</li>
<li>Apache Software Foundation (ASF) Tomcat
</li>
</ul>
<p>Before iSeries Access for Web can be used, it must be configured using this command.
</p>
<p>Input parameters are conditional based on the value specified for the <b>Web application server type (APPSVRTYPE)</b> parameter.
</p>
<p>This command will use the input configuration parameters to add iSeries Access for Web servlet or portlet configuration information to the web application server.
</p>
<p>If multiple web application servers are configured and running on the iSeries server, iSeries Access for Web can be configured to run within each of those web application servers.
</p>
<p>When configuring iSeries Access for Web for multiple web application servers, the new configuration can be created based on an existing configuration. The new configuration can share user-generated data with other configurations or a copy of the existing user data can be made for the new configuration.
</p>
<p>This command will create a directory structure for user-generated data. User data will be stored to the following locations, depending on the value specified for the <b>Web application server type (APPSVRTYPE)</b> parameter:
</p>
<ul>
<li>*WAS50 - /QIBM/UserData/Access/Web2/was50base/&lt;instance_name&gt;/&lt;application_server_name&gt;
</li>
<li>*WAS50EXP - /QIBM/UserData/Access/Web2/was50exp/&lt;instance_name&gt;/&lt;application_server_name&gt;
</li>
<li>*WAS51 - /QIBM/UserData/Access/Web2/was51base/&lt;instance_name&gt;/&lt;application_server_name&gt;
</li>
<li>*WAS51EXP - /QIBM/UserData/Access/Web2/was51exp/&lt;instance_name&gt;/&lt;application_server_name&gt;
</li>
<li>*WAS60 - /QIBM/UserData/Access/Web2/was60/&lt;profile_name&gt;/&lt;application_server_name&gt;
</li>
<li>*WAS60ND - /QIBM/UserData/Access/Web2/was60nd/&lt;profile_name&gt;/&lt;application_server_name&gt;
</li>
<li>*WP50 - /QIBM/UserData/Access/Web2/wp50/&lt;instance_name&gt;
</li>
<li>*ASFTOMCAT - /QIBM/UserData/Access/Web2/asftomcat/&lt;server_name&gt;
</li>
</ul>
<p>When the command runs status information will be displayed indicating what the command is processing. As the command runs, detailed status and error information will also be logged to stream file <i>/QIBM/UserData/Access/Web2/logs/cmds.log</i>.
</p>
<p>After the command completes, the web application server may have to be ended and restarted. The iSeries Access for Web configuration will need to be started before it can be accessed.
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>You must have all object (*ALLOBJ) special authority to run this command.
</li>
<li>WebSphere Application Server V5.0/V5.1/V6.0 specific restrictions:
<ul>
<li>The WebSphere Application Server application server, or subsystem, must be ended and restarted after running this command.
</li>
<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>
<li>WebSphere Application Server instances/profiles managed by IBM WebSphere Application Server Network Deployment are not supported by iSeries Access for Web.
</li>
</ul>
</li>
<li>WebSphere Portal V5.0 specific restrictions:
<ul>
<li>WebSphere Portal V5.0 must be deployed to a WebSphere instance.
</li>
<li>WebSphere Portal V5.0 must be running before running this command. This command will call the WebSphere Portal configuration servlet to perform configuration changes to WebSphere Portal for iSeries Access for Web.
</li>
</ul>
</li>
<li>ASF Tomcat specific restrictions:
<ul>
<li>The ASF Tomcat server must be ended and restarted after running this command.
</li>
</ul>
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CFGACCWEB2.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="#CFGACCWEB2.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="#CFGACCWEB2.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="#CFGACCWEB2.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="#CFGACCWEB2.TCSVRNAME"><b>TCSVRNAME</b></a></td>
<td valign="top">Tomcat server name</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CFGACCWEB2.TCHOMEDIR"><b>TCHOMEDIR</b></a></td>
<td valign="top">Tomcat home directory</td>
<td valign="top"><i>Path name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CFGACCWEB2.TCUSRPRF"><b>TCUSRPRF</b></a></td>
<td valign="top">Tomcat user profile</td>
<td valign="top"><i>Simple name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CFGACCWEB2.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="#CFGACCWEB2.NODENAME"><b>NODENAME</b></a></td>
<td valign="top">Node 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="#CFGACCWEB2.TGTSVR"><b>TGTSVR</b></a></td>
<td valign="top">Target server</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="#CFGACCWEB2.AUTHTYPE"><b>AUTHTYPE</b></a></td>
<td valign="top">Authentication type</td>
<td valign="top"><b><u>*APP</u></b>, *APPSVR</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CFGACCWEB2.AUTHMETHOD"><b>AUTHMETHOD</b></a></td>
<td valign="top">Authentication method</td>
<td valign="top"><b><u>*FORM</u></b>, *BASIC</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CFGACCWEB2.WPUSRID"><b>WPUSRID</b></a></td>
<td valign="top">WebSphere Portal user ID</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CFGACCWEB2.WPPWD"><b>WPPWD</b></a></td>
<td valign="top">WebSphere Portal password</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CFGACCWEB2.WPURL"><b>WPURL</b></a></td>
<td valign="top">WebSphere Portal config URL</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CFGACCWEB2.WPDFTPAG"><b>WPDFTPAG</b></a></td>
<td valign="top">WebSphere Portal default pages</td>
<td valign="top"><b><u>*CREATE</u></b>, *NOCREATE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CFGACCWEB2.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="#CFGACCWEB2.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>
<tr>
<td valign="top"><a href="#CFGACCWEB2.SRCSVRTYPE"><b>SRCSVRTYPE</b></a></td>
<td valign="top">Source web server type</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CFGACCWEB2.SRCSVRINST"><b>SRCSVRINST</b></a></td>
<td valign="top">Source web server instance</td>
<td valign="top"><i>Character value</i>, <b><u>*DEFAULT</u></b>, *WASINST, *WASPRF</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CFGACCWEB2.SRCAPPSVR"><b>SRCAPPSVR</b></a></td>
<td valign="top">Source application server</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="#CFGACCWEB2.SHRUSRDTA"><b>SHRUSRDTA</b></a></td>
<td valign="top">Share user data</td>
<td valign="top">*NO, *YES</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CFGACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CFGACCWEB2.APPSVRTYPE"></a>
<h3>Web application server type (APPSVRTYPE)</h3>
<p>Specifies which web application server to configure iSeries Access for Web to run under.
</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 (Base and Express)
</dd>
<dt><b>*WAS60ND</b></dt>
<dd>WebSphere Application Server Network Deployment V6.0 for OS/400
</dd>
<dt><b>*WP50</b></dt>
<dd>WebSphere Portal V5.0
</dd>
<dt><b>*ASFTOMCAT</b></dt>
<dd>Apache Software Foundation (ASF) Tomcat
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CFGACCWEB2.WASINST"></a>
<h3>Web server instance name (WASINST)</h3>
<p>Specifies which IBM WebSphere Application Server instance to configure to run iSeries Access for Web.
</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>
<li>*WP50 - WebSphere Portal V5.0
</li>
</ul>
<p>When the <b>Web application server type (APPSVRTYPE)</b> parameter is set to *WP50, this parameter is the WebSphere instance that WebSphere Portal has been configured to run within.
</p>
<dl>
<dt><b><u>*DEFAULT</u></b></dt>
<dd>When IBM WebSphere Application Server was installed, a default instance was automatically created for the WebSphere installation except for WebSphere - Express for iSeries.
<p>For WebSphere - Express for iSeries environments, an instance is not automatically created and must be created by the system administrator.
</p>
<p>When *DEFAULT is specified, iSeries Access for Web will be configured within the default WebSphere instance.
</p>
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the WebSphere instance to configure to run iSeries Access for Web.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CFGACCWEB2.WASPRF"></a>
<h3>Web server profile name (WASPRF)</h3>
<p>Specifies which IBM WebSphere Application Server profile to configure to run iSeries Access for Web.
</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 IBM WebSphere Application Server was installed, a default profile was automatically created for the WebSphere installation.
<p>When *DEFAULT is specified, iSeries Access for Web will be configured within the default WebSphere profile.
</p>
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the WebSphere profile to configure to run iSeries Access for Web.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CFGACCWEB2.TCSVRNAME"></a>
<h3>Tomcat server name (TCSVRNAME)</h3>
<p>Specifies the existing Apache Software Foundation (ASF) Tomcat server that will be configured to run iSeries Access for Web.
</p>
<p>A parameter value is required when *ASFTOMCAT is specified for the <b>Web application server type (APPSVRTYPE)</b> parameter.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of an existing ASF Tomcat server.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CFGACCWEB2.TCHOMEDIR"></a>
<h3>Tomcat home directory (TCHOMEDIR)</h3>
<p>Specifies the Apache Software Foundation (ASF) Tomcat home directory that the ASF Tomcat server was configured to use.
</p>
<p>When the ASF Tomcat server was configured, an integrated file system (IFS) path was specified as the location for the ASF Tomcat servlet engine and its associated files. By default, the directory may have been set to /ASFTomcat/&lt;server_name&gt;. The path can be verified by checking the Tomcat server settings.
</p>
<p>This home directory contains subdirectories for logs, applications, and configuration information for the ASF Tomcat server.
</p>
<p>The CFGACCWEB2 command will create directories and files within this path for iSeries Access for Web.
</p>
<p>A parameter value is required when *ASFTOMCAT is specified for the <b>Web application server type (APPSVRTYPE)</b> parameter.
</p>
<dl>
<dt><b><i>path-name</i></b></dt>
<dd>Specify the path name of the ASF Tomcat home directory.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CFGACCWEB2.TCUSRPRF"></a>
<h3>Tomcat user profile (TCUSRPRF)</h3>
<p>Specifies the user ID that the Apache Software Foundation (ASF) Tomcat server was configured to use.
</p>
<p>The CFGACCWEB2 command will use this value to grant the ASF Tomcat server user ID access to iSeries Access for Web files.
</p>
<p>This parameter is required and only applicable when *ASFTOMCAT is specified for the <b>Web application server type (APPSVRTYPE)</b> parameter.
</p>
<dl>
<dt><b><i>simple-name</i></b></dt>
<dd>Specify the name of the user profile for the ASF Tomcat server.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CFGACCWEB2.APPSVR"></a>
<h3>Application server name (APPSVR)</h3>
<p>Specifies the existing application server to which iSeries Access for Web is to be configured.
</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 configure 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 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 or WASPRF parameter is set to *DEFAULT, this value will be set to 'server1'
</li>
<li>When the WASINST or WASPRF parameter is set to something other than *DEFAULT, this value will be set to the value specified for the WASINST or 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 that is to be configured.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CFGACCWEB2.NODENAME"></a>
<h3>Node name (NODENAME)</h3>
<p>Specifies the name of the node within the WebSphere instance to which iSeries Access for Web is to be configured.
</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>The following applies when the APPSVRTYPE parameter is set to *WAS50/*WAS51:
<ul>
<li>When the WASINST parameter is set to *DEFAULT, this value will be set to the name of the iSeries server.
</li>
<li>When the WASINST parameter is set to something other than *DEFAULT, this value will be set to a combination of the iSeries server name and the value specified for the WASINST parameter. For example, if the iSeries server name is SERVERA and the WASINST parameter is set to 'TEST', this value would be set to 'SERVERA_TEST'.
</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 a combination of the iSeries server name and 'default'. For example, if the iSeries server name is SERVERA and the WASINST parameter is set to *DEFAULT, this value would be set to 'SERVERA_default'.
</li>
<li>When the WASINST parameter is set to something other than *DEFAULT, this value will be set to a combination of the iSeries server name and the value specified for the WASINST parameter. For example, if the iSeries server name is SERVERA and the WASINST parameter is set to 'MYINST', this value would be set to 'SERVERA_MYINST'.
</li>
</ul>
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the node within the WebSphere instance that is to be configured.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CFGACCWEB2.TGTSVR"></a>
<h3>Target server (TGTSVR)</h3>
<p>Specifies the iSeries server to which iSeries Access for Web is to connect.
</p>
<p>This parameter allows iSeries Access for Web to be configured on a central iSeries server to provide a gateway-like function to allow access to another iSeries server in the network.
</p>
<p>A web application server such as WebSphere Application Server and iSeries Access for Web may not need to be installed or configured on the iSeries server specified in this parameter.
</p>
<dl>
<dt><b><u>*DEFAULT</u></b></dt>
<dd>iSeries Access for Web will connect to and serve data from the iSeries server to which it has been installed.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the fully qualified domain name for the target iSeries server you want iSeries Access for Web to access data from. The domain name can be determined by accessing the TCP/IP configuration information on the target server.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CFGACCWEB2.AUTHTYPE"></a>
<h3>Authentication type (AUTHTYPE)</h3>
<p>Specifies whether the application or the application server authenticates the user.
</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>
<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>*APP</u></b></dt>
<dd>iSeries Access for Web will authenticate with i5/OS using a user profile and password.
<p>This option uses HTTP basic authentication to prompt for the user profile and password. To secure authentication information during transmission, HTTPS (secure HTTP) should be used.
</p>
</dd>
<dt><b>*APPSVR</b></dt>
<dd>WebSphere Application Server will authenticate with the active user registry. iSeries Access for Web uses Enterprise Identity Mapping (EIM) to map the authenticated WebSphere user identity to an i5/OS user identity.
<p>This option enables iSeries Access for Web to participate in WebSphere single sign-on (SSO) environments.
</p>
<p>This option requires global security be enabled for the WebSphere Application Server instance being configured.
</p>
<p>This option also requires the IBM Identity Token Connector be installed in the WebSphere Application Server instance being configured.
</p>
</dd>
</dl>
<p>For additional information, please refer to the iSeries Access for Web InfoCenter information http://www.ibm.com/servers/eserver/iseries/infocenter/
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CFGACCWEB2.AUTHMETHOD"></a>
<h3>Authentication method (AUTHMETHOD)</h3>
<p>Specifies the method used by the application server to identify the user.
</p>
<p>This parameter is only applicable when the AUTHTYPE parameter is set to a value of *APPSVR.
</p>
<dl>
<dt><b><u>*FORM</u></b></dt>
<dd>This method uses an HTML form to prompt for the user ID and password. The information is transmitted in clear text. To secure authentication information during transmission, HTTPS (secure HTTP) should be used.
</dd>
<dt><b>*BASIC</b></dt>
<dd>This method uses HTTP basic authentication to prompt for the user ID and password. To secure authentication information during transmission, HTTPS (secure HTTP) should be used.
</dd>
</dl>
<p>For additional information, please refer to the iSeries Access for Web InfoCenter information http://www.ibm.com/servers/eserver/iseries/infocenter/
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CFGACCWEB2.WPUSRID"></a>
<h3>WebSphere Portal user ID (WPUSRID)</h3>
<p>Specifies the IBM WebSphere Portal administrative user ID that will be used to configure iSeries Access for Web within WebSphere Portal.
</p>
<p>Changes to the WebSphere Portal configuration require a user ID be specified to make the changes. This is the same administrator level user ID that would be used to login to the WebSphere Portal user interface to perform administrator level functions.
</p>
<p>This value is sent to the server unencrypted using an HTTP connection. If the connection could be compromised, this command should only be run within a protected intranet environment.
</p>
<p>A parameter value is required when *WP50 is specified for the <b>Web application server type (APPSVRTYPE)</b> parameter.
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the administrative user ID.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CFGACCWEB2.WPPWD"></a>
<h3>WebSphere Portal password (WPPWD)</h3>
<p>Specifies the password for the IBM WebSphere Portal administrative user ID specified for the WPUSRID parameter.
</p>
<p>This value is sent to the server unencrypted using an HTTP connection. If the connection could be compromised, this command should only be run within a protected intranet environment.
</p>
<p>A parameter value is required when *WP50 is specified for the <b>Web application server type (APPSVRTYPE)</b> parameter.
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the password for the IBM WebSphere Portal administrative user.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CFGACCWEB2.WPURL"></a>
<h3>WebSphere Portal config URL (WPURL)</h3>
<p>Specifies the universal resource locator (URL) to access the WebSphere Portal configuration servlet. This servlet will add the necessary iSeries Access for Web configuration information to WebSphere Portal.
</p>
<p>This URL is comprised of the following elements:
</p>
<ul>
<li>The portal host name.
</li>
<li>The base universal resource identifier (URI) for the portal, as specified during WebSphere Portal installation (default value was '/wps').
</li>
<li>The servlet extension '/config'.
</li>
</ul>
<p>An example for this value would be 'server_name.your_company.com/wps/config'.
</p>
<p>A parameter value is required when *WP50 is specified for the <b>Web application server type (APPSVRTYPE)</b> parameter.
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the URL to access the WebSphere Portal configuration servlet.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CFGACCWEB2.WPDFTPAG"></a>
<h3>WebSphere Portal default pages (WPDFTPAG)</h3>
<p>When configuring for WebSphere Portal default WebSphere Portal pages can be created and populated with iSeries Access for Web portlets.
</p>
<dl>
<dt><b><u>*CREATE</u></b></dt>
<dd>Create a default iSeries Access for Web WebSphere Portal page containing multiple sub-pages. The sub-pages will be populated with iSeries Access for Web portlets.
</dd>
<dt><b>*NOCREATE</b></dt>
<dd>Default iSeries Access for Web WebSphere Portal pages will not be created and iSeries Access for Web portlets will not be deployed to any WebSphere Portal pages.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CFGACCWEB2.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 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 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="#CFGACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CFGACCWEB2.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="#CFGACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CFGACCWEB2.SRCSVRTYPE"></a>
<h3>Source web server type (SRCSVRTYPE)</h3>
<p>Specifies an existing web application server that has been configured to run iSeries Access for Web. The new iSeries Access for Web configuration will be created based on this existing iSeries Access for Web configuration.
</p>
<p>This parameter is not applicable and will be ignored when the <b>Web application server type (APPSVRTYPE)</b> parameter is set to *WP50.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The new iSeries Access for Web configuration is not based on an existing iSeries Access for Web configuration.
</dd>
<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>
<dt><b>*ASFTOMCAT</b></dt>
<dd>Apache Software Foundation (ASF) Tomcat
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CFGACCWEB2.SRCSVRINST"></a>
<h3>Source web server instance (SRCSVRINST)</h3>
<p>This parameter specifies the name of a WebSphere instance/profile or an ASF Tomcat server name where iSeries Access for Web is already configured.
</p>
<p>The new iSeries Access for Web configuration will be based on this existing configuration.
</p>
<p>The WebSphere instance/profile name or ASF Tomcat server name specified with this parameter must be configured within the web application server specified for the <b>Source web server type (SRCSVRTYPE)</b> parameter.
</p>
<p>This parameter is not applicable and will be ignored when the <b>Web application server type (APPSVRTYPE)</b> parameter is set to *WP50.
</p>
<dl>
<dt><b><u>*DEFAULT</u></b></dt>
<dd>When the web application server was installed, a default instance/profile may have been automatically created. When *DEFAULT is specified, iSeries Access for Web will be configured based on an instance/profile named 'default'.
</dd>
<dt><b>*WASINST/*WASPRF</b></dt>
<dd>When *WASINST/*WASPRF is specified, the value specified in the WASINST/WASPRF parameter will be used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the WebSphere instance/profile or ASF Tomcat server that has already been configured to run iSeries Access for Web.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CFGACCWEB2.SRCAPPSVR"></a>
<h3>Source application server (SRCAPPSVR)</h3>
<p>The application server provides the environment in which deployed web applications execute. This parameter specifies the name of an application server within a WebSphere instance/profile where iSeries Access for Web is already configured.
</p>
<p>The new iSeries Access for Web configuration will be based on this existing configuration.
</p>
<p>This parameter is only applicable when the <b>Web application server type (APPSVRTYPE)</b> parameter is not set to *WP50 and the <b>Source web server type (SRCSVRTYPE)</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>
<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 SRCSVRTYPE parameter is set to *WAS50/*WAS51/*WAS60/*WAS60ND:
<ul>
<li>When this parameter is set to *DEFAULT and the SRCSVRINST parameter is set to *DEFAULT, this parameter will be set to 'server1'.
</li>
<li>When this parameter is set to *DEFAULT and the SRCSVRINST parameter is set to something other than *DEFAULT, this parameter will be set to the value specified for the SRCSVRINST parameter.
</li>
</ul>
<p>The following applies when the SRCSVRTYPE parameter is set to *WAS50EXP/*WAS51EXP:
</p>
<ul>
<li>When this parameter is set to *DEFAULT and the SRCSVRINST parameter is set to *DEFAULT, this parameter will be set to 'default'.
</li>
<li>When this parameter is set to *DEFAULT and the SRCSVRINST parameter is set to something other than *DEFAULT, this parameter will be set to the value specified for the SRCSVRINST parameter.
</li>
</ul>
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the application server within the WebSphere instance/profile that the new configuration will be based on.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CFGACCWEB2.SHRUSRDTA"></a>
<h3>Share user data (SHRUSRDTA)</h3>
<p>When configuring based on an existing iSeries Access for Web configuration this parameter specifies whether the new configuration will share user-generated data with the existing configuration.
</p>
<p>A parameter value is required when a value other than *NONE is specified for the SRCSVRTYPE parameter.
</p>
<dl>
<dt><b>*NO</b></dt>
<dd>The new configuration will start with a copy of the existing configuration's user-generated data.
</dd>
<dt><b>*YES</b></dt>
<dd>The new configuration will share the user-generated data with the existing configuration.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CFGACCWEB2.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Configuring WebSphere Application Server V5.0 for iSeries</b>
</p>
<p>
<pre>
CFGACCWEB2 APPSVRTYPE(*WAS50) WASINST(DEPTXYZ)
APPSVR(XYZSERVER)
</pre>
</p>
<p>This command will configure iSeries Access for Web for a user created WebSphere instance named DEPTXYZ containing an application server named XYZSERVER within WebSphere Application Server for iSeries V5.0.
</p>
<p><b>Example 2: Configuring WebSphere Application Server V5.0 - Express for iSeries</b>
</p>
<p>
<pre>
CFGACCWEB2 APPSVRTYPE(*WAS50EXP) WASINST(MYINST)
APPSVR(*DEFAULT)
SRCSVRTYPE(*WAS50) SRCSVRINST(DEPTXYZ)
SRCAPPSVR(XYZSERVER) SHRUSRDTA(*NO)
</pre>
</p>
<p>This command will configure iSeries Access for Web for the MYINST instance of WebSphere Application Server V5.0 - Express for iSeries. This example also shows that this new configuration will be based on a configuration that was performed in a previous example. User-generated data will be copied from the source configuration to this new configuration.
</p>
<p><b>Example 3: Configuring WebSphere Application Server V6.0 for OS/400</b>
</p>
<p>
<pre>
CFGACCWEB2 APPSVRTYPE(*WAS60) WASPRF(default) APPSVR(server1)
SRCSVRTYPE(*WAS50EXP) SRCSVRINST(MYINST)
SRCAPPSVR(*DEFAULT) SHRUSRDTA(*NO)
</pre>
</p>
<p>This command will configure iSeries Access for Web for the default instance of WebSphere Application Server V6.0 for OS/400. This default instance contains an application server named server1. This example also shows that this new configuration will be based on a configuration that was performed in a previous example. User-generated data will be copied from the source configuration to this new configuration.
</p>
<p><b>Example 4: Configuring WebSphere Application Server Network Deployment V6.0 for OS/400</b>
</p>
<p>
<pre>
CFGACCWEB2 APPSVRTYPE(*WAS60ND) WASPRF(default) APPSVR(server1)
SRCSVRTYPE(*WAS50EXP) SRCSVRINST(MYINST)
SRCAPPSVR(*DEFAULT) SHRUSRDTA(*NO)
</pre>
</p>
<p>This command will configure iSeries Access for Web for the default instance of WebSphere Application Server Network Deployment V6.0 for OS/400. This default instance contains an application server named server1. This example also shows that this new configuration will be based on a configuration that was performed in a previous example. User-generated data will be copied from the source configuration to this new configuration.
</p>
<p><b>Example 5: Configuring WebSphere Portal</b>
</p>
<p>
<pre>
CFGACCWEB2 APPSVRTYPE(*WP50) WPUSRID(wpsadmin)
WPPWD(wpspassword)
WPURL('myserver.mydomain.com/wps/config')
WPDFTPAG(*CREATE)
</pre>
</p>
<p>This command will configure iSeries Access for Web for WebSphere Portal V5.0. This example inputs the WebSphere Portal administrator user ID and password, the URL to the portal configuration servlet, and tells the command to create the default iSeries Access for Web WebSphere Portal pages and populate the pages with portlets.
</p>
<p><b>Example 6: Configuring ASF Tomcat</b>
</p>
<p>
<pre>
CFGACCWEB2 APPSVRTYPE(*ASFTOMCAT) TCSVRNAME(TOMCAT)
TCHOMEDIR('/ASFTomcat/tomcat')
TCUSRPRF(QTMHHTTP)
SRCSVRTYPE(*WAS50) SRCSVRINST(DEPTXYZ)
SRCAPPSVR(XYZSERVER) SHRUSRDTA(*YES)
</pre>
</p>
<p>This command will configure iSeries Access for Web for an Apache Software Foundation (ASF) Tomcat server named TOMCAT. This example also shows that this configuration will be based on a configuration that was performed in a previous example. User-generated data will be shared between the source configuration and this new configuration.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CFGACCWEB2.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>IAW0001</b></dt>
<dd>Configure iSeries Access for Web command failed.
</dd>
<dt><b>IAW000A</b></dt>
<dd>The SHRUSRDTA parameter is required.
</dd>
<dt><b>IAW000B</b></dt>
<dd>Value specified for parameter APPSVRTYPE is not valid.
</dd>
<dt><b>IAW000C</b></dt>
<dd>Value specified for parameter SRCSVRTYPE is not valid.
</dd>
<dt><b>IAW000D</b></dt>
<dd>The TCSVRNAME and TCHOMEDIR and TCUSRPRF parameters are required.
</dd>
<dt><b>IAW0011</b></dt>
<dd>The WPUSRID, WPPWD, and WPURL parameters are required.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGACCWEB2.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>