C.1 Modifying a Code Page Translation Table

The tables provide conversions between the ASCII Latin-1 character set and representative national language EBCDIC character sets. In most cases, you do not have to modify them. Simply choose the appropriate translation table for a selected language and enter its file name in the CODEPAGE specification, as explained in Setting Up Data Translations.

However, if you must modify a translation table to suit your purpose, be aware of the following:

  • Ensure you have character mapping information and that you know which code represents a given character. This information is available from a number of sources and is not provided in this documentation. A good source is the IBM National Language Support Reference Manual.
  • If you modify a character code in an outbound table, you must also modify its inbound counterpart.
  • Build tables from scratch is not recommended.
  • The tables have a common format that contains comment lines and required lines. The format must be maintained to ensure proper table operation. Comment lines begin with the # character. Do not alter the following required lines:
    • version (100) specifies the format of the rest of the file.
    • table (256) specifies the size of the table and the min/max number of bytes composing each character code.

    To modify a table, perform the following steps:

    1. Open the file you want to modify with the text editor of your choice. For example:
      edit $TUXDIR/udataobj/codepage/00819x00273

      The text editor opens the file, in this example the translation tables for Germany (00819x00273).

    2. Modify the character code in the outbound table, using the editor functions.
    3. Modify the counterpart character code in the inbound table, using the editor functions.
    4. Repeat Steps 2 and 3 until you have completed the modifications.
    5. Save the file, using the editor functions. Be sure to give it a name other than the original. Do not save modifications to any of the original files provided with your product CD ROM.

      Note:

      To use the file you modified for code page translations, make sure you specify its name using the CODEPAGE option in the DM_REMOTE_DOMAINS section of the Gateway DMCONFIG file.
    6. Exit the editor.
  • Open the file you want to modify with the text editor of your choice. For example:
    edit $TUXDIR/udataobj/codepage/00819x00273

    The text editor opens the file, in this example the translation tables for Germany (00819x00273).