ARS_ORIGINAL_CODEPAGE parameter

Specifies the code page of the Content Manager OnDemand database and is mandatory.

You can run the ARSDB -u program without specifying the ARS_ORIGINAL_CODEPAGE parameter in the ARS.CFG configuration file to determine the correct setting. The ARSDB -u program should only be run one time, to determine the value for the ARS_ORIGINAL_CODEPAGE parameter. It should never have to be run again, regardless of migration, platform change, and so on. Once the code page is determined, set the ARS_ORIGINAL_CODEPAGE parameter accordingly.

When you run the ARSDB -u program without specifying the ARS_ORIGINAL_CODEPAGE parameter in the ARS.CFG file, the ARSDB program displays the ARS4012E message.

Example output from running ARSDB -u:

ARS4012E Unable to initialize environment. The return code is -1. If this is a new 
   (created in version 8.5 or later) instance, then define ARS_ORIGINAL_CODEPAGE=819 
   in ars.cfg. Otherwise, if this is an existing instance (created prior to 8.5), then 
   define ARS_ORIGINAL_CODEPAGE=923 in ars.cfg. Once set, ARS_ORIGINAL_CODEPAGE must 
   never change.

Review the instructions in the message regarding the correct value to assign to the ARS_ORIGINAL_CODEPAGE parameter. In this example, the ARS_ORIGINAL_CODEPAGE parameter should be set to 923 because the instance in the example was created prior to V8.5. For an instance created in V8.5 or later, the ARS_ORIGINAL_CODEPAGE parameter should be set to 819.

In most cases, once the ARS_ORIGINAL_CODEPAGE parameter value is set, it must never be changed. However, there are some scenarios where a change to this parameter might be required. For example:
  • Changing the underlying Content Manager OnDemand operating system (such as changing from AIX to Linux)
  • Moving the Content Manager OnDemand instance database to new hardware or a new operating system where the new locale might be different than the original system
  • Migrating the Content Manager OnDemand instance database to Unicode (UTF-8)

In these scenarios which might affect the setting of the ARS_ORIGINAL_CODEPAGE parameter, you should consult with IBM Services to help you determine the correct value.

This parameter is required.