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:
- 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.
- Open your ZIETrans project.
- Edit the connection by double-clicking the name in the Connections directory.
- Click the Advanced tab.
- Click Add.
- 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.
- Click OK to exit the Add Parameter dialog.
- Save your changes to the connection settings.