XLATE (FTP server) statement

Use the XLATE statement to specify a data set containing translate tables to be used for the data connection.

Syntax

Read syntax diagramSkip visual syntax diagramXLATEname

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 FRED

If 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