Use this variable to set the name and path of the map file to be used (if any) to map special characters in your character set to their decimal or hexadecimal equivalent in another character set before they are passed to or from the Vision file system. This file lets you reconcile the character encoding between two machines that use different codes for the same characters.

You can specify a local or remote directory for the map file. To specify a remote directory, use the following syntax:


where server-name is the name of the UNIX/Linux or Windows server on which the map file resides.

When creating a map file, you need to re-map only those values that vary between the two character sets (e.g., vowels with a grave accent, acute accent, circumflex, tilde, etc.) You can check the values of specific characters using the Windows Character Map accessory in the PC environment, or by referring to your UNIX manual pages (man pages) in the UNIX environment.

The map file should contain two values per line: the first indicating the decimal or hexadecimal value of the special character on the client machine and the second indicating the decimal or hexadecimal value of the corresponding character on the server machine. (Hexadecimal values use the standard 0x notation.) For instance:

0x90 0xC9 

maps "É" (E acute) in the IBM PC character set to "É" (E acute) in the ISO8859-1 character set using hexadecimal notation.

144 201 

gives the same mapping using decimal notation.

You can use the pound sign ("#") to indicate a comment.

Note: The map will be used to translate only alphanumeric fields; but it will translate all alphanumeric fields, including group items and items subject to a REDEFINES clause. If this is not a desired behavior, you may need to restructure your program to avoid these clauses by passing the elementary items instead of the group item, or passing an item from the REDEFINES clause instead of the first reference.