FTP.DATA file

The z/OS® Communications Server provides an FTP client program to perform file transfer operations. SMP/E uses this FTP client program to transfer packages for RECEIVE FROMNETWORK and RECEIVE ORDER command processing, and the GIMGTPKG service routine. Certain functions of the FTP client program, such as performing file transfers in a secure mode or properly navigating local SOCKS firewalls, require the use of a configuration file (FTP.DATA) to the FTP client program. If you run FTP on z/OS V1R8 or higher, you can use the -f FTP parameter to identify a specific FTP.DATA file. You can specify the -f parameter using the <FTPOPTIONS> tag in the CLIENT data set.

<FTPOPTIONS>-f "//'USER1.FTP.DATA'"</FTPOPTIONS>

Note: Support for the <FTPOPTIONS> tag in the CLIENT data set is added to SMP/E V3R3 and later with APAR IO05806.

Using the -f parameter overrides the default search order used by the FTP client program to find the FTP.DATA file. If you do not specify the -f parameter, or if you are using a lower level of the FTP client program, the default search order for FTP.DATA is as follows:

$HOME/ftp.data
userid.FTP.DATA
/etc/ftp.data
SYS1.TCPPARMS(FTPDATA) data set
tcpip_hlq.FTP.DATA file

For information about the contents of the FTP.DATA file and the -f parameter, see z/OS Communications Server: IP User's Guide and Commands. Also, ensure that you have the fix for APAR PK31326 before you use the -f parameter.