The format of the abtrules.nls file is:

The file's elements mean the following:

The following is an example entry in the file: 'german-germany- -' g

VAST Platform uses the following country characters:

You can add your own entries to the abtrules.nls file to support more languages and territories. To see what language and territory your system uses, Display the expression Locale current. To see what languages and territories VAST Platform can support, Inspect or Display Locale knownLocales.

The code pages for many of these languages are in the abtrules.all file provided with VAST Platform. You can copy a code page from abtrules.all file and add it to abtrules.nls file. For supported languages, VAST Platform displays country-sensitive data (such as currency symbols and decimal separators) in the format that is appropriate for that language.

An .mpr file includes the code page used when the .mpr file was built.

If a code page contains characters that do not map correctly to the character set used by your workstation or if you need to change a code page, you can copy a code page from abtrules.all, insert it into abtrules.nls, change the characters in the inserted code page as needed, and restart VAST Platform.

To find a code page that is appropriate for your system, use font information returned by the operating system. Select Set Browser Font from a File menu to open a Font Selection dialog. The character set (Charset) name is used to select the correct mapping table from abtrules.nls. The character set varies among operating systems; on Linux, the character set might be iso10646-1, whereas on Windows, it might be iso8859-1.

Look at abtrules.nls. Notice that many of the standard code pages like iso8859-1 are the same as IBM code pages. IBM code pages are by number only (437, 850, 819, 1041, 897, and so on). The :alias keyword in abtrules.nls indicates what code pages with different names are really the same code page. For example, :alias alias=iso8859-1 base=ibm-819 indicates that the standard code page iso8859-1 and the IBM code page ibm-819 are the same.

Look at the :table part of the abtrules.nls file. It maps one code page to another. A line such as :table from=ibm-437 to=ibm-819 followed by a 16x16 array of number, indicates what code point in the from code page maps to another code point in the to code page.

What does this all mean for you? Suppose accents from an .mpr file created on Linux under code page 10646do not appear correctly on Windows. That means a mapping table was not found. To fix this, you look in abtrules.all and copy the correct table into abtrules.nls, then restart VAST.

To find the correct table, open the Font Selection dialog on your Windows machine. The Charset field displays the value you should use for the to: parameter in abtrules.nls. The correct value should be in abtrules.all, which has the common code pages' mapping tables.

Of course, you can create your own code page mapping table. VAST provides this capability so you can use code pages that were not included in abtrules.all.

Suppose you have strings that are not in a visual part and that are specific to a code page (such as text typed by a user under code page 437). If you display those strings on a system using a different code page, you might see incorrect characters. One way to ensure that users on different systems see the correct characters is to normalize the strings to a common code page before storing them to an external resource, and then revert to the current code page when the strings are read again. You can normalize to a single code page using expressions such as:

Another option is to store the code page with the strings, which is what VAST does with an .mpr file.

As a last resort, you can ignore the problem and accept that some characters may be incorrect if a user's system is using an incompatible code page.