639 lines
31 KiB
HTML
639 lines
31 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>Start TCP/IP Server (STRTCPSVR)</title>
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body bgcolor="white">
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<a name="STRTCPSVR.Top_Of_Page"></a>
|
|
<h2>Start TCP/IP Server (STRTCPSVR)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
|
<b>Threadsafe: </b>Conditional
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#STRTCPSVR.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#STRTCPSVR.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#STRTCPSVR.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="STRTCPSVR"></a>
|
|
<p>The Start TCP/IP Server (STRTCPSVR) command is used to start the TCP/IP application servers that are shipped with the operating system or the TCP/IP product. The number of server jobs started by this command is specified, where appropriate, in the configuration for each TCP/IP application.
|
|
</p>
|
|
<p>The STRTCPSVR command can only be used when TCP/IP is fully operational. The interface server job, QTCPIP, must be available. If TCP/IP processing was started by running the STRTCP (Start TCP/IP) command when the system was in restricted state, the STRTCPSVR command will fail.
|
|
</p>
|
|
<p>All servers have an autostart (AUTOSTART) parameter on the associated configuration command (for example, Change FTP Attributes (CHGFTPA)). This parameter indicates if the server should be started when the Start TCP/IP (STRTCP) command is entered. The STRTCPSVR command ignores the value of a server's autostart attribute, unless *AUTOSTART is specified for the <b>Server application (SERVER)</b> parameter. If a server has *YES for the AUTOSTART attribute, then the STRTCPSVR command will start the server when SERVER(*AUTOSTART) is specified. Additional servers can automatically be added to list of servers that STRTCPSVR will support by using the ADDTCPSVR (Add TCP/IP Server) CL command.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>This command is conditionally threadsafe. This command calls different programs to process each type of TCP/IP server. If the programs being called are threadsafe, this command is threadsafe.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRTCPSVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="STRTCPSVR.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="#STRTCPSVR.SERVER"><b>SERVER</b></a></td>
|
|
<td valign="top">Server application</td>
|
|
<td valign="top">Single values: <b><u>*ALL</u></b>, *AUTOSTART<br>Other values (up to 300 repetitions): <i>Character value</i></td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRTCPSVR.RESTART"><b>RESTART</b></a></td>
|
|
<td valign="top">Restart server</td>
|
|
<td valign="top"><b><u>*NONE</u></b>, *HTTP, *DNS, *DHCP, *QOS</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#STRTCPSVR.HTTPSVR"><b>HTTPSVR</b></a></td>
|
|
<td valign="top">HTTP server</td>
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Server instance</td>
|
|
<td valign="top">
|
|
<i>Name</i>, *ADMIN</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Instance startup values</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*NONE</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#STRTCPSVR.DNSSVR"><b>DNSSVR</b></a></td>
|
|
<td valign="top">DNS server</td>
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Server instance</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Instance startup values</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*NONE</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#STRTCPSVR.TCMSVR"><b>TCMSVR</b></a></td>
|
|
<td valign="top">TCM server</td>
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Instance name</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, *ALL</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Instance startup values</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*NONE</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="2"><a href="#STRTCPSVR.TOMCATSVR"><b>TOMCATSVR</b></a></td>
|
|
<td valign="top">ASFTOMCAT server</td>
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="2">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Server instance name</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, *ALL</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRTCPSVR.NTPSRV"><b>NTPSRV</b></a></td>
|
|
<td valign="top">SNTP service</td>
|
|
<td valign="top">*ALL, *CFGFILE, <b><u>*CLIENT</u></b>, *SERVER</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRTCPSVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="STRTCPSVR.SERVER"></a>
|
|
<h3>Server application (SERVER)</h3>
|
|
<p>Specifies the TCP/IP application servers to be started by this command.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All of the TCP/IP application servers and all HTTP, DNS, and TCM server instances are started.
|
|
</dd>
|
|
<dt><b>*AUTOSTART</b></dt>
|
|
<dd>All of the TCP/IP application servers that are defined with *YES for the AUTOSTART attribute are to be started.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values (up to 300 repetitions)</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ASFTOMCAT</b></dt>
|
|
<dd>The Apache Software Foundation (ASF) Tomcat server is started. Subsequent use of the STRTCPSVR command specifying SERVER(*ASFTOMCAT) will result in a diagnostic message if the Apache Software Foundation (ASF) Tomcat server has already been started.
|
|
</dd>
|
|
<dt><b>*BOOTP</b></dt>
|
|
<dd>The Bootstrap Protocol (BOOTP) server is started. Subsequent use of the STRTCPSVR command specifying SERVER(*BOOTP) will result in a diagnostic message if the BOOTP server job has already been started.
|
|
</dd>
|
|
<dt><b>*CIMOM</b></dt>
|
|
<dd>The Common Information Model Object Manager (CIMOM) server is started. Subsequent use of the STRTCPSVR command specifying SERVER(*CIMOM) will result in a diagnostic message if the CIMOM server has already been started.
|
|
</dd>
|
|
<dt><b>*DBG</b></dt>
|
|
<dd>The Debug (DBG) server is started. Subsequent use of the STRTCPSVR command specifying SERVER(*DBG) will result in a diagnostic message if the DBG server has already been started.
|
|
</dd>
|
|
<dt><b>*DDM</b></dt>
|
|
<dd>The Distributed Data Manager (DDM) server is started. Subsequent use of the STRTCPSVR command specifying SERVER(*DDM) will result in a diagnostic message if the DDM server job has already been started.
|
|
</dd>
|
|
<dt><b>*DHCP</b></dt>
|
|
<dd>The Dynamic Host Configuration Protocol (DHCP) server is started. Subsequent use of the STRTCPSVR command specifying SERVER(*DHCP) will result in a diagnostic message if the DHCP server has already been started.
|
|
</dd>
|
|
<dt><b>*DIRSRV</b></dt>
|
|
<dd>The Lightweight Directory Access Protocol (LDAP) server is started. The LDAP server is also known as the directory services (DIRSRV) server. Subsequent use of the STRTCPSVR command specifying SERVER(*DIRSRV) will result in a diagnostic message if the LDAP server has already been started.
|
|
</dd>
|
|
<dt><b>*DLFM</b></dt>
|
|
<dd>The DataLink File Manager (DLFM) server is started. Subsequent use of the STRTCPSVR command specifying SERVER(*DLFM) will result in a diagnostic message if the DLFM server has already been started.
|
|
</dd>
|
|
<dt><b>*DNS</b></dt>
|
|
<dd>One or more instances of the Domain Name System (DNS) server are started. See the parameter documentation for the <b>DNS server (DNSSVR)</b> parameter for more information on DNS server instances. Subsequent use of the STRTCPSVR command specifying SERVER(*DNS) will result in a diagnostic message if the DNS server has already been started.
|
|
</dd>
|
|
<dt><b>*DOMINO</b></dt>
|
|
<dd>The Lotus Domino (DOMINO) server is started. Subsequent use of the STRTCPSVR command specifying SERVER(*DOMINO) will result in a diagnostic message if the DOMINO server has already been started.
|
|
</dd>
|
|
<dt><b>*EDRSQL</b></dt>
|
|
<dd>The Extended Dynamic Remote SQL (EDRSQL) server is started. Subsequent use of the STRTCPSVR command specifying SERVER(*EDRSQL) will result in a diagnostic message if the EDRSQL server has already been started.
|
|
</dd>
|
|
<dt><b>*FTP</b></dt>
|
|
<dd>The File Transfer Protocol (FTP) servers are started, based on the number of servers configured with the Change FTP Attributes (CHGFTPA) command. Subsequent use of the STRTCPSVR command specifying SERVER(*FTP) will start one additional FTP server.
|
|
<p>
|
|
<b>Note: </b>Having more than one FTP server job running can improve the performance of initiating a session when multiple users attempt to connect to the server in a short period of time.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*HOD</b></dt>
|
|
<dd>The IBM Host On-Demand (HOD) server is started. Subsequent use of the STRTCPSVR command specifying SERVER(*HOD) will result in a diagnostic message if the HOD server has already been started.
|
|
</dd>
|
|
<dt><b>*HTTP</b></dt>
|
|
<dd>One or more instances of the World Wide Web HyperText Transfer Protocol (HTTP) server is started. See the parameter documentation for the <b>HTTP server (HTTPSVR)</b> parameter for more information on HTTP server instances. Subsequent use of the STRTCPSVR command specifying SERVER(*HTTP) will result in a diagnostic message if the HTTP server has already been started.
|
|
</dd>
|
|
<dt><b>*IBMHELP</b></dt>
|
|
<dd>The IBM Online Help and Eclipse Information Center (IBMHELP) server is started. Subsequent use of the STRTCPSVR command specifying SERVER(*IBMHELP) will not start any additional servers.
|
|
</dd>
|
|
<dt><b>*INETD</b></dt>
|
|
<dd>The Internet Daemon (INETD) is started. Subsequent use of the STRTCPSVR command specifying SERVER(*INETD) will result in a diagnostic message if the INETD server has already been started.
|
|
</dd>
|
|
<dt><b>*LPD</b></dt>
|
|
<dd>The line printer daemon (LPD) servers are started, based on the number of servers configured with the Change LPD Attributes (CHGLPDA) command. Subsequent usage of the STRTCPSVR command specifying SERVER(*LPD) will start one additional LPD server.
|
|
<p>
|
|
<b>Note: </b>LPD works most efficiently when two or more servers are running. Running only one server will work, but no jobs can be received while a current job is running. If a large print job is running, new jobs have to wait before LPD is ready to accept any new LPR requests.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*MGTC</b></dt>
|
|
<dd>The Management Central (MGTC) server is started. Subsequent use of the STRTCPSVR command specifying SERVER(*MGTC) will result in a diagnostic message if the MGTC server has already been started.
|
|
</dd>
|
|
<dt><b>*NETSVR</b></dt>
|
|
<dd>The NetServer (NETSVR) server is started. Subsequent use of the STRTCPSVR command specifying SERVER(*NETSVR) will result in a diagnostic message if the NETSVR server has already been started.
|
|
</dd>
|
|
<dt><b>*NSLD</b></dt>
|
|
<dd>The Network Station Login Daemon (NSLD) server is started. Subsequent use of the STRTCPSVR command specifying SERVER(*NSLD) will result in a diagnostic message if the NSLD server has already been started.
|
|
</dd>
|
|
<dt><b>*NTP</b></dt>
|
|
<dd>The Simple Network Time Protocol (SNTP) services servers are started. See the parameter documentation for the <b>SNTP service (NTPSRV)</b> parameter for more information on specifying which SNTP services to start. Subsequent use of the STRTCPSVR command specifying SERVER(*NTP) will result in a diagnostic message if the indicated SNTP services server has already been started.
|
|
<p><b>Note:</b> If both client and server SNTP services have been started, running the ENDTCPSVR command specifying SERVER(*NTP) will end both client and server services. To change which SNTP services are active, run the End TCP/IP Server (ENDTCPSVR) command specifying SERVER(*NTP), which will end all active SNTP services. Then run the STRTCPSVR command again, specifying SERVER(*NTP), and either NTPSRV(*CLIENT) or NTPSRV(*SERVER).
|
|
</p>
|
|
</dd>
|
|
<dt><b>*ODPA</b></dt>
|
|
<dd>The On-Demand Platform Authentication (ODPA) server is started. Subsequent use of the STRTCPSVR SERVER(*ODPA) command results in a diagnostic message if the ODPA server has already been started.
|
|
</dd>
|
|
<dt><b>*ONDMD</b></dt>
|
|
<dd>The On Demand Server (ONDMD) is started. Subsequent use of the STRTCPSVR command specifying SERVER(*ONDMD) will result in a diagnostic message if the ONDMD server has already been started.
|
|
</dd>
|
|
<dt><b>*POP</b></dt>
|
|
<dd>The Post Office Protocol (POP) version 3 mail servers are started based on the number of servers configured with the Change POP Server Attributes (CHGPOPA) command. Subsequent use of the STRTCPSVR command specifying SERVER(*POP) will start one additional POP server.
|
|
</dd>
|
|
<dt><b>*QOS</b></dt>
|
|
<dd>The Quality of Service (QoS) server is started. Subsequent use of the STRTCPSVR SERVER(*QOS) command results in a diagnostic message if the QoS server has already been started.
|
|
</dd>
|
|
<dt><b>*REXEC</b></dt>
|
|
<dd>The Remote Execution (REXEC) servers are started based on the number of servers configured with the Change REXEC Attributes (CHGRXCA) command. Subsequent use of the STRTCPSVR command specifying SERVER(*REXEC) will start one additional REXEC server.
|
|
</dd>
|
|
<dt><b>*ROUTED</b></dt>
|
|
<dd>The Router Daemon (ROUTED) server is started. Subsequent use of the STRTCPSVR command specifying SERVER(*ROUTED) will result in a diagnostic message if the RouteD server has already been started.
|
|
</dd>
|
|
<dt><b>*SMTP</b></dt>
|
|
<dd>The Simple Mail Transfer Protocol (SMTP) client and server jobs are started. Additional SMTP client and server jobs cannot be started. Subsequent use of the STRTCPSVR SERVER(*SMTP) command results in a diagnostic message if the SMTP server jobs have already been started.
|
|
</dd>
|
|
<dt><b>*SNMP</b></dt>
|
|
<dd>The Simple Network Management Protocol (SNMP) agent server is started. Subsequent use of the STRTCPSVR command specifying SERVER(*SNMP) will result in a diagnostic message if the SNMP server has already been started.
|
|
</dd>
|
|
<dt><b>*SRVSPTPRX</b></dt>
|
|
<dd>The Service and Support Proxy (SRVSPTPRX) server is started. Subsequent use of the STRTCPSVR command specifying SERVER(*SRVSPTPRX) will result in a diagnostic message if the SRVSPTPRX server has already been started.
|
|
</dd>
|
|
<dt><b>*TCM</b></dt>
|
|
<dd>One or more instances of the Triggered Cache Manager (TCM) server is started. See the parameter documentation for the <b>TCM server (TCMSVR)</b> parameter for more information on specifying which TCM server instances to start. Subsequent use of the STRTCPSVR command specifying SERVER(*TCM) will result in a diagnostic message if the indicated TCM server instance has already been started.
|
|
</dd>
|
|
<dt><b>*TELNET</b></dt>
|
|
<dd>The TELNET server is started. Subsequent use of the STRTCPSVR command specifying SERVER(*TELNET) will start one additional TELNET server.
|
|
<p>
|
|
<b>Note: </b>Having more than one TELNET server job running reduces the chances of having connection attempts refused.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*TFTP</b></dt>
|
|
<dd>The Trivial File Transfer Protocol (TFTP) servers are started based on the number of servers configured with the Change TFTP Attributes (CHGTFTPA) command. Subsequent use of the STRTCPSVR SERVER(*TFTP) command results in a diagnostic message if the TFTP server jobs have already been started.
|
|
</dd>
|
|
<dt><b>*VPN</b></dt>
|
|
<dd>The Virtual Private Network (VPN) server is started. Subsequent use of the STRTCPSVR command specifying SERVER(*VPN) will result in a diagnostic message if the VPN server has already been started.
|
|
</dd>
|
|
<dt><b>*WEBFACING</b></dt>
|
|
<dd>The WebFacing (WEBFACING) server is started. Subsequent use of the STRTCPSVR command specifying SERVER(*WEBFACING) will result in a diagnostic message if the WebFacing server has already been started.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRTCPSVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRTCPSVR.RESTART"></a>
|
|
<h3>Restart server (RESTART)</h3>
|
|
<p>Specifies whether to restart the selected server when the STRTCPSVR command is run.
|
|
</p>
|
|
<p>The SERVER parameter value specified must be one of the following:
|
|
</p>
|
|
<ul>
|
|
<li>*ALL
|
|
</li>
|
|
<li>*DNS
|
|
</li>
|
|
<li>*DHCP
|
|
</li>
|
|
<li>*HTTP
|
|
</li>
|
|
<li>*QOS
|
|
</li>
|
|
</ul>
|
|
<p>or this parameter is ignored.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>Do not restart any server.
|
|
</dd>
|
|
<dt><b>*HTTP</b></dt>
|
|
<dd>Restart the HTTP server using the values specified on the <b>HTTP server (HTTPSVR)</b> parameter. If the server is not currently running when the STRTCPSVR command is run, this parameter is ignored and the server is started.
|
|
</dd>
|
|
<dt><b>*DHCP</b></dt>
|
|
<dd>The Dynamic Host Configuration Protocol (DHCP) server job that is already running will reprocess its configuration file and initialize with any changes that it found. If the DHCP processing server is not currently running or cannot be successfully interrupted for the restart, a diagnostic message will be issued.
|
|
</dd>
|
|
<dt><b>*DNS</b></dt>
|
|
<dd>A Domain Name System (DNS) server job that is already running will reprocess its configuration file and initialize with any changes that it found. If the DNS processing server is not currently running or cannot be successfully interrupted for the restart, a diagnostic message will be issued.
|
|
</dd>
|
|
<dt><b>*QOS</b></dt>
|
|
<dd>The Quality of Service (QoS) server job that is already running will reprocess its configuration file and initialize with any changes that it found. If the QoS processing server is not currently running or cannot be successfully interrupted for the restart, a diagnostic message will be issued.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRTCPSVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRTCPSVR.HTTPSVR"></a>
|
|
<h3>HTTP server (HTTPSVR)</h3>
|
|
<p>Specifies the HTTP server instance to be started as well as any additional startup values to be used by the HTTP server to control the server instance. (This server is also known as the IBM HTTP Server).
|
|
</p>
|
|
<p>If multiple HTTP server instances have been defined, you can choose to start all instances, or start one specific instance by specifying the instance name to be started.
|
|
</p>
|
|
<p>For more information on the HTTP Server, visit the HTTP Server homepage: <i>http://www.ibm.com/eserver/iseries/software/http</i>
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All defined instances of the HTTP server will be started.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Server instance</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ADMIN</b></dt>
|
|
<dd>The Administration Server will be started. The Administration Server is an instance of the HTTP server that allows administration of certain system functions using a Web browser.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the HTTP server instance to be started.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Instance startup values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No additional startup values are defined.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the additional startup values to be used for this server instance. These values will be used to override previously-defined server startup values for the specified server instance.
|
|
<p>
|
|
<b>Note: </b>The user must have input/output system configuration (*IOSYSCFG) special authority to specify overrides. If instance startup values are specified and the user does not have *IOSYSCFG authority, the start request will be rejected.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>IBM recommends that you use these overrides with caution; they are intended only for special circumstances. To specify startup values, IBM recommends you use the IBM HTTP Server Administration web-based interface rather than this command. Startup parameter values override specific server instance values, configuration directive values, global server values, and default values.
|
|
</p>
|
|
<p>Instance startup values for the HTTP Server (powered by Apache).
|
|
</p>
|
|
<dl>
|
|
<dt><b>-netccsid [nnn]</b></dt>
|
|
<dd>Overrides the DefaultNetCCSID directive
|
|
</dd>
|
|
<dt><b>-fsccsid [nnn]</b></dt>
|
|
<dd>Overrides the default DefaultFsCCSID directive
|
|
</dd>
|
|
<dt><b>-d [serverroot]</b></dt>
|
|
<dd>Set the initial value for the ServerRoot variable to serverroot. The default is /QIBM/UserData/HTTPA/logs.
|
|
</dd>
|
|
<dt><b>-f [configuration]</b></dt>
|
|
<dd>Use the values in the configuration on startup. If the configuration does not begin with a /, then it is treated as a path relative to the ServerRoot. The default is conf/httpd.conf.
|
|
</dd>
|
|
<dt><b>-C [directive]</b></dt>
|
|
<dd>Process the given "directive" (just as if it had been part of a configuration file) before actually reading the regular configuration files.
|
|
</dd>
|
|
<dt><b>-c [directive]</b></dt>
|
|
<dd>Process the given "directive" after reading all the regular configuration files.
|
|
</dd>
|
|
<dt><b>-vv [verbose level service trace]</b></dt>
|
|
<dd>Turn on verbose level service tracing .
|
|
</dd>
|
|
<dt><b>-vi [informational level service trace]</b></dt>
|
|
<dd>Turn on informational level service tracing.
|
|
</dd>
|
|
<dt><b>-ve [error level service trace]</b></dt>
|
|
<dd>Turn on error level service tracing.
|
|
</dd>
|
|
<dt><b>-V [no value is provided]</b></dt>
|
|
<dd>Display the base version of the server, its build date, and a list of compile time settings which influence the behavior and performance of the server, then exit.
|
|
</dd>
|
|
<dt><b>-l [no value is provided]</b></dt>
|
|
<dd>Display a list of all modules compiled into the server, then exit.
|
|
</dd>
|
|
<dt><b>-t [no value is provided]</b></dt>
|
|
<dd>Test the configuration file syntax (i.e., read all configuration files and interpret them) but do not start the server. If the configuration contains errors, display an error message and exit with a non-zero exit status, otherwise display "Syntax OK" and terminate with a zero exit status. This command checks to see if all DocumentRoot entries exist and are directories.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRTCPSVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRTCPSVR.DNSSVR"></a>
|
|
<h3>DNS server (DNSSVR)</h3>
|
|
<p>Specifies the Domain Name System (DNS) server instance to be started as well as any additional startup values to be used by the DNS server to control the server instance.
|
|
</p>
|
|
<p>If multiple DNS server instances have been defined, you can choose to start all instances, or start one specific instance by specifying the instance name to be started.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All defined instances of the DNS server will be started.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Server instance</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the name of the DNS server instance to be started.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Instance startup values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No additional startup values are defined.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specifies additional startup values to be used for this server instance. These values will be used to override previously-defined server startup values for the specified server instance.
|
|
<p>
|
|
<b>Note: </b>The user must have input/output system configuration (*IOSYSCFG) special authority to specify overrides. If instance startup values are specified and the user does not have *IOSYSCFG authority, the start request will be rejected.
|
|
</p>
|
|
<p>The list of instance startup values for the DNS Server follows:
|
|
</p>
|
|
<dl>
|
|
<dt><b>-d [n]</b></dt>
|
|
<dd>where n is a number from 1 to 11. This sets the debug level of the server to start.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRTCPSVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRTCPSVR.TCMSVR"></a>
|
|
<h3>TCM server (TCMSVR)</h3>
|
|
<p>Specifies the Triggered Cache Manager (TCM) server instance to be started as well as any additional startup values to be used by the TCM server to control the server instance.
|
|
</p>
|
|
<p>If multiple TCM server instances have been defined, you can choose to start all instances, or start one specific instance by specifying the instance name to be started.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No defined instances of the TCM server will be started.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Instance name</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All defined instances for the TCM server will be started.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the name of the TCM server instance to be started.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Instance startup values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No additional startup values are defined.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the additional startup values to be used for this server instance. These values will be used to override previously-defined server startup values for the specified instance name.
|
|
<p>
|
|
<b>Note: </b>The user must have input/output system configuration (*IOSYSCFG) special authority to specify overrides. If instance startup values are specified and the user does not have *IOSYSCFG authority, the start request will be rejected.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRTCPSVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRTCPSVR.TOMCATSVR"></a>
|
|
<h3>ASFTOMCAT server (TOMCATSVR)</h3>
|
|
<p>Specifies the Tomcat server instance to be started.
|
|
</p>
|
|
<p>If multiple Tomcat server instance names have been defined, you can choose to start all instances, or start one specific instance by specifying the instance name to be started.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No defined instances of the Tomcat server will be started.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Server instance name</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All defined instances for the Tomcat server will be started.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the name of the Tomcat server instance to be started.
|
|
<p>
|
|
<b>Note: </b>The user must have input/output system configuration (*IOSYSCFG) special authority to specify overrides. If instance startup values are specified and the user does not have *IOSYSCFG authority, the start request will be rejected.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRTCPSVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRTCPSVR.NTPSRV"></a>
|
|
<h3>SNTP service (NTPSRV)</h3>
|
|
<p>Specifies the Simple Network Time Protocol (SNTP) services to be started.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CLIENT</u></b></dt>
|
|
<dd>The SNTP client is started.
|
|
</dd>
|
|
<dt><b>*SERVER</b></dt>
|
|
<dd>The SNTP server is started.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>Both the client and server are started.
|
|
</dd>
|
|
<dt><b>*CFGFILE</b></dt>
|
|
<dd>The values of the keywords Client Autostart (AUTOSTART) and Server Autostart (SVRAUTOSTR) in the Change SNTP Attributes (CHGNTPA) command configuration file are used to determine what services to start. If the value is set to *YES, that service is started.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRTCPSVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRTCPSVR.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Starting All TCP/IP Servers with AUTOSTART(*YES)</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRTCPSVR SERVER(*AUTOSTART)
|
|
</pre>
|
|
</p>
|
|
<p>This command starts all of the TCP/IP application servers that have the AUTOSTART attribute in the application configuration set to *YES.
|
|
</p>
|
|
<p><b>Example 2: Starting All TCP/IP Servers</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRTCPSVR SERVER(*ALL)
|
|
</pre>
|
|
</p>
|
|
<p>This command starts all of the TCP/IP application servers that have been configured. For example: If the Change FTP Attributes (CHGFTPA) command was previously used to configure two FTP servers, both servers are started when STRTCPSVR is issued. This example is also true for other TCP/IP application servers.
|
|
</p>
|
|
<p>Where appropriate, the number of servers to start is based on the number of servers configured for the server being started.
|
|
</p>
|
|
<p><b>Example 3: Starting the TELNET Server</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRTCPSVR SERVER(*TELNET)
|
|
</pre>
|
|
</p>
|
|
<p>This command starts the TCP/IP TELNET application server. If the TELNET server was previously started, one additional TELNET server job is started.
|
|
</p>
|
|
<p><b>Example 4: Restarting the HTTP Server</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRTCPSVR SERVER(*HTTP) RESTART(*HTTP)
|
|
</pre>
|
|
</p>
|
|
<p>This command restarts the TCP/IP HTTP application server for all instances of the HTTP server. If the HTTP server was not currently running, then all defined instances of the HTTP server would be started.
|
|
</p>
|
|
<p><b>Example 5: Starting an HTTP Server Instance</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRTCPSVR SERVER(*HTTP) HTTPSVR('http1')
|
|
</pre>
|
|
</p>
|
|
<p>This command starts the TCP/IP HTTP application server instance named 'http1' using the startup values previously defined for this server instance.
|
|
</p>
|
|
<p><b>Example 6: Specifying Startup Values for an HTTP Instance</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRTCPSVR SERVER(*HTTP) HTTPSVR(HTTP1 '-p 81 -sslport 443')
|
|
</pre>
|
|
</p>
|
|
<p>This command starts the TCP/IP HTTP application server instance named HTTP1, and specifies that the server instance should listen on port 81 for unsecure requests and on port 443 for secure requests. The ports defined here will override any previously defined ports to be used by this server instance.
|
|
</p>
|
|
<p><b>Example 7: Starting a DNS Server Instance</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRTCPSVR SERVER(*DNS) DNSSVR('dns1')
|
|
</pre>
|
|
</p>
|
|
<p>This command starts the TCP/IP DNS application server instance named 'dns1' using the startup values previously defined for this server instance.
|
|
</p>
|
|
<p><b>Example 8: Specifying Startup Values for a DNS Instance</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRTCPSVR SERVER(*DNS) DNSSVR(DNS1 '-d 5')
|
|
</pre>
|
|
</p>
|
|
<p>This command starts the TCP/IP DNS application server instance named DNS1, and specifies that the server instance should turn on debug level 5.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRTCPSVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRTCPSVR.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF3894</b></dt>
|
|
<dd>Cancel reply received for message &1.
|
|
</dd>
|
|
<dt><b>TCP1A11</b></dt>
|
|
<dd>&1 failed.
|
|
</dd>
|
|
<dt><b>TCP1A77</b></dt>
|
|
<dd>&1 completed successfully; however errors occurred.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRTCPSVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|