Reconfigure the Shift-JIS Characters to Unicode Mapping

You can fine tune the mapping from Shift-JIS to Unicode and back that the IBM® Cognos® Series 7 migration service uses by placing a configuration file named shift-jis.xml in your s7_location\migs7 directory.

This file employs the same format as is used by the IBM Cognos Analytics Round Trip Safety Configuration utility.

For more information about the Round Trip Safety Configuration utility and how it affects IBM Cognos Analytics's runtime behavior, see the IBM Cognos Analytics Administration and Security Guide.

Tip: You may find it easier to generate a shift-jis.xml file with the Round Trip Safety Configuration utility and then fine tune the resulting shift-jis.xml file by hand.

Before you begin

We recommend that you first back up the existing shift-jis.xml file in case you want to go back to the original version.

Procedure

  1. Start the Round Trip Safety Configuration utility:
    • On the Microsoft Windows operating system, double-click install_location\bin\rtsconfig.bat.
    • on the UNIX operating system, run the command install_location/bin/rtsconfig.
  2. In the Conversion tab, specify how to render the listed Unicode characters to Shift-JIS.
  3. In the Substitution tab, specify how certain Shift-JIS characters are rendered into Unicode.
  4. Save your changes.

    The file install_location\bin\shift-jis.xml is updated.

  5. Copy the shift-jis.xml file to the s7_location\migs7 location.
  6. If you need to manually edit the file, open the file in the s7_location\migs7 location using an XML or text editor and make the changes that you want.
  7. Create an environment variable named PYCODECS_MAP_DIR and point it to the s7_location\migs7 folder.

    For example, C:\Program Files\Cognos\cer5\migs7.

    Note: In Windows, you must make this a system environment variable and not a user variable so that it is accessible to the IBM Cognos Series 7 migration service.
  8. Stop and restart the IBM Cognos Series 7 migration service:
    • On Windows, change to the s7_location/migs7 directory, and use the following command:

      configure.exe --stop

      To restart the service, use the following command:

      configure.exe --start

    • on the UNIX operating system, change to the s7_location/migs7 directory, and use the following command:

      ./configure --stop

      To restart the service, use the following command:

      ./configure --start

Results

Note: If you leave a copy of your shift-jis.xml file in the install_location\bin directory, it will affect IBM Cognos Analytics's run-time behavior when interacting with end users and with databases that do not provide their own conversion mechanisms. If you do not want to change this behavior, restore the shift-jis.xml file located in the install_location\bin\folder to the backup version.