272 lines
12 KiB
HTML
272 lines
12 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 Point-to-Point TCP/IP (STRTCPPTP)</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="STRTCPPTP.Top_Of_Page"></a>
|
|
<h2>Start Point-to-Point TCP/IP (STRTCPPTP)</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="#STRTCPPTP.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#STRTCPPTP.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#STRTCPPTP.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="STRTCPPTP"></a>
|
|
<p>The Start Point-to-Point TCP/IP (STRTCPPTP) command is used to start a point-to-point TCP/IP session job. A session job operates in one of two possible modes:
|
|
</p>
|
|
<ol>
|
|
<li>Answer mode (*ANS) sessions allow a remote system to contact the local system and establish a point-to-point TCP/IP session.
|
|
</li>
|
|
<li>Dial mode (*DIAL) sessions are used to have the local system contact a remote system and establish a point-to-point TCP/IP session.
|
|
</li>
|
|
</ol>
|
|
<p>
|
|
<b>Note: </b>You can start any profiles of linetype *PPP with this command. You must use iSeries Navigator to configure *PPP profiles.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRTCPPTP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="STRTCPPTP.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="#STRTCPPTP.CFGPRF"><b>CFGPRF</b></a></td>
|
|
<td valign="top">Configuration profile</td>
|
|
<td valign="top"><i>Character value</i>, *AUTOSTART</td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRTCPPTP.OUTPUT"><b>OUTPUT</b></a></td>
|
|
<td valign="top">Script dialog output</td>
|
|
<td valign="top"><b><u>*ERROR</u></b>, *NONE, *PRINT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRTCPPTP.RESTART"><b>RESTART</b></a></td>
|
|
<td valign="top">Restart</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRTCPPTP.SNDINQMSG"><b>SNDINQMSG</b></a></td>
|
|
<td valign="top">Send inquiry message</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRTCPPTP.AUTODLTCFG"><b>AUTODLTCFG</b></a></td>
|
|
<td valign="top">Autodelete configuration</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRTCPPTP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="STRTCPPTP.CFGPRF"></a>
|
|
<h3>Configuration profile (CFGPRF)</h3>
|
|
<p>Specifies the point-to-point configuration profile to start. *AUTOSTART indicates that all point-to-point configuration profiles with this attribute should be started. The profile specifies all the attributes and values necessary to define a session. The mode specified in the profile determines whether the local system will be contacting a remote system (*DIAL session), or if a remote system will be contacting the local system (*ANS session). All other information about the characteristics of the session is also contained in the point-to-point configuration profile.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*AUTOSTART</b></dt>
|
|
<dd>Start all point-to-point configuration files marked with this attribute.
|
|
</dd>
|
|
<dt><b><u>character-value</u></b></dt>
|
|
<dd>Specify the name of a valid, inactive point-to-point configuration profile.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRTCPPTP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRTCPPTP.OUTPUT"></a>
|
|
<h3>Script dialog output (OUTPUT)</h3>
|
|
<p>Specifies whether or not to print a copy of the script dialog between the local system and the remote system. You can use this dialog to diagnose problems that prevent a point-to-point TCP/IP session from being successfully established.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter does not affect job log creation or output.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ERROR</u></b></dt>
|
|
<dd>Print the script dialog only if errors occur while establishing the TCP/IP point-to-point session job.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>Do not print the script dialog.
|
|
</dd>
|
|
<dt><b>*PRINT</b></dt>
|
|
<dd>Print the script dialog with the spooled output of the job that issued the STRTCPPTP command, regardless of whether or not any errors occurred.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRTCPPTP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRTCPPTP.RESTART"></a>
|
|
<h3>Restart (RESTART)</h3>
|
|
<p>Specifies whether to restart the TCP/IP point-to-point session job that is running the profile specified on the <b>Configuration profile (CFGPRF)</b> parameter.
|
|
</p>
|
|
<p>This parameter is only valid when specified for an active TCP/IP point-to-point profile. If the TCP/IP point-to-point profile is not active, this parameter is ignored.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>Do not restart the TCP/IP point-to-point session job.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Restart the TCP/IP point-to-point session job.
|
|
<p>How the TCP/IP point-to-point session job is restarted depends on the mode of point-to-point session that is running. By mode, the session is restarted as follows:
|
|
</p>
|
|
<dl>
|
|
<dt><b>Switched Line Dial (Dial remote systems)</b></dt>
|
|
<dd>Reset the session to start by redialing the remote system.
|
|
</dd>
|
|
<dt><b>Switched Line Answer (Answering incoming calls)</b></dt>
|
|
<dd>Reset the session to Ring Wait state (wait for remote system to dial in).
|
|
</dd>
|
|
<dt><b>Leased Line (Initiator or Terminator) for PPP</b></dt>
|
|
<dd>Reset back to LCP Configure Request state.
|
|
</dd>
|
|
<dt><b>Leased Line (Initiator or Terminator) for SLIP</b></dt>
|
|
<dd>Reset back to an 'Active' state
|
|
</dd>
|
|
<dt><b>Dial-on-Demand</b></dt>
|
|
<dd>Reset the session to wait for the next Dial-on-Demand request.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRTCPPTP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRTCPPTP.SNDINQMSG"></a>
|
|
<h3>Send inquiry message (SNDINQMSG)</h3>
|
|
<p>Specifies whether or not to send an inquiry message after any initialization has been completed. The inquiry message will be sent to the QTCP message queue.
|
|
</p>
|
|
<p>Until you respond to the inquiry message, the point-to-point session job is held. While the job is held, you can set up trace tools for diagnosing problems related to this TCP/IP point-to-point session job.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is ignored for any profiles of linetype *PPP.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>Do not send an inquiry message after initialization has been completed.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The point-to-point session job will send an inquiry message after it has completed its initialization. If the configuration profile has the attribute for automatic creation of the controller and device, the inquiry message will be sent after the controller description and device description have been created.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRTCPPTP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRTCPPTP.AUTODLTCFG"></a>
|
|
<h3>Autodelete configuration (AUTODLTCFG)</h3>
|
|
<p>Specifies whether or not controller description and device description configuration objects that were automatically created during STRTCPPTP initialization should be automatically deleted when the point-to-point session job ends.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>Do not delete any controller description and device description configuration objects that were automatically created by STRTCPPTP. This allows the controller description and device description to be reused the next time a TCP/IP point-to-point session job is started using the specified configuration profile.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Delete any controller description and device description configuration objects that were automatically created during STRTCPPTP initialization.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRTCPPTP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRTCPPTP.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Start a Point-To-Point TCP/IP Session Job.</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRTCPPTP CFGPRF(DIALPRF)
|
|
</pre>
|
|
</p>
|
|
<p>This command starts a point-to-point TCP/IP session job. The point-to-point configuration profile "DIALPRF" contains the information that will determine whether the local system will be contacting a remote system (*DIAL session), or if a remote system will be contacting the local system (*ANS session).
|
|
</p>
|
|
<p><b>Example 2: Start a Session and Capture the Script Dialog.</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRTCPPTP CFGPRF(DIALPRF) OUTPUT(*PRINT)
|
|
</pre>
|
|
</p>
|
|
<p>This command starts a point-to-point TCP/IP session job. The point-to-point configuration profile "DIALPRF" contains the information that the local system will use to contact the remote system and establish a point-to-point TCP/IP session with it. A copy of the dialog exchanged between the two systems prior to establishing a point-to-point TCP/IP session is written to the default output queue for the job that issued the STRTCPPTP command.
|
|
</p>
|
|
<p><b>Example 3: Send an Inquiry Message After Initializing the TCP/IP Session Job.</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRTCPPTP CFGPRF(ANSWERPRF) SNDINQMSG(*YES)
|
|
</pre>
|
|
</p>
|
|
<p>This command uses the SNDINQMSG parameter, which is normally used only if it is necessary to collect detailed internal trace information when the controller and device description used by the point-to-point session job are automatically created.
|
|
</p>
|
|
<p>This command starts a point-to-point TCP/IP session job. The point-to-point configuration profile "ANSWERPRF" contains the information that will be used to establish a point-to-point TCP/IP session when a remote system contacts the local system.
|
|
</p>
|
|
<p>After automatically creating the controller and device description it will use, the point-to-point session job will send an inquiry message to the QTCP message queue. Depending on the response, the job will either continue running or will be cancelled.
|
|
</p>
|
|
<p><b>Example 4: Restarting a Running Point-To-Point Profile.</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRTCPPTP CFGPRF(ANSWERPRF) RESTART(*YES)
|
|
</pre>
|
|
</p>
|
|
<p>This command will restart the running point-to-point profile ANSWERPRF. How the session is reset (restarted) depends on the connection type of the line (switched or unswitched) and the mode (dial or answer). For more information on how the session would be reset, see the details for RESTART(*YES) above.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRTCPPTP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRTCPPTP.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>TCP1A1F</b></dt>
|
|
<dd>Cannot process request while &3/&2/&1 using &6.
|
|
</dd>
|
|
<dt><b>TCP8205</b></dt>
|
|
<dd>Required object &2/&1 type *&3 not found.
|
|
</dd>
|
|
<dt><b>TCP8207</b></dt>
|
|
<dd>STRTCPPTP &1 not performed. Thread &10 in job &6/&5/&4 using &1.
|
|
</dd>
|
|
<dt><b>TCP8208</b></dt>
|
|
<dd>STRTCPPTP &1 not performed. See previous messages.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRTCPPTP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|