Dynamic character mapping allows user to have multiple character maps available at all times. When a telnet connection is made to Pragma TelnetServer, the user can be prompted to select which character map best matches the client being used.

The character maps are defined in the charmap.ini file. The character map section is defined by a heading, enclosed in brackets, and a series of source ASCII code = target ASCII code sequences, one per line. Both ASCII codes are in decimal form. Use the Show Current Character Set utility, charset.exe, to display the current character set of the console. The heading line, including comments, will be shown as an option choice at connection. All headings will be displayed in the order they are listed in the file.

The file should be located in the same directory as the server program itself. A default charmap.ini file is installed with the server.

The default file contains a section for the default Windows client, labeled [MICROSOFTCLIENT]. This section is defined based on any font other than Terminal. If the Terminal font is used, [vtxxx] character mapping should be used.

Example

In the standard English character set, code page 437, change all lower case a's to display on the client as capital A's.

1.type charset at the telnet command prompt to display the codes for each character

2.look up the value for 'a', which equals 97

3.look up the value for 'A', which equals 142

4.in the charmap.ini file, create a new heading [NOLITTLEA]

5.add the line 97=142

6.save the file

7.when logging on select the heading [NOLITTLEA] character map

This is a simplified example, but the process is the same to change the character that is displayed incorrectly to a nicer character that will make the display more eye pleasing.

Note: The charset program should be run in the telnet session to make sure the new character is the proper one to display.

See User Console Settings for information on setting a Default Character Map.