| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change FTP attributes (CHGFTPA) command changes the configuration for the File Transfer Protocol (FTP) servers. The FTP attributes can be changed while the FTP servers are active. The attributes that were changed take affect the next time an FTP server connection is made. All existing connections are not changed but keep the same attributes they had when the connection was established.
Restrictions:
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| AUTOSTART | Autostart servers | *SAME, *YES, *NO | Optional, Positional 1 |
| NBRSVR | Number of initial servers | 1-20, *SAME, *DFT | Optional |
| INACTTIMO | Inactivity timeout | 0-2147483647, *SAME, *DFT | Optional |
| CCSID | Coded character set identifier | 1-65533, *SAME, *DFT | Optional |
| TBLFTPOUT | Outgoing EBCDIC/ASCII table | Single values: *SAME, *CCSID, *DFT Other values: Element list |
Optional |
| Element 1: Outgoing EBCDIC/ASCII table | Qualified object name | ||
| Qualifier 1: Outgoing EBCDIC/ASCII table | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| TBLFTPIN | Incoming ASCII/EBCDIC table | Single values: *SAME, *CCSID, *DFT Other values: Element list |
Optional |
| Element 1: Incoming ASCII/EBCDIC table | Qualified object name | ||
| Qualifier 1: Incoming ASCII/EBCDIC table | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| NAMEFMT | Initial name format | *SAME, *LIB, *PATH | Optional |
| CURDIR | Initial directory | *SAME, *CURLIB, *HOMEDIR | Optional |
| LISTFMT | Initial list format | *SAME, *DFT, *UNIX | Optional |
| CRTCCSID | New file CCSID | 1-65533, *SAME, *CALC, *USER, *SYSVAL | Optional |
| SBSD | Subsystem description | Single values: *SAME, *DFT Other values: Qualified object name |
Optional |
| Qualifier 1: Subsystem description | Name | ||
| Qualifier 2: Library | Name | ||
| ALWSSL | Allow secure sockets layer | *SAME, *YES, *NO, *ONLY | Optional |
| Top |
Specifies whether to automatically start the FTP servers when TCP/IP is started by running the Start TCP/IP (STRTCP) command, or the Start TCP/IP Server (STRTCPSVR) command with SERVER(*AUTOSTART) specified. When FTP is started by running the STRTCPSVR command, and SERVER(*AUTOSTART) is not specified, this parameter is ignored and the number of servers defined is started regardless of the value of this parameter.
| Top |
Specifies the number of FTP servers to start initially when FTP is started by either the Start TCP/IP (STRTCP) command or the Start TCP/IP Server (STRTCPSVR) command. The initial number of servers to be started is shipped with a value of 3. The maximum number of servers that may be specified is 20.
Having more than one FTP server job running can improve the performance of initiating a session when multiple users attempt to connect to the server in a short period of time.
Once the FTP servers are running, you can increase or decrease the number of servers. If you request to increase the number of servers with the CHGFTPA command, the number of current servers is increased the next time an FTP connection occurs to the server. If you request to decrease the number of servers, the request has no effect until the next time the STRTCP or STRTCPSVR command is run.
| Top |
Specifies the number of seconds the system allows an FTP control and data connection to remain inactive before it is ended. When an FTP connection is inactive longer than the specified length of time, it is ended.
Notes:
This parameter is used only by the FTP server; it is not used by the FTP client.
| 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 server 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 optionally be done with mapping tables specified for the Outgoing EBCDIC/ASCII table (TBLFTPOUT) and Incoming ASCII/EBCDIC table (TBLFTPIN) parameters. Normally the TBLFTPOUT and TBLFTPIN parameters are set to the default of *CCSID or *DFT, with both indicating that the value used in the CCSID parameter is used for mapping.
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.
If a mapping table is to be used for outgoing mapping, a table object can be specified in the TBLFTPOUT parameter. Then this table object is used for outgoing mapping instead of the CCSID value.
Incoming mapping can be changed to use a mapping table in the same manner by specifying a table object in the TBLFTPIN parameter. This mapping table would then override the specified CCSID value and be used for incoming mapping.
Double-byte character set (DBCS) CCSID values are not permitted for this parameter. The DBCS CCSID values can be specified using the TYPE subcommand.
| Top |
Specifies the table object that is to be used to map all outgoing server data in FTP. Outgoing server data is mapped from EBCDIC to ASCII.
If a table object is specified for the TBLFTPOUT parameter, 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 used to map all incoming server data in FTP. Incoming server data is mapped from ASCII to EBCDIC.
If a table object is specified for the TBLFTPIN parameter, 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 |
Specifies the initial setting of NAMEFMT (file naming format) for each new session established with the FTP server.
| Top |
Specifies the initial current working directory to be established when a user logs on to the iSeries FTP server.
Note: CURDIR(*HOMEDIR) cannot be used with NAMEFMT(*LIB).
| Top |
Specifies the initial setting of LISTFMT (file listing format) for each new session established with the FTP server.
| Top |
Specifies the EBCDIC coded character set identifier (CCSID) to be used when creating new database files in libraries for ASCII file transfers.
| Top |
Specifies the subsystem description of the subsystem where FTP server jobs are to run. If the specified subsystem description does not exist, it is created.
Notes:
Single values
Qualifier 1: Subsystem description
Qualifier 2: Library
| Top |
Specifies whether the FTP server should use Secure Sockets Layer (SSL) support. SSL provides encryption of FTP datastreams (including passwords), and optionally supports certificate-based authentication of FTP clients (which allows the user to be authenticated by certificate instead of password).
Note:If ALWSSL(*YES) is specified and the Digital Certificate Manager is configured for required FTP client authentication, non-SSL sessions are accepted by the FTP server. However, non-anonymous FTP users must switch to SSL mode in order to log in to the iSeries FTP server.
Note:If ALWSSL(*ONLY) is specified and either a prerequisite product required for SSL is not installed or a valid FTP server certificate is not configured in the Digital Certificate Manager, the FTP server will not start.
| Top |
| Top |
*ESCAPE Messages
| Top |