Setting user-level options using FTPS.RC

The default values for the site parameters are coded in the server FTP.DATA file. As a client user, you can change the site parameters by creating an FTPS.RC configuration data set. This file can have CD and SITE subcommands.

The FTPS.RC configuration data set is optional. The FTP server uses the following search order to find the data set:
  1. tso_prefix.FTPS.RC
  2. userid.FTPS.RC
  3. $HOME/ftps.rc
The following are the syntax rules for the FTPS.RC file:
  • Only SITE and CWD commands are allowed for this file. (CD is also accepted and is treated as CWD.)
  • Each command must be contained in a single line.
  • The SITE command can have multiple parameters.
  • Comments are allowed, but the entire line will be commented out. In other words, comments cannot exist on the same line as the actual command line.
  • Each comment must begin with a semicolon.
  • Comments can be entered between two or more command lines.
Note: Test your configuration file to ensure that it is processed correctly by naming the file (following the preceding naming convention) and putting the file into the correct directory. A 230-type reply of Processing FTPS.RC configuration file.. is displayed during your login process. The 230-type reply indicates any errors encountered or whether the file was successfully opened and processed. Contact the system programmer if you cannot fix any errors reported or if the file cannot be opened or created. See z/OS Communications Server: IP and SNA Codes for additional information about 230-type replies.
The following are examples of an FTPS.RC file with no errors and with errors.
  • No errors (correctly coded). 
    ; This is a sample configuration file for FTPS.RC
; You may enter comments by starting a line with semicolon (;). The 
; entire line will be ignored.
; The server FTP.DATA file must have the statement DEBUGONSITE TRUE
; for the SITE DEBUG= subcommand to be accepted by the server.
SITE debug=all
; You may also insert comments between command lines.
; You may code either 'CD' or 'CWD'.
CWD /user2
CD tmp
  • Errors within the file. 
    ; This is a sample configuration file for FTPS.RC
; You may enter comments by starting a line with semicolon (;). The 
; entire line will be ignored.
; The line below has an error: errormount is an unrecognized parameter.
SITE errormount
; PUT subcommand is not accepted in this file.
PUT 'user2.tmp.banner' 'user3.tmp.banner'