Translation: Control Connection
Use this panel to specify the translation option for the control
connection.
Translation is performed for FTP commands and replies sent over the control connection.
Before you begin, you should understand:
- Any translation table generated by the user, must be generated using the CONVXLAT utility.
- The hlq shown in some of the translation table search orders below,
is the high level qualifier specified in the TCPIP.DATA configuration statement, DATASETPREFIX.
- The Original_jobname shown in some of the translation table search orders below
is the FTP server's job name before the '1' is appended.
For example, if your FTP start procedure specifies a job name of 'FTPD', then 'FTPD' is the
Original_jobname. Once the server is completely started, the job name changes to 'FTPD1'.
- If you are configuring an FTP client, the settings on this page are overridden if the user specifies the
TRANSLATE data_set_name parameter on the FTP command when entering the FTP environment.
If the TRANSLATE data_set_name parameter is specified , the FTP client searches
for the translation table in the following priority
order and ignores the settings from this page. If it does not find one of these tables, the connection fails.
- $HOME/data_set_name.tcpxlbin (if the client is started in the z/OS UNIX System Services shell)
- user_id.data_set_name.TCPXLBIN
- hlq.data_set_name.TCPXLBIN
Translation options for the control connection:
- Select "Use defaults", to indicate FTP should use the default search order to locate the translation table.
The search order for the translation table differs between an FTP server and
an FTP client.
FTP Server
- Original_jobname.SRVRFTP.TCPXLBIN
- hlq.SRVRFTP.TCPXLBIN
- Original_jobname.STANDARD.TCPXLBIN
- hlq.STANDARD.TCPXLBIN
- (7-bit ASCII) - FTP uses ISO8859-1 for the network code page and IBM-1047 for the file system code page
- Internal (hard-coded) 7-bit tables
FTP Client
- If you specify the TRANSLATE data_set_name parameter on the FTP
command, the FTP client searches for the translation table in the following priority order. If it does not find
one of these tables, the connections fails.
- $HOME/data_set_name.tcpxlbin (if the client is started in the z/OS UNIX System Services shell)
- user_id.data_set_name.TCPXLBIN
- hlq.data_set_name.TCPXLBIN
- If you do not specify the TRANSLATE parameter on the FTP command,
FTP locates a translation table using the following search order:
- userid.FTP.TCPXLBIN
- hlq.FTP.TCPXLBIN
- userid.STANDARD.TCPXLBIN
- hlq.STANDARD.TCPXLBIN
- (7-bit ASCII) - FTP uses ISO8859-1 for the network code page and IBM-1047 for the file system code page
- Internal (hard-coded) 7-bit tables
- Select "Use the internal FTP translate table" to use the
FTP internal translation tables. The FTP internal tables are the same tables that are shipped
in the TCPXLBIN(STANDARD) data set.
- Select "Use iconv ISO8859-1 encoded character set" to specify that the
iconv ISO8859-1 character set should be used for the network code page. IBM-1047
is used for the file system code page.
- Check "Allow UTF-8 pathnames" to allow for UTF-8 support.
This starts FTP using the ISO8859-1 character set and negotiates a switch to
UTF8 encoding, as described in RFC 2640.
- Select "Use translation table created by user" to specify a data set
that contains translation tables used by FTP. This data set must be created using the
CONVXLAT utility.
- Select "Use the following iconv encoded character set:" to enter any single byte iconv
code page for the network code page. IBM-1047 will be used for the file system code page.
Steps
- Select which option should be used for translation.
- If you select "Use iconv ISO8859-1 encoded character set", and want to use UTF-8 support, check the box
labeled "Allow UTF-8 pathnames".
- If you select "Use translation table created by user", enter the location of your table.
- if you select "Use the following iconv encoded character set:", enter the iconv code page.
You have completed this panel after selecting the translation option and entering the translation table or
code page, if applicable.
You can find more detailed help on the following elements of this window:
Translation table created by user
Use the following iconv encoded character set
Push buttons
Click OK to complete the specification.
Click Cancel to negate any entries you have made on this page.
Click Help to understand more about this panel.