Translation: Single Byte Data Connection
Use this panel to specify the translation settings for data connections using single byte conversions.
Before you begin, you should understand:
- For the transfer of data on the data connection, FTP supports:
- All single-byte conversions available through iconv. For example,
Country_Extended_code-Pages (CECPs) <-> ISO8859-1 and IBM-1047
<-> IBM-850 conversions are available for data transfers.
- Multi-byte conversions available through iconv.
- Both single-byte and double-byte data conversions with translation tables
provided with TCP/IP or generated by the CONVXLAT utility.
- 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 logging in.
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 login 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 data connection using single bytes:
- 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
- SYSFTSX DD statement in the startup procedure, that specifies a
CONVXLAT generated translate table. The table can be an
MVS data set or a file. A start procedure for the FTP server
you are configuring that does not contain a SYSFPSX DD statement is created.
If you choose not to use the created start procedure,
make sure you understand the implications of any SYSFTSX DD statement
in your start procedure.
- Original_jobname.SRVRFTP.TCPXLBIN
- hlq.SRVRFTP.TCPXLBIN
- Original_jobname.STANDARD.TCPXLBIN
- hlq.STANDARD.TCPXLBIN
- If none of the above are found, FTP uses the same translation tables
established for the control connection.
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 login 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
- If none of the above are found, FTP uses the same translation tables
established for the control connection.
- Select "Use the internal FTP translation 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 translation table created by user" to specify a data set
that contains translation tables. This data set must be created using the
CONVXLAT utility.
- Select "Use the following iconv encoded character sets:" to enter any
single byte iconv code page for the network and host code pages.
With this selection, you can choose to use a substitution character for non-translatable characters encountered.
Steps
- Select which option should be used for translation.
- 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 pages and
choose whether to use a substitution character.
You have completed this panel after selecting the translation option and entering the translation table or
code pages, if applicable.
You can find more detailed help on the following elements of this window:
Enter the fully qualified MVS data set or zFS file name
Network transfer encoded character set
z/OS UNIX file system encoded character set
Character substitution (SBSUB and SBSUBCHAR)
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.