Overriding Character Translations in Flex Terminal Emulator

Overriding Character Translations in Flex Terminal Emulator

If certain host characters are not displaying correctly in Flex Terminal Emulator, you can override the default character translations to achieve the desired output.

Availability

The ability to override character translations is supported in Flex Terminal Emulator version 4.0.4024.1512 and later. Ensure you are running this version or newer before using this feature.

How to Override Character Translations

To customize character mappings, follow these steps:
  1. Create a plain text file containing the translation overrides.
  2. Save the file in the Flex Terminal Emulator working directory, for example:
    C:\Users\UserName\Documents\FlexSoftware\FlexTerm
  3. Name the file according to the host code page you are using.
    • Example: If your session uses code page 1140 (US/Canada – Euro), name the file: 1140.atb

File Format

Each line in the file defines a character translation override using the following format:
<Host Hex Value>=<Unicode Hex Value>
  • The left side is the host (EBCDIC) character in hexadecimal.
  • The right side is the corresponding Unicode character (also in hexadecimal) that you want displayed.

Example

If you want to override specific characters:
  • Map host character 0xAD to [ (Unicode 0x5B)
  • Map host character 0xBD to ] (Unicode 0x5D)
Your 1140.atb file would contain:
AD=5B
BD=5D

Notes

  • The override file is automatically applied when Flex Terminal Emulator starts and detects a matching file for the active host code page.
  • You can add multiple mappings to the same file as needed.
  • Ensure that all values are entered in hexadecimal format without prefixes (such as 0x).

Notes
This feature allows you to fine-tune character display and resolve encoding inconsistencies specific to your host environment.

    • Related Articles

    • Supported Host Code Pages in Flex Terminal Emulator

      Flex Terminal Emulator supports a range of host code pages to ensure compatibility with different regional and language requirements. Available Host Code Pages The following host code pages are supported: 037 – US / Canada 273 – Austria / Germany 277 ...

    • Applying or Updating a Flex Terminal Emulator License Code

      This article explains how to apply or update your Flex Terminal Emulator license using the application interface, the FlexLicense utility, or automated deployment methods for enterprise environments. Apply or Update License Using the Workspace Follow ...

    • Exporting a Host Screen to Microsoft Word

      Flex Terminal Emulator allows you to export the contents of a host screen directly into a Microsoft Word document using a macro. This is useful for documentation, reporting, or sharing screen data. Overview The macro performs the following actions: ...

    • Exporting a Host Screen to an Outlook Email

      Flex Terminal Emulator allows you to export the contents of a host screen directly into a new Microsoft Outlook email using a macro. This is useful for quickly sharing or documenting screen data. Overview The macro performs the following actions: ...

    • Exporting Host Screen Data to Excel Using a Macro

      Flex Terminal Emulator allows you to automate the extraction of data from host screens and export it directly into an Excel spreadsheet using a macro. This approach is useful for collecting structured data across multiple screens. Overview A macro ...