Remapping keyboard and display characters

ZIETrans support for Host On-Demand custom tables allows you to remap the user's keyboard and display characters by customizing the host to PC code page conversion tables. A custom table file can contain any number of tables, in any combination of keyboard and display tables. Keyboard tables remap the user's keyboard characters as input customized for a host application. Display tables remap host display characters into screen output customized for the user.
Note: This remapping has no relation to ZIETrans keyboard mapping. This remapping deals with character remapping, for example, a, b, and c. Whereas ZIETrans keyboard mapping deals with control key mapping, for example, Clear, Enter, and F1. For more information about ZIETrans keyboard mapping see Enabling keyboard support.
A sample custom table file, CustomTableExample.txt, is located in the <ZIETrans>\plugins\com.hcl.zietrans.rcp.workbench_nnn n\zietrans\customtables directory. The file format is similar to that of Java™ properties files. Lines that start with # are comments, and variables shown as n and N are hexadecimal values. The following example shows the format of the sample custom table file. 
##### Start of file
# Map SBCS Local nn to SBCS EBCDIC NN in keyboard table
sbcs.keyboard.0xnn=0xNN
# Map DBCS Unicode nnnn to DBCS EBCDIC NNNN in keyboard table
dbcs.keyboard.0xnnnn=0xNNNN
...
# Map SBCS EBCDIC NN to SBCS local nn in display table
sbcs.display.0xNN=0xnn
# Map DBCS EBCDIC NNNN to DBCS Unicode nnnn in display table
dbcs.display.0xNNNN=0xnnnn
...
##### End of file
To enable the use of custom tables in your project:
  1. Create a custom table file using the sample as an example and copy it into a folder named, customtables, in the root of the .ear project of your ZIETrans Web application. If the customtables folder does not exist, create one.
  2. Open your ZIETrans project.
  3. Edit the connection by double-clicking the name in the Connections directory.
  4. Click the Advanced tab.
  5. Click Add.
  6. In the Add Parameter dialog, select CustomTable from the drop-down list for Name and enter the name of your custom table file in the Value field.
  7. Click OK to exit the Add Parameter dialog.
  8. Save your changes to the connection settings.
Parent topic: Language support