Use the XLATE statement to specify a data set containing translate tables to be used for the data connection.
Parameters
- name
- Specifies a 1- to 8-character name corresponding to a data set
that contains translate tables.
FTP looks first for an environment variable called _FTPXLATE_name. If the environment variable exists, its value is used as the data set name.
Restriction: The environment variable name must be all uppercase, although the XLATE parameter can be in mixed case.
If the environment variable does not exist, FTP looks for a data set called hlq.name.TCPXLBIN.
Examples
XLATE FREDIf environment variable _FTPXLATE_FRED=FREDDYS.TABLES is defined for the FTP server, this statement specifies that the translate tables in data set FREDDYS.TABLES should be used for the data connection.
If there is no such environment variable defined, this statement specifies that the translate tables data set hlq.FRED.TCPXLBIN should be used.
Usage notes
- SBDATACONN and XLATE are mutually exclusive statements. If both statements appear in your FTP.DATA file, XLATE is ignored.
- The XLATE statement (and its value) is not case sensitive, but the name of the corresponding environment variable must be all uppercase or FTP does not recognize it.
Related topics
- Translation tables
- CCXLATE (FTP server) statement
- CTRLCONN (FTP client and server) statement
- To see the search order that determines the conversion for the control connection, see z/OS Communications Server: IP Configuration Guide.