Summary of FTP client and server configuration statements

The statements for the FTP.DATA data set are summarized in Table 1 and explained in detail in FTP.DATA data set statements.

Guidelines:
  • Use separate FTP.DATA data sets for the FTP client and the FTP server if you are specifying any conflicting statements.
  • When you share the FTP server FTP.DATA data set with the FTP client, understand that some of the values for the statements in the FTP.DATA data set have different meanings in the two environments. If the files are shared, error messages could be generated or values that are not valid could be used for each client using the FTP.DATA data set containing server-only statements.

See FTP configuration statements in FTP.DATA for more information about the search order for both the client and server.

Table 1. Summary of FTP client and server configuration statements
Statement Description Applies to client, server, or both See
ACCESSERRORMSGS Allow FTP Server to send detailed login failure replies. Server ACCESSERRORMSGS (FTP server) statement
ADMINEMAILADDRESS Specify a value to use with %E keyword for banner text. Server ADMINEMAILADDRESS (FTP server) statement
ANONYMOUS Allow a remote user to issue USER ANONYMOUS without supplying a logon password. Server ANONYMOUS (FTP server) statement
ANONYMOUSFILEACCESS Specify the type of files (MVS™ or z/OS® UNIX) that anonymous clients are allowed to access. Server ANONYMOUSFILEACCESS (FTP server) statement
ANONYMOUSFILETYPEJES Control access to the FILETYPE SITE keyword of anonymous users when ANONYMOUSLEVEL 3 or greater is specified. Server ANONYMOUSFILETYPEJES (FTP server) statement
ANONYMOUSFILETYPESEQ Control access to the FILETYPE SITE keyword of anonymous users when ANONYMOUSLEVEL 3 or greater is specified. Server ANONYMOUSFILETYPESEQ (FTP server) statement
ANONYMOUSFILETYPESQL Control access to the FILETYPE SITE keyword of anonymous users when ANONYMOUSLEVEL 3 or greater is specified. Server ANONYMOUSFILETYPESQL (FTP server) statement
ANONYMOUSFTPLOGGING Specify whether the FTP server should log FTP session activity for anonymous users. Server ANONYMOUSFTPLOGGING (FTP server) statement
ANONYMOUSHFSDIRMODE Specify the mode bits used for directories created by anonymous users. Server ANONYMOUSHFSDIRMODE (FTP server) statement
ANONYMOUSHFSFILEMODE Specify the mode bits used when storing files created by anonymous users. Server ANONYMOUSHFSFILEMODE (FTP server) statement
ANONYMOUSHFSINFO Specify an anonymous user z/OS UNIX directory information file mask. Server ANONYMOUSHFSINFO (FTP server) statement
ANONYMOUSLEVEL Specify the type of anonymous access permitted to users who issue USER ANONYMOUS. Server ANONYMOUSLEVEL (FTP server) statement
ANONYMOUSLOGINMSG Specify anonymous user login messages. Server ANONYMOUSLOGINMSG (FTP server) statement
ANONYMOUSMVSINFO Specify anonymous user MVS information file (LLQ). Server ANONYMOUSMVSINFO (FTP server) statement
APPLNAME Specify the FTP server application name. Server APPLNAME (FTP server) statement
ASATRANS Specify how print control characters should be handled. Both ASATRANS (FTP client and server) statement
AUTOMOUNT Specify whether to mount DASD volumes containing data sets to be accessed. Both AUTOMOUNT (FTP client and server) statement
AUTORECALL Automatically recall data sets migrated by the storage manager. Both AUTORECALL (FTP client and server) statement
AUTOTAPEMOUNT Specify whether to mount tape volumes containing data sets to be accessed. Both AUTOTAPEMOUNT (FTP client and server) statement
BANNER Request that a welcome banner is displayed immediately after a new connection is established. Server BANNER (FTP server) statement
BLKSIZE Specify the block size of newly allocated data sets. Both BLKSIZE (FTP client and server) statement
BUFNO Specify the number of access method buffers. Both BUFNO (FTP client and server) statement
CCONNTIME Defines the amount of time to wait after attempting to close a control connection before terminating it and reporting an error. Client CCONNTIME (FTP client) statement
CCTRANS Specify the SBCS translation table to be used for the control connection. Client CCTRANS (FTP client) statement
CCXLATE Specify the translation table data set for the control connection. Server CCXLATE (FTP server) statement
CHKCONFIDENCE Specify that the FTP client or server checks and reports the confidence level in the successful completion of file transfers. Both CHKCONFIDENCE statement (FTP client and server) statement
CHKPTINT Specify the checkpoint interval when FTP is the sending site in a file transfer request. Both CHKPTINT (FTP client and server) statement
CHKPTPREFIX Used to determine the hlq for the checkpoint file.

Client CHKPTPREFIX (FTP client) statement
CIPHERSUITE Specify the name of a CipherSuite that is used during the TLS handshake. Both CIPHERSUITE (FTP client and server) statement
CLIENTERRCODES Specify whether FTP return codes are to be converted to client error codes. Client CLIENTERRCODES (FTP client) statement
CONDDISP Specify whether FTP should keep or delete a new data set or file when a file transfer ends prematurely. Both CONDDISP (FTP client and server) statement
CTRLCONN Specify code set to be used for the control connection. Both CTRLCONN (FTP client and server) statement
DATACLASS Specify the SMS-managed data class as defined by your organization for FTP. Both DATACLASS (FTP client and server) statement
DATACTTIME Specify the amount time that the client waits after attempting to send or receive data before terminating the connection and reporting an error to the user. Client DATACTTIME (FTP client) statement
DATAKEEPALIVE Specify the data connection keepalive timer. Both DATAKEEPALIVE (FTP client and server) statement
DATATIMEOUT Specify the time that the server waits for a response to a send or for the completion of a passive connection. Server DATATIMEOUT (FTP server) statement
DB2® Specify the name of the Db2® subsystem. Both DB2 (FTP client and server) statement
DB2PLAN Specify the name of the Db2 plan to be used by FTP. Both DB2PLAN (FTP cilent and server) statement
DBSUB Specify whether substitution is allowed for double-byte file data that cannot be translated. Both DBSUB (FTP client and server) statement
DCBDSN Specify a data set to be used as a model for allocation of new data sets. Both DCBDSN (FTP client and server) statement
DCONNTIME Specify the amount of time to wait after attempting to close a data transfer before terminating the connection and reporting an error. Both DCONNTIME (FTP client and server) statement
DEBUG Specify to activate a specific trace type. Both DEBUG (FTP client and server) statement
DEBUGONSITE Specify whether an FTP client is allowed to enter the SITE DEBUG command to change general tracing options. Server DEBUGONSITE (FTP server) statement
DEST Specify the NJE destination to which the files are routed when you enter a PUT subcommand. Server DEST (FTP server) statement
DIRECTORY Specify the number of directory blocks to be allocated for the directory of a PDS. Both DIRECTORY (FTP client and server) statement
DIRECTORYMODE Specify how to treat the data set qualifiers below the current directory. Both DIRECTORYMODE (FTP client and server) statement
DSNTYPE Specify the data set name type for new physical sequential data sets. Both DSNTYPE (FTP client and server) statement
DSWAITTIME Specify the number of minutes that FTP tries to access an MVS data set that could not be obtained because another job or process was holding the data set. Both DSWAITTIME (FTP client and server) statement
DSWAITTIMEREPLY Specify how often to send the following reply message to the client while the FTP server is waiting for access to an MVS data set. Server DSWAITTIMEREPLY (FTP server) statement
DUMP Specify to activate an extended trace dump ID. Both DUMP (FTP client and server) statement
DUMPONSITE Specify whether an FTP client is allowed to enter the SITE DUMP command to change the extended tracing options. Server DUMPONSITE (FTP server) statement
EATTR Specify whether new data sets can have extended attributes and whether the data sets can reside in the EAS. Both EATTR (FTP client and server) statement
EMAILADDRCHECK Control the extent to which the FTP server validates e-mail addresses entered by FTP clients while logging in to the FTP server. Server EMAILADDRCHECK (FTP server) statement
ENCODING Specify the type of data encoding on the network. Both ENCODING (FTP client and server) statement
EPSV4 Direct the FTP client to use EPSV and EPRT commands on IPv4 sessions. Client EPSV4 (FTP client) statement
EXTENSIONS Enable FTP to recognize extensions to FTP that are not described in RFC 959. Both EXTENSIONS (FTP client and server) statement
FIFOIOTIME Specify the FIFOIOTIME statement to set a timeout for reads and writes to a z/OS UNIX named pipe. Both FIFOIOTIME (FTP client and server) statement
FIFOOPENTIME Specify the FIFOOPENTIME statement to define the length of time that FTP waits after attempting to open a z/OS UNIX named pipe before reporting an error. Both FIFOOPENTIME (FTP client and server) statement
FILETYPE Specify the operational mode of FTP. Both FILETYPE (FTP client and server) statement
FTPKEEPALIVE Specify the control connection keepalive timer value in seconds. Both FTPKEEPALIVE (FTP client and server) statement
FTPLOGGING Specify whether the FTP server logs FTP session activity for unknown users (that is, users that are not anonymous users). Server FTPLOGGING (FTP server) statement
FWFRIENDLY Specify how data connections are to be set up between the client and the server. Client FWFRIENDLY (FTP client) statement
HFSINFO Specify a file containing welcome messages specific to each FTP server directory visited by an FTP client. Server HFSINFO (FTP server) statement
INACTIVE Set the inactivity timer to a specified number of seconds. Server INACTIVE (FTP Server) statement
INACTTIME Specify the amount of time to wait for an expected response from the server, on either the control or the data connection, before closing the session. Data transfer times that exceed this value does not cause session termination unless the time between data packet arrivals exceeds this value. Client INACTTIME (FTP client) statement
ISPFSTATS Allow FTP to create and maintain statistics for partitioned data set members. Both ISPFSTATS (FTP client and server) statement
JESENTRYLIMIT Specify how many JES entries can be displayed at one time with the LIST or NLST command. Server JESENTRYLIMIT (FTP server) statement
JESGETBYDSN Specify how to treat the foreign file name on a GET command when FILETYPE=JES is specified. Server JESGETBYDSN (FTP server) statement
JESINTERFACELEVEL Specify the JES interface level. Server JESINTERFACELEVEL (FTP server) statement
JESLRECL Specify the record length of the job being submitted. Server JESLRECL (FTP server) statement
JESPUTGETTO Specify the number of seconds for the JES PutGet timeout. Server JESPUTGETTO (FTP server) statement
JESRECFM Specify the record format of the job being submitted. Server JESRECFM (FTP server) statement
KEYRING Define the key ring that contains the certificate to be used during the TLS handshake. Both KEYRING (FTP client and server) statement
LISTLEVEL Specifies the format of the LIST command reply. Server LISTLEVEL (FTP server) statement
LISTSUBDIR Specify whether subdirectories of the parent directory are listed when FTP generates a list of files. Both LISTSUBDIR (FTP client and server) statement
LOGCLIENTERR Specify to activate client error logging feature. Client LOGCLIENTERR (FTP client) statement
LOGINMSG Specify the file containing messages to be displayed to FTP clients when they have successfully logged in. Server LOGINMSG (FTP server) statement
LRECL Specify the size of the records in a data set. Both LRECL (FTP client and server) statement
MBDATACONN Specify the multibyte data translation code pages for data connections. Both MBDATACONN (FTP client and server) statement
MBREQUIRELASTEOL Specify whether FTP requires the last record of incoming multibyte files to end with the FTP standard EOL sequence. Both MBREQUIRELASTEOL (FTP client and server) statement
MBSENDEOL Specify to the FTP client or server what EOL sequence to use when the ENcoding value is MBCS. Both MBSENDEOL statement (FTP client and server) statement
MGMTCLASS Specify the SMS management class to be assigned to newly allocated data sets. Both MGMTCLASS (FTP client and server) statement
MIGRATEVOL Specify the volume ID for migrated data sets not under the control of IBM® Storage Management Systems. Both MIGRATEVOL (FTP client and server) statement
MVSINFO Specify the MVS data sets whose contents are to be returned to the FTP client and displayed to the end user when a user changes directories. Server MVSINFO (FTP server) statement
MVSURLKEY Specify a token that users can enter as part of an FTP URL to encode an MVS data set name. Server MVSURLKEY (FTP server) statement
MYOPENTIME Specify the amount of time to wait for a session to open before terminating the attempt and reporting an error. Client MYOPENTIME (FTP client) statement
NETRCLEVEL Specify how the FTP client searches the NETRC data set for FTP server hostnames. Client NETRCLEVEL (FTP client) statement
NONSWAPD Specify whether the FTP daemon is swappable. Server NONSWAPD (FTP server) statement
PASSIVEDATACONN Specify to direct the server to verify the peer IP address of the data socket is the client's IP address. Server PASSIVEDATACONN (FTP server) statement
PASSIVEDATAPORTS Specify a range of port numbers for the FTP server to use as listening data socket ports. Server PASSIVEDATAPORTS (FTP server) statement
PASSIVEIGNOREADDR Specify to direct the FTP client to ignore the IP address returned from the server on the PASV reply on IPv4 sessions. Client PASSIVEIGNOREADDR (FTP client) statement
PASSIVEONLY Controls whether data connections for the client are passive mode only. Client PASSIVEONLY (FTP client) statement
PDSTYPE Specify the type of MVS directories (PDS or PDSE) FTP should allocate. Both PDSTYPE (FTP client and server) statement
PORTCOMMAND Specify whether the PORT and EPRT commands are accepted or rejected. Server PORTCOMMAND (FTP server) statement
PORTCOMMANDIPADDR Specify the server to accept only PORT or EPRT commands whose IP address matches that of the client. Server PORTCOMMANDIPADDR (FTP server) statement
PORTCOMMANDPORT Specify what range or port values the server accepts as a parameter for the PORT and EPRT commands. Server PORTCOMMANDPORT (FTP server) statement
PORTOFENTRY4 Specify the port of entry resource class to use for IPv4 login clients. Server PORTOFENTRY4 (FTP server) statement
PRIMARY Specify the number of tracks, blocks, or cylinders for primary allocation. Both PRIMARY (FTP client and server) statement
PROGRESS Specify the interval between progress report messages generated by the FTP client during an inbound or outbound file transfer. Client PROGRESS (FTP client) statement
QUOTESOVERRIDE Specify use of single quotation marks in file name. Both QUOTESOVERRIDE (FTP client and server) statement
RDW Specify whether RDWs are discarded upon retrieval. Both RDW (FTP client and server) statement
RECFM Specify the record format of a data set. Both RECFM (FTP client and server) statement
REMOVEINBEOF Remove UNIX EOF on inbound ASCII transfers. Both REMOVEINBEOF (FTP client and server) statement
REPLY226 (FTP server) Direct the FTP server to reply to the FTP client with reply code 226 instead of reply code 250. Server REPLY226 (FTP server) statement
REPLYSECURITYLEVEL Specify level of secure information returned in FTP replies. Server REPLYSECURITYLEVEL (FTP server) statement
RESTGET Specify whether the checkpoint data set is opened for a GET request. Client RESTGET (FTP client) statement
RESTPUT Specify whether the server supports checkpoint and restart processing when receiving data (put operation). Server RESTPUT (FTP server) statement
RETPD Specify the number of days a newly allocated data set should be retained. Both RETPD (FTP client and server) statement
SBDATACONN Specify single-byte data translation for the data connection. Both SBDATACONN (FTP client and server) statement
SBSENDEOL Specify to the FTP client or server what end of line (EOL sequence to use for outbound ASCII file transfer when the ENcoding value is SBCS. Both SBSENDEOL statement (FTP client and server) statement
SBSUB Specifies whether a substitution is allowed for a data byte that cannot be translated. Both SBSUB (FTP client and server) statement
SBSUBCHAR Specifies the single-byte substitution character for untranslatable data characters. Both SBSUBCHAR (FTP client and server) statement
SBTRANS Specify the SBCS translation table to be used for the data connection. Client SBTRANS (FTP client) statement
SECONDARY Specify the number of tracks, blocks, or cylinders for secondary allocation. Both SECONDARY (FTP client and server) statement
SECURE_CTRLCONN Specify the SECURE_CTRLCONN statement to specify the minimum level of security allowed for the control connection. Both SECURE_CTRLCONN (FTP client and server) statement
SECURE_DATACONN Specify the SECURE_DATACONN statement to specify the minimum level of security required on the data connection. Both SECURE_DATACONN (FTP client and server) statement
SECURE_FTP Specify the SECURE_FTP statement to specify whether authentication is required. Both SECURE_FTP (FTP client and server) statement
SECURE_HOSTNAME Specify the SECURE_HOSTNAME statement to specify whether the client verifies the host name in the server's certificate. Client SECURE_HOSTNAME (FTP client) statement
SECUREIMPLICITZOS Specify when the security of the session should be negotiated for implicit TLS connections. Both SECUREIMPLICITZOS (FTP client and server) statement
SECURE_LOGIN Specify the SECURE_LOGIN statement to set the authorization level required for users. Server SECURE_LOGIN (FTP server) statement
SECURE_MECHANISM Specifies which security mechanism the client uses. Client SECURE_MECHANISM (FTP client) statement
SECURE_PASSWORD Specify whether a password is required by the FTP server for an TLS protected session. Server SECURE_PASSWORD (FTP server) statement
SECURE_PASSWORD_KERBEROS Specify whether a password is required for a Kerberos protected session. Server SECURE_PASSWORD_KERBEROS (FTP server) statement
SECURE_PBSZ Specify the maximum size of the encoded data blocks sent during file transfer. Both SECURE_PBSZ (FTP client and server) statement
SECURE_SESSION_REUSE Specify whether session reuse is required when SSL/TLS is used to protect the connections. Both SECURE_SESSION_REUSE (FTP client and server) statement
SEQNUMSUPPORT Specify that sequence numbers in files designated by the ddname INPUT are ignored. Client SEQNUMSUPPORT (FTP client) statement
SMF Specify the default SMF record subtype for all SMF records. Server SMF (FTP server) statement
SMFAPPE Specify the SMF record subtype for the APPEND subcommand. Server SMFAPPE (FTP server) statement
SMFDCFG Specify a type 119 SMF record of subtype 71 is collected for the FTP daemon configuration information when the FTP daemon starts. Server SMFDCFG (FTP server) statement
SMFDEL Specify the SMF record subtype for the DELETE subcommand. Server SMFDEL (FTP server) statement
SMFEXIT Call the FTPSMFEX user exit routine. Server SMFEXIT (FTP server) statement
SMFJES Collect SMF records when FILETYPE is JES. Server SMFJES (FTP server) statement
SMFLOGN Specify the SMF record subtype when recording logon failures. Server SMFLOGN (FTP server) statement
SMFREN Specify the SMF record subtype for the RENAME subcommand. Server SMFREN (FTP server) statement
SMFRETR Specify the SMF record subtype for the RETR subcommand. Server SMFRETR (FTP server) statement
SMFSQL Collect SMF records when FILETYPE is SQL. Server SMFSQL (FTP server) statement
SMFSTOR Specify the SMF record subtype for the STOR and STOU subcommands. Server SMFSTOR (FTP server) statement
SOCKSCONFIGFILE Specify the SOCKS server configuration file the FTP client uses to determine which FTP servers require SOCKS protocols. Client SOCKSCONFIGFILE (FTP client) statement
SPACETYPE Specify whether newly allocated data sets are allocated in blocks, cylinders, or tracks. Both SPACETYPE (FTP client and server) statement
SPREAD Specify output in spreadsheet format when file type is SQL. Both SPREAD (FTP client and server) statement
SQLCOL Specify the column headings of the output file. Both SQLCOL (FTP client and server) statement
SSLV3 Control whether SSLV3 is enabled for connections that are secured by using TLS implemented by FTP. Both SSLV3 (FTP client and server connection) statement
STARTDIRECTORY Specify which file system is used initially when a new user logs in. Server STARTDIRECTORY (FTP server) statement
STORCLASS Specify the SMS-managed storage class for the FTP server. Both STORCLASS (FTP client and server) statement
SUPPRESSIGNOREWARNINGS Instruct FTP not to issue message EZYFT47I whenever it ignores a statement coded in FTP.DATA Both SUPPRESSIGNOREWARNINGS (FTP client and server) statement
TAPEREADSTREAM Specify whether to use a more efficient read path (read as stream) to retrieve tape data sets from the server. Server TAPEREADSTREAM (FTP server) statement
TLSMECHANISM Specify how TLS security is implemented. Both TLSMECHANISM (FTP client and server) statement
TLSPORT Set the secure port on which the FTP client or the FTP server implicitly protects the FTP session with TLS. Both TLSPORT (FTP client and server) statement
TLSRFCLEVEL Specify the level of RFC 4217 (Securing FTP with TLS) that FTP supports. Both TLSRFCLEVEL (FTP client and server) statement
TLSTIMEOUT Specify the maximum time between full TLS handshakes. Both TLSTIMEOUT (FTP client and server) statement
TRACE Start tracing. Both TRACE (FTP client and server) statement
TRACECAPI Define a control for tracing for a user-written program that uses the callable API interface for the z/OS FTP client. Client TRACECAPI (FTP client) statement
TRAILINGBLANKS Include trailing blanks in fixed format data sets when retrieved. Both TRAILINGBLANKS (FTP client and server) statement
TRUNCATE Allow truncating records that are longer than LRECL. Both TRUNCATE (FTP client and server) statement
UCOUNT Specify the unit count for new data set allocations. Both UCOUNT (FTP client and server) statement
UCSHOSTCS Specify the EBCDIC code set to be used for data conversion to or from Unicode. Both UCSHOSTCS (FTP client and server) statement
UCSSUB Specify whether Unicode-to-EBCDIC conversion should use the EBCDIC substitution character or cause the data transfer to be terminated if a Unicode character cannot be converted to a character in the target EBCDIC code set. Both UCSSUB (FTP client and server) statement
UCSTRUNC Specify whether the transfer of Unicode data should be aborted if truncation occurs at the MVS host. Both UCSTRUNC (FTP client and server) statement
UMASK Specify the file mode creation mask. Both UMASK (FTP client and server) statement
UNICODEFILESYSTEMBOM Specify whether to add a Byte Order Mark (BOM) to a file stored in the local file system when the file system code page is UNICODE. Both UNICODEFILESYSTEMBOM (FTP client and server) statement
UNITNAME Specify the unit type for allocation of new data sets. Both UNITNAME (FTP client and server) statement
UNIXFILETYPE Specify the UNIXFILETYPE statement in the FTP server and client to indicate whether to treat z/OS UNIX file system files as regular files or as z/OS UNIX named pipes during file transfer. Both UNIXFILETYPE (FTP client and server) statement
VCOUNT Specify the volume count for allocation of new data sets. Both VCOUNT (FTP client and server) statement
VERIFYUSER Specify whether the FTP server should verify whether a user attempting to log into FTP has been granted access to the server's port profile in the SERVAUTH class. Server VERIFYUSER (FTP server) statement
VOLUME Specify the volume serial number or numbers for allocation of new data sets. Both VOLUME (FTP client and server) statement
WRAPRECORD Specify whether data is wrapped or truncated if no new-line character is encountered before the logical record length is reached. Both WRAPRECORD (FTP client and server) statement
WRTAPEFASTIO Allow write to tape of ASCII stream data to use BSAM I/O routines. Both WRTAPEFASTIO (FTP client and server) statement
XLATE Specify the translation table data set for the data connection. Server XLATE (FTP server) statement