Standard code conversion tables

The conversion tables are provided in a separate library.

At installation, the following files and libraries are installed:

Unix and Linux systems:

• upic-dir/sys/libutmconvt.so (conversion library)

• upic-dir/kcsaeea.c (source file for the conversion tables)

Windows systems:

In Windows, some of these files are installed as a 32-bit or 64-bit version depending on the platform and are given a corresponding suffix. This suffix (32 or 64) is indicated below as nn and is in italics.

• upic-dir\sys\utmcnvnn.dll (conversion library)

• upic-dir\utmcnv\utmcnvnn.rc, resource.h (resource files with version information)

• upic-dir\utmcnv\kcsaeea.c (source file for the conversion tables)

B2000:

• The conversion tables are located in the PLAM library $userid.SYSLIB.UTM-CLIENT.070 in the element KDCAEEA#LLM. This is also the location of the source file KDCAEEA.C.

Source file kcsaeea.c or KDCAEEA.C

The file kcsaeea.c or KDCAEEA.C contains eight tables for four code conversions. The tables provided convert the data as follows:

BS2000, Unix, and Linux systems:

• kcsaebc and kcseasc: ISO8859-i <-> EBCDIC.DF.04.i (EDF04i)

• kcsaebc2 and kcseasc2: ISO8859-1 <-> EBCDIC.DF.04.DRV (EDF04DRV)

• kcsaebc3 and kcseasc3: ISO646-IRV <-> EBCDIC.03.DF.03.IRV (EDF03IRV))

• kcsaebc4 and kcseasc4: ISO646-IRV <-> EBCDIC.03.DF.03.DRV (EDF03DRV).

Windows systems:

• kcsaebc and kcseasc: Windows-1252 <-> EBCDIC.DF.04.F (EDF04F)

• kcsaebc2 and kcseasc2: Windows-1252 <-> EBCDIC.DF.04.DRV (EDF04DRV)

• kcsaebc3 and kcseasc3: ISO646-IRV <-> EBCDIC.03.DF.03.IRV (EDF03IRV))

• kcsaebc4 and kcseasc4: ISO646-IRV <-> EBCDIC.03.DF.03.DRV (EDF03DRV).

In each case, the first and second code conversion are conversions between two 8-bit codes. The third and fourth code conversion are conversions between two 7-bit codes.

Adapting tables in kcsaeea.c or KDCAEEA.C

UPIC always uses the tables kcsaebc and kcseasc for the code conversions. If you want to modify the code conversion for your client applications, you have the following options:

• Modify the tables kcsaebc and kcseasc directly using the editor.

• Use another of the predefined code conversions (e.g. kcsaebc2 and kcseasc2) and rename it to kcsaebc or kcseasc.

• Create your own tables and rename them to kcsaebc or kcseasc.

The following sections describe the individual steps necessary on the different platforms.