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

408 lines
15 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<!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 (STRTCP)</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="STRTCP.Top_Of_Page"></a>
<h2>Start TCP/IP (STRTCP)</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="#STRTCP.PARAMETERS.TABLE">Parameters</a><br>
<a href="#STRTCP.COMMAND.EXAMPLES">Examples</a><br>
<a href="#STRTCP.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="STRTCP"></a>
<p>The Start TCP/IP (STRTCP) command initializes and activates TCP/IP processing, starts the TCP/IP interfaces, starts the TCP/IP server jobs, and starts the TCP/IP Point-To-Point (PTP) profiles. A STRTCP command must be issued before any TCP/IP processing can be performed on the system. This includes Simple Network Management Protocol (SNMP) agent processing.
</p>
<p>The TCP/IP interfaces that are started are those that have set the AUTOSTART parameter to a value of *YES using the Add TCP/IP Interface (ADDTCPIFC), the Change TCP/IP Interface (CHGTCPIFC) commands, or the iSeries Navigator.
</p>
<p>The Change IPL Attributes (CHGIPLA) command with the STRTCP parameter set to a value of *YES can be used to automatically submit the STRTCP command at the completion of IPL.
</p>
<p>The TCP/IP application server jobs that can be started are:
</p>
<ul>
<li>Apache Software Foundation (ASF) Tomcat server
</li>
<li>Bootstrap Protocol (BOOTP)
</li>
<li>Common Information Model Object Manager (CIMOM)
</li>
<li>DataLink File Manager (DLFM)
</li>
<li>Debug Server (DBG)
</li>
<li>Directory Services (DIRSRV)
</li>
<li>Distributed Data Management (DDM)
</li>
<li>Domain Name Server (DNS)
</li>
<li>Domino
</li>
<li>Dynamic Host Configuration Protocol (DHCP)
</li>
<li>Extended Dynamic Remote SQL (EDRSQL)
</li>
<li>File Transfer Protocol (FTP)
</li>
<li>Hypertext Transfer Protocol (HTTP)
</li>
<li>IBM Host On-Demand (HOD)
</li>
<li>IBM Online Help and Eclipse Information Center (IBMHELP)
</li>
<li>Internet Daemon (INETD)
</li>
<li>Line Printer Daemon (LPD)
</li>
<li>Management Central (MGTC)
</li>
<li>NetServer (NETSVR)
</li>
<li>Network Station Login Daemon (NSLD)
</li>
<li>On Demand (ONDMD)
</li>
<li>On-Demand Platform Authentication (ODPA)
</li>
<li>Post Office Protocol (POP)
</li>
<li>Quality of Service (QoS)
</li>
<li>Remote Execution (REXEC)
</li>
<li>Router Daemon (ROUTED)
</li>
<li>Service and Support Proxy (SRVSPTPRX)
</li>
<li>Simple Mail Transfer Protocol (SMTP)
</li>
<li>Simple Network Management Protocol (SNMP) agent
</li>
<li>Simple Network Time Protocol (NTP)
</li>
<li>Triggered Cache Manager (TCM)
</li>
<li>Trivial File Transfer Protocol (TFTP)
</li>
<li>Virtual Private Network (VPN)
</li>
<li>Virtual terminal support (TELNET)
</li>
<li>WebFacing (WEBFACING)
</li>
</ul>
<p>The Start TCP/IP command only starts a TCP/IP application job if the AUTOSTART attribute in the application's configuration is set to *YES when the command is issued. No TCP/IP application jobs are started in the QSYSWRK subsystem if any of the following is true:
</p>
<ul>
<li>The TCP/IP licensed program product is not installed.
</li>
<li>All of the TCP/IP applications have an AUTOSTART configuration attribute value of *NO.
</li>
<li>STRSVR(*NO) is specified for the STRTCP command. See the description of the STRSVR parameter below.
</li>
</ul>
<p>Use the commands or interfaces listed below to change the configuration for an application so that it starts automatically when the Start TCP/IP command is issued.
</p>
<ul>
<li>For the SNMP agent use the Change SNMP Attributes (CHGSNMPA) command specifying AUTOSTART(*YES)
</li>
<li>For the RouteD server use the Change RouteD Attributes (CHGRTDA) command specifying AUTOSTART(*YES)
</li>
<li>For the BOOTP server use the Change BOOTP Attributes (CHGBPA) command specifying AUTOSTART(*YES)
</li>
<li>For the TFTP server use the Change TFTP Attributes (CHGTFTPA) command specifying AUTOSTART(*YES)
</li>
<li>For the DNS server use the Change DNS Attributes (CHGDNSA) command specifying AUTOSTART(*YES)
</li>
<li>For the DHCP server use the Change DHCP Attributes (CHGDHCPA) command specifying AUTOSTART(*YES)
</li>
<li>For the DDM server use the Change DDM Attributes (CHGDDMTCPA) command specifying AUTOSTART(*YES)
</li>
<li>For the TELNET application use the Change TELNET Attributes (CHGTELNA) command specifying AUTOSTART(*YES)
</li>
<li>For the FTP application use the Change FTP Attributes (CHGFTPA) command specifying AUTOSTART(*YES)
</li>
<li>For the SMTP application use the Change SMTP Attributes (CHGSMTPA) command specifying AUTOSTART(*YES)
</li>
<li>For the LPD application use the Change LPD Attributes (CHGLPDA) command specifying AUTOSTART(*YES)
</li>
<li>For the HTTP server application use the Change HTTP Attributes (CHGHTTPA) command specifying AUTOSTART(*YES).
</li>
<li>For the Post Office Protocol (POP) version 3 mail servers use the Change POP Mail Server Attributes (CHGPOPA) command specifying AUTOSTART(*YES)
</li>
<li>For the REXEC server application use the Change REXEC Attributes (CHGRXCA) command specifying AUTOSTART(*YES)
</li>
<li>Change DBG server attributes, including the AUTOSTART parameter, using iSeries Navigator.
</li>
<li>Change DIRSVR server attributes, including the AUTOSTART parameter, using iSeries Navigator.
</li>
<li>Change IBMHELP server attributes, including the AUTOSTART parameter, using iSeries Navigator.
</li>
<li>Change SRVSPTPRX server attributes, including the AUTOSTART parameter, using iSeries Navigator.
</li>
<li>Change NSLD daemon attributes, including the AUTOSTART parameter, using iSeries Navigator.
</li>
<li>Change INETD daemon attributes, including the AUTOSTART parameter, using iSeries Navigator.
</li>
<li>Change MGTC daemon attributes, including the AUTOSTART parameter, using iSeries Navigator.
</li>
<li>Change ONDMD server attributes, including the AUTOSTART parameter, using iSeries Navigator.
</li>
<li>Change NETSVR attributes, including the AUTOSTART parameter, using iSeries Navigator.
</li>
<li>Change DLFM server attributes, including the AUTOSTART parameter, using iSeries Navigator.
</li>
<li>Change EDRSQL server attributes, including the AUTOSTART parameter, using iSeries Navigator.
</li>
<li>Change HOD server attributes, including the AUTOSTART parameter, using iSeries Navigator.
</li>
<li>Change ODPA server attributes, including the AUTOSTART parameter, using iSeries Navigator.
</li>
<li>Change NTP server attributes, including the AUTOSTART parameter, using iSeries Navigator.
</li>
<li>Change QoS server attributes, including the AUTOSTART parameter, using iSeries Navigator.
</li>
<li>Change TCM server attributes, including the AUTOSTART parameter, using iSeries Navigator.
</li>
<li>Change DOMINO server attributes, including the AUTOSTART parameter, using iSeries Navigator.
</li>
<li>Change WEBFACING server attributes, including the AUTOSTART parameter, using iSeries Navigator.
</li>
<li>Change CIMOM server attributes, including the AUTOSTART parameter, using iSeries Navigator.
</li>
</ul>
<p>When the STRTCP command is issued, the QTCPIP job in the QSYSWRK subsystem is started. The QTCPIP job is used for activating and deactivating TCP/IP interfaces.
</p>
<p>
<b>Note: </b>The Start TCP/IP (STRTCP) CL command does not need to be issued to use socket applications that run over an SNA network.
</p>
<p><b>Attention:</b> Before attempting to start an X.25 interface, ensure that the remote system information (RSI) for non-DDN X.25 interfaces that use a permanent virtual circuit (PVC) is configured. Use the Add TCP/IP Remote System Information (ADDTCPRSI) command to do this.
</p>
<p>Incoming data from a remote system on the X.25 network is not processed unless an RSI entry for the PVC is configured on the X.25 interface before the interface is started.
</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="#STRTCP.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="STRTCP.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="#STRTCP.STRSVR"><b>STRSVR</b></a></td>
<td valign="top">Start application servers</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STRTCP.STRIFC"><b>STRIFC</b></a></td>
<td valign="top">Start TCP/IP interfaces</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STRTCP.STRPTPPRF"><b>STRPTPPRF</b></a></td>
<td valign="top">Start point-to-point profiles</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STRTCP.STRIP6"><b>STRIP6</b></a></td>
<td valign="top">Start IPv6</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#STRTCP.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="STRTCP.STRSVR"></a>
<h3>Start application servers (STRSVR)</h3>
<p>Specifies whether or not TCP/IP application servers are started by the Start TCP/IP (STRTCP) command.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>The STRTCP command starts all TCP/IP application servers with a configuration attribute of AUTOSTART(*YES) when TCP/IP is activated.
</dd>
<dt><b>*NO</b></dt>
<dd>The STRTCP command does not start any TCP/IP application servers when TCP/IP is activated.
</dd>
</dl>
<p>
<b>Note: </b>This parameter can be used when TCP/IP application servers using AnyNet are already active on your system and you intend to also activate TCP/IP. STRTCP STRSVR(*NO) activates TCP/IP processing without starting additional TCP/IP servers.
</p>
<p>When TCP/IP or AnyNet is already active, use the Start TCP/IP Server (STRTCPSVR) command to start additional TCP/IP application servers.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRTCP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRTCP.STRIFC"></a>
<h3>Start TCP/IP interfaces (STRIFC)</h3>
<p>Specifies whether or not to activate all TCP/IP interfaces that specify AUTOSTART(*YES) when TCP/IP is activated.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>When the QTCPIP job is started by the STRTCP command, the job will attempt to activate all TCP/IP interfaces for which AUTOSTART(*YES) is specified.
</dd>
<dt><b>*NO</b></dt>
<dd>The AUTOSTART(*YES) interface parameter will be ignored. No TCP/IP interfaces will be automatically started.
</dd>
</dl>
<p>
<b>Note: </b>Specifying STRIFC(*NO) only inhibits the activation of TCP/IP interfaces. It has no effect on interfaces for other AnyNet protocols such as IP over SNA or IP over IPX.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRTCP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRTCP.STRPTPPRF"></a>
<h3>Start point-to-point profiles (STRPTPPRF)</h3>
<p>Specifies whether or not to activate all point-to-point profiles that specify a configuration attribute of AUTOSTART(*YES) when TCP/IP is activated.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>As part of the running of the STRTCP command, the Start Point-to-Point TCP/IP (STRTCPPTP) command will also be run. The STRTCPPTP command will attempt to start all of the point-to-point profiles with a configuration attribute of AUTOSTART(*YES).
</dd>
<dt><b>*NO</b></dt>
<dd>The STRTCPPTP command will not be run.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRTCP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRTCP.STRIP6"></a>
<h3>Start IPv6 (STRIP6)</h3>
<p>Specifies whether or not to activate the IPv6 portion of the TCP/IP protocol stack.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>As part of the running of the STRTCP command, the IPv6 portion of the TCP/IP protocol stack will be started. If STRIFC(*YES) is specified, then an attempt will be made to start all of the IPv6 lines and IPv6 interfaces with a configuration attribute of AUTOSTART(*YES).
</dd>
<dt><b>*NO</b></dt>
<dd>The IPv6 protocol will not be started.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRTCP.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="STRTCP.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Starting TCP/IP</b>
</p>
<p>
<pre>
STRTCP
</pre>
</p>
<p>This command initializes and activates TCP/IP processing, starts the TCP/IP interfaces, and starts the TCP/IP server jobs.
</p>
<p><b>Example 2: Starting TCP/IP and TCP/IP Servers</b>
</p>
<p>
<pre>
STRTCP STRSVR(*YES)
</pre>
</p>
<p>Because *YES is the default value for the STRSVR parameter, the result of issuing this command is identical to the Example 1.
</p>
<p><b>Example 3: Starting TCP/IP But Not the TCP/IP Servers</b>
</p>
<p>
<pre>
STRTCP STRSVR(*NO)
</pre>
</p>
<p>This will start TCP/IP processing without starting any of the TCP/IP application server jobs.
</p>
<p><b>Example 4: Starting TCP/IP in Restricted State</b>
</p>
<p>
<pre>
STRTCP STRSVR(*NO) STRIFC(*NO) STRPTPPRF(*NO) STRIP6(*YES)
</pre>
</p>
<p>This will start TCP/IP processing (both IPv4 and IPv6), even if the system is in restricted state. TCP/IP application servers and IP interfaces will not be started.
</p>
<p><b>Example 5: Starting TCP/IP without starting IPv6 processing </b>
</p>
<p>
<pre>
STRTCP STRSVR(*YES) STRIFC(*YES) STRPTPPRF(*YES) STRIP6(*NO)
</pre>
</p>
<p>This command initializes and activates TCP/IP processing (IPv4 only), starts the TCP/IP interfaces (IPv4 only) that have the AUTOSTART parameter set to *YES. Starts the TCP/IP servers that have the AUTOSTART parameter set to *YES. Starts the Point to Point profiles that have the AUTOSTART parameter set to *YES.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRTCP.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="STRTCP.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF9848</b></dt>
<dd>Cannot open file &amp;1 in library &amp;2 member &amp;3.
</dd>
<dt><b>CPF9849</b></dt>
<dd>Error while processing file &amp;1 in library &amp;2 member &amp;3.
</dd>
<dt><b>TCP1A04</b></dt>
<dd>&amp;1 currently active.
</dd>
<dt><b>TCP1A12</b></dt>
<dd>Error occurred submitting interface job.
</dd>
<dt><b>TCP1A14</b></dt>
<dd>Error occurred starting TCP/IP servers.
</dd>
<dt><b>TCP1A77</b></dt>
<dd>&amp;1 completed successfully; however errors occurred.
</dd>
<dt><b>TCP1D03</b></dt>
<dd>&amp;1 member record length not correct.
</dd>
<dt><b>TCP1D04</b></dt>
<dd>Error occurred processing member &amp;1 of &amp;2/&amp;3.
</dd>
<dt><b>TCP9999</b></dt>
<dd>Internal system error in program &amp;1.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRTCP.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>