Conversion Tables/Custom Code Conversion

With this feature, you can convert text files between various character-set specifications.

Note: The character conversion tables are for single byte conversion. If you need to do double-byte conversions, there are two options:

1. Convert the file using the iconv utility, then send the file as a binary file.

2. Send a file to Platform Server for z/OS, then use Platform Server for z/OS to perform double byte conversion. For more information on double byte conversion, see LCT and RCT parameters in the TIBCO Managed File Transfer Platform Server for z/OS User's Guide.

The Platform Server provides the following four conversion tables:

Conversion Table Description
Comtblg.classic The old comtblg.dat shipped with previous versions (before version 7.1).
Comtblg.cp037 Extended ASCII table that is based on IBM Code page 037.
Comtblg.cp1047 Extended ASCII table that is based on IBM Code page 1047.
Comtblg.dat ASCII/EBCIDIC table used by the platform server at run time. (By default a copy of Comtblg.cp037.)
Comtblg.dat contains the following table which converts data from ASCII to EBCDIC and EBCDIC to ASCII:

To activate conversion tables, you have to turn the ASCII_to_EBCDIC parameter on. For more information, see ASCII_to_EBCDIC parameter in Optional Transfer Properties.

When this parameter is on, it uses the file names that are specified in the ConvTbl, LocalCTFile, and RemoteCTFile parameters. For more information, see CONVTBL, LocalCTFile and RemoteCTFile in Optional Transfer Parameters.

You can define the ConvTbl parameter in the config.txt file to specify the default conversion table for all transfers. If this parameter is not set, the $CFROOT/Comtblg.dat file is used.

The first 16 lines in this file are used when sending data to a partner, that is, converting ASCII data to EBCDIC. The last 16 lines are used when receiving data from a partner, that is, converting EBCDIC to ASCII. ASCII to EBCDIC translation is typically performed on the ASCII systems (Windows and UNIX) and not on the EBCDIC systems (z/OS and IBM i). You can specify two conversion tables: one on the local side (LCT), and one on the remote side (RCT). If you want to perform translation on one side of the transfer and not on the other side, specify a translation table of None.

Example: LCT:CustomTable RCT:None or LCT:None RCT:CustomTable

You can define the local conversion table using the LocalCTFile parameter in a transfer template or the lct parameter on the command line. Similarly, you can define the remote conversion table using the RemoteCTFile parameter in a transfer template or the rct parameter on the command line. The maximum lengths of the lct and rct parameters are both 16 characters. However, they support file names relative to the current working directory and the $CFROOT directory.

Note: If both the ConvTbl and the LocalCTFile parameters are specified, the LocalCTFile parameter overrides the ConvTbl parameter. The platform server does not convert the file twice. The ConvTbl parameter is not affected by RemoteCTFile.

For a File Send, the top 16 lines of the conversion table is used for ASCII to EBCDIC conversion. For a File Receive, the bottom 16 lines of the conversion table is used for EBCDIC to ASCII conversion. For example, in a send transfer, if both the LocalCTFile and RemoteCTFile parameters are used, then the top half of local conversion table file is used on the local side, and the bottom half of remote conversion table file is used on the remote side. The reverse is true for a receive transfer.

Nodes also support both local and remote conversion tables. Unless the parameters are overridden on the command line, conversion tables are used whenever that node is specified.