Translation Table Syntax

Each translation table is a script that indicates characters that will be replaced with other characters when they are either sent to or received from the host. Translation table files use the following syntax:

[DIM number]
[NAME "table_name"]
[DESC "table_description"]
BEGIN
   65=66
   0x41=0x42
END

Where:

Items in brackets are optional (if you include these items, do not type the brackets).
Bold text specifies required elements that you must type exactly as shown.
Italic text represents variables and other placeholder information you must provide.

You can use either uppercase or lowercase for the commands (for example, NAME or Name), and either decimal or hexadecimal values for the characters. For example, you can express the letter Ç as 199 (decimal) or 0xC7(hexadecimal).

Place statements in the order specified in the syntax example.
Hexadecimal values must be preceded by a zero and the letter x (for example, 0xC7).
You can use a hyphen and greater than symbol (- >) instead of the equal sign (=).
Wildcard characters (such as * or ?) are not supported; these are treated as literal characters.
Do not duplicate values within the translation table. For example, do not include both 65=66 and 65=67, or both 65=66 and 67=66.

For a list of values that can be used in translation tables, see the topic ASCII Tables.

The following table provides detailed information about each command:

Syntax Item	Description
DIM number	The length of the character strings being translated by this translation table; appears in the script for informational purposes only. For example, if you are replacing one character with another, you could include the statement DIM 1.
NAME "table_name"	A name for the translation table; appears in the script for information purposes only. The table_name can be up to 31 characters long and can contain spaces. It must be enclosed in quotation marks (").
DESC"table_description"	A description for the translation table; appears in the script for information purposes only. The table_description can be up to 80 characters long and can contain spaces. It must be enclosed in quotation marks (").
BEGIN	Marks the beginning of the character translation script.
character translation script	The lines between the BEGIN and END statements, indicating the characters to translate (for example, to translate A into B, you would type 65=66). The values in this section of the translation table are reflexive. That is, when the host sends data to the client, the value to the right of the equal sign is converted into the value to the left of the equal sign. When the client sends data to the host, the value to the left of the equal sign is converted into the value to the right of the equal sign.
END	Marks the end of the character translation script.

Sample Translation Table

Following is the content of the A-French.tbl translation table. Decimal numbers are used to represent characters (for example, 163 = 35). If it were written in hexadecimal format, it would read 0xA3 = 0x23, 0xA7 = 0x5D, and so on.

DIM 1
NAME "ASCII - French"
DESC "ASCII - French"
BEGIN
  163 = 35
  167 = 93
  168 = 126
  176 = 91
  224 = 64
  231 = 92
  232 = 125
  233 = 123
  249 = 124
END

In this translation table, the following characters are exchanged.

This character	Is changed to
£	#
§	]
¨	~
°	[
à	@
ç	\
è	}
é	{
ù	\|


	Synapta Services Builder, Overview
	Translation Tables, Overview
	Creating or Editing a Translation Table
	ASCII Tables