Information Center

Using the user-defined character (UDC) mapping editor

If you want to use customized user-defined character (UDC) mapping in your session (3270, 5250, 3270 host print) instead of default mapping, you can create a UDC mapping table using the UDC mapping editor to store customized mapping for your session.

Creating a new mapping table

To create a new mapping table using the UDC mapping editor, complete the following steps:

  1. Select the host code page you want to customize your user-defined characters using the Session Configuration window.
  2. Start the UDC mapping editor.
  3. When the UDC mapping editor panel opens, Select File > New to create a new mapping table. (Select File > Open to update an existing mapping table that you already created.)
  4. Set the current mapping for the mapping table. Do this by selecting the Set menu and indicating what language the source is in and what language the source is translated into. For example, Host to Local indicates that this mapping table takes host code point and translates it into code point that the local workstation processes.
  5. Change any mapping in the mapping table as needed. For example, you can map a user-defined host character X to a user-defined character Y on the local workstation. To do this:
    1. Select the Search menu and type the code point of character X into the search window. The mapping table is refreshed and a rectangular box appears around the position of the code point.
    2. Double-click inside the rectangular box. A window prompts you for the new code point number.
    3. Type the mapping number into field, or use the up and down arrow keys to adjust the value of the code point.
    4. Click OK to close the window. The new mapping appears in the User-Defined Character Mapping Editor table.
  6. When the mapping table is finished, save it. Select File > Save As, and indicate what you want to call the file and where you want to save it. Use *.gtt as the file type, and save it in the HOD/udctransl/ directory.

Describing the User-Defined Character Mapping Editor window fields

File menu

New
Opens a new mapping table with default mapping between host code point and local code point.
Open
Opens an existing mapping table. Mapping tables are named *.gtt and are located in the HOD/udctransl/ directory.
Save
Saves the already named mapping table. If a mapping table has not been named yet, you are prompted for a name and location.
Save as
Saves the mapping table in a name and location that you designate. Use *.gtt to indicate a mapping table. Use HOD/udctransl/ as the location.
Exit
Closes the User-Defined Character Mapping Editor window without saving the changes made since you last saved the table.

Set menu

You can set current mapping of the mapping table by indicating what format the source code is in and what format the code is translated into. For example, if you get your source file from the host and you want to translate it into coding for a local workstation, you select Host to Local.

Host to Local
Indicates that you want this mapping table displayed as mapping host code point into local code point.
Local to Host
Indicates that you want this mapping table displayed as mapping local code point into host code point.
Host to JIS (for Japanese host code-page only)
Indicates that you want this mapping table displayed as mapping host code point into JIS code point.
Host Han to JIS (for Japanese host code-page only)
Indicates that you want this mapping table displayed as mapping host Han code point into JIS code point.
Host Han to Local (for Japanese host code-page only)
Indicates that you want this mapping table displayed as mapping host Han code point into local code point.
Local to Host Han (for Japanese host code-page only)
Indicates that you want this mapping table displayed as mapping local code point into host Han code point.
JIS to Host (for Japanese host code-page only)
Indicates that you want this mapping table displayed as mapping JIS code point into host code point.
JIS to Host Han (for Japanese host code-page only)
Indicates that you want this mapping table displayed as mapping JIS code point into host Han code point.

Search menu

If you want to specify a code point that is not on the current display of the mapping table, you can use this menu item to search for it. After making any of the menu selections below, a search window appears.

Search Host Code
Use host code point as an index to search the code point you need through the window.
Search Local Code
Use the local code point as an index to search the code point you need through the window.
Search Host Han Code (for Japanese host code-page only)
Use host Han code point as an index to search the code point you need through the window.
Search JIS Code (for Japanese host code-page only)
Use JIS code point as an index to search the code point you need through the window.

Help menu

You can get help information from this menu item.

Using your customized mapping table during a session

Before you start your session, you can configure your session to use or not to use a UDC mapping table. The default is to connect without a UDC mapping table. In the Session Configuration window, you can load the edited UDC mapping table from the Language tab. After you select the table you want to apply, you can start this session with this UDC mapping table during the whole session.

Limitations