| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Start TCP/IP File Transfer Protocol (STRTCPFTP) command is used to start the File Transfer Protocol (FTP) client application that transfers files between systems using the Transmission Control Protocol/Internet Protocol (TCP/IP). FTP is an application protocol used for transferring files to and from a remote system. FTP requires a user ID, and in some cases a password, to gain access to files on a remote system.
Mapping Parameters: Mapping of data is used for all data (for example, user data and protocol data information) between the local and remote systems, except when the EBCDIC subcommand or the BINARY subcommand is in effect. In these cases, mapping of user file data is not done.
The Change FTP Attributes (CHGFTPA) command can be used to specify server mapping tables for FTP.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| RMTSYS | Remote system | Character value, *INTNETADR | Required, Positional 1 |
| INTNETADR | Internet address | Character value | Optional |
| CCSID | Coded character set identifier | 1-65533, *DFT | Optional |
| PORT | Port | 1-65535, *DFT, *SECURE | Optional |
| SECCNN | Secure connection | *DFT, *NONE, *SSL, *IMPLICIT | Optional |
| DTAPROT | Data protection | *DFT, *CLEAR, *PRIVATE | Optional |
| TBLFTPOUT | Outgoing EBCDIC/ASCII table | Single values: *CCSID, *DFT Other values: Qualified object name |
Optional |
| Qualifier 1: Outgoing EBCDIC/ASCII table | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| TBLFTPIN | Incoming ASCII/EBCDIC table | Single values: *CCSID, *DFT Other values: Qualified object name |
Optional |
| Qualifier 1: Incoming ASCII/EBCDIC table | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB |
| Top |
Specifies the remote system name to which or from which the files are transferred. To be successful, the remote system name must be valid, and the system must be able to communicate with the local system. The user can assign names to an internet address with the Work with TCP/IP host table entries option on the Configure TCP/IP menu (CFGTCP command). Also, a remote name server can be used to map remote system names to internet addresses. You can use the Change remote name server option on the CFGTCP menu to specify a remote name server.
| Top |
Specifies the internet address of the remote system to which or from which the file transfer takes place. The internet address is specified in the form, nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. An internet address is not valid if it has a value of all binary ones or all binary zeros for the network identifier (ID) portion or the host ID portion of the address. If the internet address is entered from a command line, the address must be enclosed in apostrophes.
| Top |
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. ASCII file transfers are also assumed when no TYPE subcommand has been issued. The CCSID value chosen is the default used by the FTP client for ASCII-to-EBCDIC and EBCDIC-to-ASCII mapping. Mapping is determined using the specified ASCII CCSID and the EBCDIC CCSID of the job.
Outgoing and incoming mapping can be done optionally with mapping tables defined in the TBLFTPOUT and TBLFTPIN parameters. Normally the TBLFTPOUT and TBLFTPIN parameters are set to the default of *CCSID or *DFT. Both parameters indicate that the value used in the CCSID parameter is used for mapping. If a mapping table is to be used for outgoing mapping, a table object can be specified in the TBLFTPOUT parameter. The table object specified in the TBLFTPOUT parameter is used instead of the CCSID value.
Incoming mapping can be changed to use a mapping table by specifying a table object in the TBLFTPIN parameter. This mapping table overrides the specified CCSID value and is used for incoming mapping.
Double-byte character set (DBCS) CCSID values are not permitted for this parameter. DBCS values can be specified using the TYPE subcommand.
Note: IBM includes mapping support in FTP to ensure compatibility with releases prior to V3R1. Use of mapping tables for incoming TYPE A file transfers results in the loss of CCSID tagging if the target file must be created. IBM strongly recommends that you use CCSID support for normal operations.
The TBLFTPOUT and TBLFTPIN parameters are used to specify user-defined incoming and outgoing mapping tables. The user-defined mapping tables replace the mapping done by the FTP client when the CCSID parameter is specified.
| Top |
Specifies the port number to be used for connecting to the FTP server.
Normally the "well-known" port value of 21 is used to connect to the FTP server. Under some circumstances, the FTP server may be contacted at a port other than port 21. In those situations, the port parameter may be used to specify the server port to connect to.
Note: The FTP client subcommands OPEN and SECOPEN each have an optional 'port' parameter which may be used to specify a port other than port 21.
Note: If 990 is specified, the FTP client will perform the same functions as if *SECURE were specified.
| Top |
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.
Note: The FTP client subcommand SECOPEN can be used to open a protected FTP connection during an FTP client session.
| Top |
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.
Note: The DTAPROT parameter controls the use of the PROT (protection) FTP server subcommand. The FTP client subcommand SECDATA can be used to change protection for specific FTP data connections during an FTP client session.
Note: If the SECCNN parameter specifies that the FTP control connection is not encrypted, *PRIVATE cannot be specified.
| Top |
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 a table object is specified for TBLFTPOUT, the table object is used for outgoing mapping. Otherwise, the CCSID parameter is used to determine outgoing mapping.
Single values
Qualifier 1: Outgoing EBCDIC/ASCII table
Qualifier 2: Library
| Top |
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 a table object is specified for TBLFTPIN, the table object is used for incoming mapping. Otherwise, the CCSID parameter is used to determine incoming mapping
Single values
Qualifier 1: Incoming ASCII/EBCDIC table
Qualifier 2: Library
| Top |
| Top |
None
| Top |