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

425 lines
14 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>End TCP/IP Server (ENDTCPSVR)</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="ENDTCPSVR.Top_Of_Page"></a>
<h2>End TCP/IP Server (ENDTCPSVR)</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="#ENDTCPSVR.PARAMETERS.TABLE">Parameters</a><br>
<a href="#ENDTCPSVR.COMMAND.EXAMPLES">Examples</a><br>
<a href="#ENDTCPSVR.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="ENDTCPSVR"></a>
<p>The ENDTCPSVR command is used to end the TCP/IP application server jobs that are specified in the SERVER parameter. If the jobs have any current active connections, these connections are ended immediately. If the ENDTCPSVR command is used to end a server that is not active, a diagnostic message may be returned.
</p>
<p>The End TCP/IP Server command can only be used when TCP/IP is fully operational. The interface server job QTCPIP must be available. When the system is in restricted state, this command is not allowed.
</p>
<p>Additional servers can automatically be added to the list of servers that ENDTCPSVR 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="#ENDTCPSVR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ENDTCPSVR.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="#ENDTCPSVR.SERVER"><b>SERVER</b></a></td>
<td valign="top">Server application</td>
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 300 repetitions): <i>Character value</i></td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top" rowspan="2"><a href="#ENDTCPSVR.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="2">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" rowspan="2"><a href="#ENDTCPSVR.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="2">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Server instance</td>
<td valign="top">
<i>Name</i></td>
</tr>
<tr>
<td valign="top" rowspan="2"><a href="#ENDTCPSVR.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="2">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" rowspan="2"><a href="#ENDTCPSVR.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>
</table>
<table width="100%">
<tr><td align="right"><a href="#ENDTCPSVR.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="ENDTCPSVR.SERVER"></a>
<h3>Server application (SERVER)</h3>
<p>Specifies which of the TCP/IP application server jobs is to be ended by this command.
</p>
<p>Additional TCP/IP servers could also be available if they were added by running the Add TCP/IP Server (ADDTCPSVR) command.
</p>
<p>For a list of all supported values for this parameter, you can press F4 (Prompt) for this parameter when prompting this command.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All of the TCP/IP server jobs are ended.
</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 ended.
</dd>
<dt><b>*BOOTP</b></dt>
<dd>The bootstrap protocol (BOOTP) server is ended.
</dd>
<dt><b>*CIMOM</b></dt>
<dd>The Common Information Model Object Manager (CIMOM) server is ended.
</dd>
<dt><b>*DBG</b></dt>
<dd>The Debug server is ended.
</dd>
<dt><b>*DDM</b></dt>
<dd>The Distributed Data Management (DDM) server job is ended.
</dd>
<dt><b>*DHCP</b></dt>
<dd>The Dynamic Host Configuration Protocol (DHCP) server job is ended.
</dd>
<dt><b>*DIRSRV</b></dt>
<dd>The LDAP directory services (DIRSVR) server job is ended.
</dd>
<dt><b>*DLFM</b></dt>
<dd>The DataLink File Manager (DLFM) server job is ended.
</dd>
<dt><b>*DNS</b></dt>
<dd>The Domain Name System (DNS) server job is ended unless:
<ul>
<li>You specify a specific server instance name on the DNSSVR parameter. When you specify a specific server instance, only that instance is ended.
</li>
</ul>
<p>To end all instances of the DNS server, specify one of the following:
</p>
<p>
<pre>
ENDTCPSVR SERVER(*DNS)
ENDTCPSVR SERVER(*DNS) DNSSVR(*ALL)
</pre>
</p>
</dd>
<dt><b>*DOMINO</b></dt>
<dd>The Lotus Domino (DOMINO) server is ended.
</dd>
<dt><b>*EDRSQL</b></dt>
<dd>The Extended Dynamic Remote SQL (EDRSQL) server is ended.
</dd>
<dt><b>*FTP</b></dt>
<dd>All File Transfer Protocol (FTP) server jobs are ended.
</dd>
<dt><b>*HOD</b></dt>
<dd>The Host On Demand (HOD) server is ended.
</dd>
<dt><b>*HTTP</b></dt>
<dd>All instances of the HyperText Transfer Protocol (HTTP) server are ended unless:
<ul>
<li>You specify a specific server instance name on the HTTPSVR parameter. When you specify a specific server instance, only that instance is ended.
</li>
<li>You specify the *ADMIN value on the HTTPSVR parameter. When you specify HTTPSVR(*ADMIN), only the administration server is ended.
</li>
</ul>
<p>To end all instances of the HTTP server, specify one of the following:
</p>
<p>
<pre>
ENDTCPSVR SERVER(*HTTP)
ENDTCPSVR SERVER(*HTTP) HTTPSVR(*ALL)
</pre>
</p>
<p>The HTTP server is also known as the IBM HTTP Server.
</p>
</dd>
<dt><b>*IBMHELP</b></dt>
<dd>The IBM Online Help and Eclipse Information Center (IBMHELP) server is ended.
</dd>
<dt><b>*INETD</b></dt>
<dd>The Internet Daemon (INETD) server is ended.
</dd>
<dt><b>*LPD</b></dt>
<dd>All line printer daemon (LPD) servers are ended.
</dd>
<dt><b>*MGTC</b></dt>
<dd>The Management Central (MGTC) server is ended.
</dd>
<dt><b>*NETSVR</b></dt>
<dd>The NetServer (NETSVR) server is ended.
</dd>
<dt><b>*NSLD</b></dt>
<dd>The Network Station Login Daemon (NSLD) server is ended.
</dd>
<dt><b>*NTP</b></dt>
<dd>All Simple Network Time Protocol (SNTP) services servers are ended.
<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. If you wanted to end just the client or just the server SNTP service, you will need to run the Start TCP/IP Server (STRTCPSVR) command again, specifying SERVER(*NTP) and NTPSRV(*CLIENT) or NTPSRV(SERVER).
</p>
</dd>
<dt><b>*ODPA</b></dt>
<dd>The On-Demand Platform Authentication (ODPA) server is ended.
</dd>
<dt><b>*ONDMD</b></dt>
<dd>The OnDemand (ONDMD) server job is ended.
</dd>
<dt><b>*POP</b></dt>
<dd>All Post Office Protocol (POP3) mail server jobs are ended.
</dd>
<dt><b>*QOS</b></dt>
<dd>The Quality of Service (QOS) server is ended.
</dd>
<dt><b>*REXEC</b></dt>
<dd>All Remote Execution (REXEC) servers are ended.
</dd>
<dt><b>*ROUTED</b></dt>
<dd>The Router Daemon (ROUTED) server is ended.
</dd>
<dt><b>*SMTP</b></dt>
<dd>All jobs associated with Simple Mail Transfer Protocol (SMTP) in the QSYSWRK subsystem are ended. The bridge job in the QSNADS subsystem is not ended.
</dd>
<dt><b>*SNMP</b></dt>
<dd>All jobs associated with the Simple Network Management Protocol (SNMP) agent in the QSYSWRK subsystem are ended.
</dd>
<dt><b>*SRVSPTPRX</b></dt>
<dd>The Service and Support Proxy (SRVSPTPRX) server is ended.
</dd>
<dt><b>*TCM</b></dt>
<dd>The Triggered Cache Manager (TCM) server is ended unless:
<ul>
<li>You specify a specific server instance name on the TCMSVR parameter. When you specify a specific server instance, only that instance is ended.
</li>
</ul>
<p>To end all instances of the TCM server, specify:
</p>
<p>
<pre>
ENDTCPSVR SERVER(*TCM) TCMSVR(*ALL)
</pre>
</p>
</dd>
<dt><b>*TELNET</b></dt>
<dd>All TELNET server jobs are ended.
</dd>
<dt><b>*TFTP</b></dt>
<dd>All Trivial File Transfer Protocol (TFTP) server jobs are ended.
</dd>
<dt><b>*VPN</b></dt>
<dd>The Virtual Private Network (VPN) server is ended.
</dd>
<dt><b>*WEBFACING</b></dt>
<dd>The WebFacing server is ended.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDTCPSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ENDTCPSVR.HTTPSVR"></a>
<h3>HTTP server (HTTPSVR)</h3>
<p>Specifies the name of the HTTP server instance to end. The SERVER parameter specified must be *HTTP or this parameter is ignored.
</p>
<p>If multiple HTTP server instances have been defined, you can choose to end all instances, or end one specific instance by specifying the instance name to be ended.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All instances of the HTTP server that are currently running are ended.
</dd>
<dt><b>*ADMIN</b></dt>
<dd>The Administration Server is ended. 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 ended.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDTCPSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ENDTCPSVR.DNSSVR"></a>
<h3>DNS server (DNSSVR)</h3>
<p>Specifies the name of the DNS server instance to end. The SERVER parameter specified must be *DNS or this parameter is ignored.
</p>
<p>If multiple DNS server instances have been defined, you can choose to end all instances, or end one specific instance by specifying the instance name to be ended.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All instances of the DNS server that are currently running are ended.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the DNS server instance to be ended.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDTCPSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ENDTCPSVR.TCMSVR"></a>
<h3>TCM server (TCMSVR)</h3>
<p>Specifies the name of the TCM server instance to end. The SERVER parameter specified must be *TCM or this parameter is ignored.
</p>
<p>If multiple TCM server instances have been defined, you can choose to end all instances, or end one specific instance by specifying the instance name to be ended.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No instances of the TCM server that are currently running are ended.
</dd>
<dt><b>*ALL</b></dt>
<dd>All instances of the TCM server that are currently running are ended.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the TCM server instance to be ended.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDTCPSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ENDTCPSVR.TOMCATSVR"></a>
<h3>ASFTOMCAT server (TOMCATSVR)</h3>
<p>Specifies the name of the Tomcat server instance to end. The SERVER parameter specified must be *ASFTOMCAT or this parameter is ignored.
</p>
<p>If multiple Tomcat server instances have been defined, you can choose to end all instances, or end one specific instance by specifying the instance name to be ended.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No instances of the Tomcat server that are currently running are ended.
</dd>
<dt><b>*ALL</b></dt>
<dd>All instances of the Tomcat server that are currently running are ended.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the Tomcat server instance to be ended.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDTCPSVR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ENDTCPSVR.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Ending All TCP/IP Servers</b>
</p>
<p>
<pre>
ENDTCPSVR SERVER(*ALL)
</pre>
</p>
<p>This command ends all active TCP/IP application server jobs.
</p>
<p><b>Example 2: Ending the LPD Servers</b>
</p>
<p>
<pre>
ENDTCPSVR SERVER(*LPD)
</pre>
</p>
<p>This command ends the TCP/IP LPD application server jobs.
</p>
<p><b>Example 3: Ending a Specific HTTP Server Instance</b>
</p>
<p>
<pre>
ENDTCPSVR SERVER(*HTTP) HTTPSVR(http1)
</pre>
</p>
<p>This command ends the TCP/IP HTTP application server instance named 'http1'.
</p>
<p><b>Example 4: Ending a Specific DNS Server Instance</b>
</p>
<p>
<pre>
ENDTCPSVR SERVER(*DNS) DNSSVR('dns1')
</pre>
</p>
<p>This command ends the TCP/IP DNS application server instance named 'dns1'.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDTCPSVR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ENDTCPSVR.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 &amp;1.
</dd>
<dt><b>TCP1A0A</b></dt>
<dd>&amp;1 ended abnormally. Reason code is &amp;2.
</dd>
<dt><b>TCP1A11</b></dt>
<dd>&amp;1 failed.
</dd>
<dt><b>TCP1A77</b></dt>
<dd>&amp;1 completed successfully; however errors occurred.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDTCPSVR.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>