Modifying the code conversion tables on Windows systems

The code conversion tables are located in the library utmconvt.dll. utmconvt.dll is located in the same directory as libwork.dll.

You can adapt these conversion tables to your own requirements by modifying the source file kcsaeea.c supplied in the directory utmpath\src and creating a modified utmconvt.dll.

In addition utmpath\src contains the resource file utmconvt.rc with version and copyright information. This information is displayed if you right-click the dll file and select Properties. It is not essential for this file to be included.

Modifying the library utmconvt.dll

To modify the library utmconvt.dll the following steps are necessary:

1. Copy the file kcsaeea.c to a separate file directory.

2. Modify the conversion tables according to your requirements. To do this, edit the file kcsaeea.c with a text editor. For each of the four code conversions, kcsaeea.c contains two character arrays with a length of 256. One array is used for ASCII → EBCDIC conversion, the other for EBCDIC → ASCII conversion.

3. Start Microsoft Visual Studio and proceed as follows:

   1. In the utmpath directory, create a new Win32 or X64 project with the name utmconvt and with the application type Dynamic Link Library.

   2. Add the following files to the project:

      • The modified code table file kcsaeea.c,

      • and, if required, utmconvt.rc.

   3. Assign the file utmconvt.def to the project as module definition file (Project properties → Linker → Module Definition File).

   4. From this project, create the library utmconvt.dll.

   5. Close Microsoft Visual Studio

4. Replace the old library utmconvt.dll with the new library:

   • First back up the library under a different name, so that you can access it again if anything goes wrong.

   • Copy the new utmconvt.dll to the directory which contains the UTM library libwork.dll (this is generally utmpath\ex). Make sure that the original utmconvt.dll is actually replaced by the new utmconvt.dll.

The new conversion library is ready for use.