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:

Select the host code page you want to customize your user-defined characters using the Session Configuration window.
Start the UDC mapping editor.
- On the Windows platform, start the UDC mapping editor by selecting Start > Programs > HCL Z and I Emulator for Web > Administration > User-Defined Character Mapping Editor.
- On non-Windows platforms that support a graphical user interface, or on the Windows platform if the entry is missing from Start > Programs > HCL Z and I Emulator for Web, you must start the UDC mapping editor from the command line. Follow these steps:
  1. Check whether your system has Java Runtime Environment (JRE) installed. If the Z and I Emulator for Web server or standalone client is running correctly, the JRE should be there.
  2. Change the current directory to the Z and I Emulator for Web code base directory (for example, "C:\Program Files\HCL\ZIEForWeb\ZIEWeb" or "/usr/local/zieforweb/zieweb").
  3. Use the JRE to run the com.ibm.eNetwork.ECL.util.dbcs.UDCMappingEditor with your Java command. For example:
```
java -classpath hoddbg2.jar;. com.ibm.eNetwork.ECL.util.dbcs.UDCMappingEditor
```
    Depending on your configuration, you may have to add the path name to the command and add the proper class path using the -classpath parameter. For example, in Linux:
```
/opt/IBMJava2-13/jre/bin/exe/java  -classpath hoddbg2.jar;.  com.ibm.eNetwork.ECL.util.dbcs.UDCMappingEditor
```
- The UDC mapping editor cannot be used on platforms such as i5/OS, OS/400, or z/OS that lack a graphical user interface.
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.)
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.
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.
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 ZIEWeb/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 ZIEWeb/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 ZIEWeb/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

The UDC mapping editor is a Java application, so a Java runtime environment (JRE) is required to run this application.
If you use Z and I Emulator for Web on a non-Windows platform, you need to install a JRE to run the UDC mapping editor.
The UDC mapping editor can be used only for remapping the user-defined characters in Japanese, Korean, Chinese, and Taiwanese host code-pages.
If you modify and gtt files, you must re-run the UDC Mapping Editor in order to update the index file.