245 lines
14 KiB
HTML
245 lines
14 KiB
HTML
|
<?xml version="1.0" encoding="UTF-8"?>
|
||
|
|
<!DOCTYPE html
|
||
|
|
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||
|
|
<html lang="en-us" xml:lang="en-us">
|
||
|
|
<head>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||
|
|
<meta name="security" content="public" />
|
||
|
|
<meta name="Robots" content="index,follow" />
|
||
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
||
|
|
<meta name="DC.Type" content="reference" />
|
||
|
|
<meta name="DC.Title" content="Start and stop a client session" />
|
||
|
|
<meta name="abstract" content="You can start and stop a client session from this topic." />
|
||
|
|
<meta name="description" content="You can start and stop a client session from this topic." />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaiqrzaiqclient.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaiqscenariotrans.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaiqtlsssl.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaiqtransftp.htm" />
|
||
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 2004, 2006" />
|
||
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2004, 2006" />
|
||
|
|
<meta name="DC.Format" content="XHTML" />
|
||
|
|
<meta name="DC.Identifier" content="rzaiqrzaiqclientsession" />
|
||
|
|
<meta name="DC.Language" content="en-us" />
|
||
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
||
|
|
<!-- US Government Users Restricted Rights -->
|
||
|
|
<!-- Use, duplication or disclosure restricted by -->
|
||
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
||
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
||
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
||
|
|
<title>Start and stop a client session</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzaiqrzaiqclientsession"><a name="rzaiqrzaiqclientsession"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Start and stop a client session</h1>
|
||
|
|
<div><p>You can start and stop a client session from this topic.</p>
|
||
|
|
<div class="section"><p>This topic provides details for using the File Transfer Protocol
|
||
|
|
(FTP) client on the iSeries™ server.</p>
|
||
|
|
<ul class="simple"><li><a href="#rzaiqrzaiqclientsession__startfptserver">Start an FTP client session</a></li>
|
||
|
|
<li><a href="#rzaiqrzaiqclientsession__endfptserver">Stop the FTP client session</a></li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<div class="section" id="rzaiqrzaiqclientsession__startfptserver"><a name="rzaiqrzaiqclientsession__startfptserver"><!-- --></a><h4 class="sectiontitle">Start an FTP client session</h4><p>Before
|
||
|
|
starting the FTP client function, you must have the following information:</p>
|
||
|
|
<ul><li>The name or Internet address of the system to which files are sent or
|
||
|
|
obtained.</li>
|
||
|
|
<li>A logon ID and password (if required) for the remote system where the
|
||
|
|
file transfers are to occur.</li>
|
||
|
|
<li>The name of the file or files with which you want to work (send and receive,
|
||
|
|
for example).</li>
|
||
|
|
</ul>
|
||
|
|
<p>The Start TCP/IP File Transfer Protocol (STRTCPFTP
|
||
|
|
"remotesystem") command starts a client session on the local iSeries server,
|
||
|
|
and then opens a connection to the FTP server on the specified remote system.
|
||
|
|
For example, entering the command <samp class="codeph">FTP myserver.com</samp> would
|
||
|
|
start a client session on the iSeries server, and then open a connection
|
||
|
|
to the FTP server on the remote myserver.com system. You can specify additional
|
||
|
|
parameters, or be prompted for them by typing STRTCPFTP without specifying
|
||
|
|
a remote system.</p>
|
||
|
|
<div class="figborder"><pre> Start TCP/IP File Transfer (FTP)
|
||
|
|
|
||
|
|
Type choices, press Enter.
|
||
|
|
|
||
|
|
Remote system . . . . . . . . . > MYSERVER.COM
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
Coded character set identifier *DFT 1-65533, *DFT
|
||
|
|
Port . . . . . . . . . . . . . . > *SECURE 1-65535, *DFT, *SECURE
|
||
|
|
Secure connection . . . . . . . *DFT *DFT, *NONE, *SSL, *IMPLICIT
|
||
|
|
Data protection . . . . . . . . *DFT *DFT, *CLEAR, *PRIVATE
|
||
|
|
</pre>
|
||
|
|
</div>
|
||
|
|
<p>After you specify a remote system name, you are prompted
|
||
|
|
to specify additional information. The following content summarizes the options
|
||
|
|
available, and additional details that are available in the field help:</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">Remote system (RMTSYS)</h4><p>Specifies the remote system
|
||
|
|
name to which or from which the files are transferred. The following items
|
||
|
|
are possible values:</p>
|
||
|
|
<dl><dt class="dlterm">*INTNETADR</dt>
|
||
|
|
<dd>The Internet address (INTNETADR) parameter is prompted. The Internet address
|
||
|
|
is specified in the form, nnn.nnn.nnn.nnn, where nnn is a decimal number ranging
|
||
|
|
from 0 through 255</dd>
|
||
|
|
<dt class="dlterm">remote-system</dt>
|
||
|
|
<dd>Specify the remote system name to which or from which the file transfer
|
||
|
|
takes place.</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">Coded character set identifier (CCSID)</h4><p>Specifies
|
||
|
|
the ASCII coded character set identifier (CCSID) that is used for single-byte
|
||
|
|
character set (SBCS) ASCII file transfers when the FTP TYPE mode is set to
|
||
|
|
ASCII. The possible values are:</p>
|
||
|
|
<dl><dt class="dlterm">*DFT</dt>
|
||
|
|
<dd>The CCSID value 00819 (ISO 8859-1 8-bit ASCII) is used.</dd>
|
||
|
|
<dt class="dlterm">CCSID-value</dt>
|
||
|
|
<dd>The requested CCSID value is used. This value is validated to ensure a
|
||
|
|
valid ASCII SBCS CCSID was requested.</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">Port (PORT)</h4><p>Specifies the port number
|
||
|
|
used for connecting to the FTP server. Normally, the common port value of
|
||
|
|
21 is used to connect to the FTP server. Under some circumstances, the FTP
|
||
|
|
server can be contacted at a port other than port 21. In those situations,
|
||
|
|
the port parameter can be used to specify the server port to connect to. The
|
||
|
|
possible values are:</p>
|
||
|
|
<dl><dt class="dlterm">*DFT</dt>
|
||
|
|
<dd>The value 00021 is used.</dd>
|
||
|
|
<dt class="dlterm">*SECURE</dt>
|
||
|
|
<dd>The value 00990 is used. Port 990 is reserved for secure FTP servers which
|
||
|
|
immediately use Transport Layer Security (TLS) or Secure Sockets Layer (SSL)
|
||
|
|
protocols to encrypt data.</dd>
|
||
|
|
<dt class="dlterm">port_value</dt>
|
||
|
|
<dd>The requested port value is used. This value is validated to ensure it
|
||
|
|
is in the proper range.</dd>
|
||
|
|
</dl>
|
||
|
|
<div class="note"><span class="notetitle">Note:</span> If 990 is specified, the FTP client will perform the
|
||
|
|
same functions as if *SECURE were specified.</div>
|
||
|
|
</div>
|
||
|
|
<div class="section" id="rzaiqrzaiqclientsession__seccnn"><a name="rzaiqrzaiqclientsession__seccnn"><!-- --></a><h4 class="sectiontitle">Secure connection (SECCNN)</h4><p>Specifies
|
||
|
|
the type of security mechanism to be used for protecting information transferred
|
||
|
|
on the FTP control connection (which includes the password used to authenticate
|
||
|
|
the session with the FTP server). Transport Layer Security (TLS) and Secure
|
||
|
|
Sockets Layer (SSL) are compatible protocols which use encryption to protect
|
||
|
|
data from being viewed during transmission and verify that data loss or corruption
|
||
|
|
does not occur.</p>
|
||
|
|
<div class="note"><span class="notetitle">Note:</span> The FTP client subcommand SECOPEN can be used to
|
||
|
|
open a protected FTP connection during an FTP client session.</div>
|
||
|
|
<p>The
|
||
|
|
possible values are:</p>
|
||
|
|
<dl><dt class="dlterm">*DFT</dt>
|
||
|
|
<dd>If the PORT parameter specifies *SECURE or 990, *IMPLICIT is used; otherwise,
|
||
|
|
*NONE is used.</dd>
|
||
|
|
<dt class="dlterm">*IMPLICIT</dt>
|
||
|
|
<dd>The FTP client immediately attempts to use TLS or SSL
|
||
|
|
when connecting to the specified FTP server (without sending an AUTH subcommand
|
||
|
|
to the server). If the server does not use implicit TLS or SSL on the specified
|
||
|
|
port, or the TLS or SSL negotiation fails for any reason, the connection is
|
||
|
|
closed.</dd>
|
||
|
|
<dt class="dlterm">*SSL</dt>
|
||
|
|
<dd>After connecting to the specified FTP server, the FTP client sends an
|
||
|
|
AUTH (authorization) subcommand requesting a TLS or SSL protected session.
|
||
|
|
If the server supports TLS or SSL, a TLS or SSL negotiation performed. If
|
||
|
|
the server does not support TLS or SSL or the TLS or SSL negotiation fails,
|
||
|
|
the connection is closed.</dd>
|
||
|
|
<dt class="dlterm">*NONE</dt>
|
||
|
|
<dd>The FTP client does not use encryption for the control connection to the
|
||
|
|
specified FTP server.</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<div class="section" id="rzaiqrzaiqclientsession__dtaprot"><a name="rzaiqrzaiqclientsession__dtaprot"><!-- --></a><h4 class="sectiontitle">Data protection (DTAPROT)</h4><p>Specifies
|
||
|
|
the type of data protection to be used for information transferred on the
|
||
|
|
FTP data connection. This connection is used to transfer file data and directory
|
||
|
|
listings. The FTP protocol does not allow protection of the data connection
|
||
|
|
if the control connection is not protected.</p>
|
||
|
|
<div class="note"><span class="notetitle">Note:</span> The FTP client subcommand
|
||
|
|
SECData can be used subsequently to change the data protection level. The
|
||
|
|
FTP client uses the FTP server subcommand PROT to request the specified data
|
||
|
|
protection after a secure control connection has been established.</div>
|
||
|
|
<p>The
|
||
|
|
possible values are:</p>
|
||
|
|
<dl><dt class="dlterm">*DFT</dt>
|
||
|
|
<dd>If the SECCNN parameter specifies a protected control connection, *PRIVATE
|
||
|
|
is used; otherwise, *CLEAR is used.</dd>
|
||
|
|
<dt class="dlterm">*PRIVATE</dt>
|
||
|
|
<dd>Information sent on the FTP data connection is encrypted. If the SECCNN
|
||
|
|
parameter specifies that the FTP control connection is not encrypted, *PRIVATE
|
||
|
|
cannot be specified.</dd>
|
||
|
|
<dt class="dlterm">*CLEAR</dt>
|
||
|
|
<dd>Information sent on the FTP data connection is not encrypted.</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">Outgoing ASCII/EBCDIC table (TBLFTPOUT)</h4><p>Specifies
|
||
|
|
the table object that is to be used to map all outgoing data in the FTP client.
|
||
|
|
Outgoing data is mapped from EBCDIC to ASCII. If no table object is specified
|
||
|
|
for TBLFTPOUT, the CCSID parameter is used to determine outgoing mapping.
|
||
|
|
The possible values are:</p>
|
||
|
|
<dl><dt class="dlterm">*CCSID</dt>
|
||
|
|
<dd>The CCSID parameter is used to determine outgoing mapping.</dd>
|
||
|
|
<dt class="dlterm">*DFT</dt>
|
||
|
|
<dd>The CCSID parameter is used to determine outgoing mapping.<p>The name
|
||
|
|
of the outgoing mapping table can be qualified by one of the following library
|
||
|
|
values:</p>
|
||
|
|
<dl><dt class="dlterm">*LIBL</dt>
|
||
|
|
<dd>All libraries in the user and system portions of the job's library list
|
||
|
|
are searched until the first match is found.</dd>
|
||
|
|
<dt class="dlterm">*CURLIB</dt>
|
||
|
|
<dd>The current library for the job is searched. If no library is specified
|
||
|
|
as the current library for the job, the QGPL library is used.</dd>
|
||
|
|
<dt class="dlterm">library-name</dt>
|
||
|
|
<dd>Specify the name of the library to be searched.</dd>
|
||
|
|
</dl>
|
||
|
|
</dd>
|
||
|
|
<dt class="dlterm">outgoing-mapping-table</dt>
|
||
|
|
<dd>Specify the table object to be used by the FTP client for mapping outgoing
|
||
|
|
data.</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">Incoming ASCII/EBCDIC table (TBLFTPIN)</h4><p>Specifies
|
||
|
|
the table object that is to be used to map all incoming data in the FTP client.
|
||
|
|
Incoming data is mapped from ASCII to EBCDIC. If no table object is specified
|
||
|
|
for TBLFTPIN, the CCSID parameter is used to determine incoming mapping. The
|
||
|
|
following items are possible values:</p>
|
||
|
|
<dl><dt class="dlterm">*CCSID</dt>
|
||
|
|
<dd>The CCSID parameter is used to determine incoming mapping.</dd>
|
||
|
|
<dt class="dlterm">*DFT</dt>
|
||
|
|
<dd>The CCSID parameter is used to determine incoming mapping.<p>The name
|
||
|
|
of the incoming mapping table can be qualified by one of the following library
|
||
|
|
values:</p>
|
||
|
|
<dl><dt class="dlterm">*LIBL</dt>
|
||
|
|
<dd>All libraries in the user and system portions of the job's library list
|
||
|
|
are searched until the first match is found.</dd>
|
||
|
|
<dt class="dlterm">*CURLIB</dt>
|
||
|
|
<dd>The current library for the job is searched. If no library is specified
|
||
|
|
as the current library for the job, the QGPL library is used.</dd>
|
||
|
|
<dt class="dlterm">library-name</dt>
|
||
|
|
<dd>Specify the name of the library to be searched.</dd>
|
||
|
|
</dl>
|
||
|
|
</dd>
|
||
|
|
<dt class="dlterm">incoming-mapping-table</dt>
|
||
|
|
<dd>Specify the table object to be used by the FTP client for mapping incoming
|
||
|
|
data.</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<div class="section" id="rzaiqrzaiqclientsession__endfptserver"><a name="rzaiqrzaiqclientsession__endfptserver"><!-- --></a><h4 class="sectiontitle">Stop the FTP client session</h4><p>Use
|
||
|
|
the QUIT subcommand to stop an FTP session. The QUIT subcommand closes the
|
||
|
|
connection with the remote host and ends the FTP session on the iSeries server.
|
||
|
|
Alternatively, you can press F3 (Exit), and then confirm to end the FTP client
|
||
|
|
session.</p>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzaiqrzaiqclient.htm" title="You can start and stop client sessions, transfer and receive files, as well as set up File Transfer Protocol (FTP) batch jobs.">Use the File Transfer Protocol client on iSeries server</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
||
|
|
<div><a href="rzaiqtlsssl.htm" title="You can use Transport Layer Security (TLS) or Secure Sockets Layer (SSL) connections to encrypt data transferred over File Transfer Protocol (FTP) control and data connections.">Secure the FTP client with Transport Layer Security or Secure Socket Layer</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="reltasks"><strong>Related tasks</strong><br />
|
||
|
|
<div><a href="rzaiqtransftp.htm" title="You can send and receive files with File Transfer Protocol (FTP).">Transfer files with File Transfer Protocol</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relinfo"><strong>Related information</strong><br />
|
||
|
|
<div><a href="rzaiqscenariotrans.htm" title="To transfer a file to a test server, use basic File Transfer Protocol (FTP) to send the file to the remote host.">Scenario: Transfer a file from a remote host</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|