IBM Support

Creating a Unicode database for use with DB2 Content Manager OnDemand on UNIX

Question & Answer


Question

How do you store data into DB2® Content Manager OnDemand from many different languages and locales? Does DB2 Content Manager OnDemand support Unicode?

Cause

A Unicode database is not directly supported by OnDemand using the ARS_LANGUAGE parameter in the ars.cfg configuration file.

Answer

OnDemand uses UTF-8 for its Unicode database. Complete the following steps to create an OnDemand Unicode database:

  1. Ensure that you have all of the following prerequisites:
    • UTF-8 locale environment
      AIX®: You can use lslpp -l 'bos.loc.utf.*'
      Solaris Operating Environment: You can use pkglist | grep UTF-8 or enter locale -a | grep UTF-8
      HP-UX: You can use swlist or use locale -a | grep utf8
      Linux: rpm -q or use locale -a | grep utf8
    • DB2 Universal Database™ V8


    • Ensure that the DB2 Universal Database conversion packages are installed.
      For example, on AIX: lslpp -l db2_08_01.cnvucs and lslpp -l db2_08_01.conv                                            
      Use the equivalent command on the other UNIX® operating systems.
    • DB2 V9 and above will have the correct environment installed.

2. Set up OnDemand to recognize a UTF-8 environment.
    • DB2 Universal Database:

    • Follow the DB2 Universal Database and OnDemand installation instructions until you need to specify the ARS_LANGUAGE in the ars.cfg file.
      Add the following entries:
      ARS_CODEPAGE=1208
      ARS_CODESET=UTF-8
      ARS_LOCALE=en_US
      ARS_USE_LOCALE=1
      Change your language environment:
      export LANG=EN_US.UTF-8
      and run the arsdb -cv command
      These steps allow you to create a DB2 Universal Database UTF-8 database.
    • Oracle:

    • Use the Oracle Database Configuration Assistant. You need to customize the database settings and change the Character Set to UTF-8.
      Add the following entries to the ars.cfg:
      ARS_CODEPAGE=1208
      ARS_CODESET=UTF-8
      ARS_LOCALE=en_US
      ARS_USE_LOCALE=1
      Change your language environment:
      export LANG=EN_US.UTF-8
      and run the arsdb -rtv command

3. Start OnDemand in a UTF-8 language environment.
    This step is best done with a script similar to the following sample:

    #!/bin/ksh
    #
    # Set the language environment
    export LANG=EN_US.UTF8
    #
    # Start OnDemand
    /usr/lpp/ars/bin/arssockd


    You are now running OnDemand in a UTF-8 environment with a UTF-8 database.

[{"Product":{"code":"SSEPCD","label":"Content Manager OnDemand for Multiplatforms"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Database","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF027","label":"Solaris"},{"code":"PF016","label":"Linux"},{"code":"PF025","label":"Platform Independent"}],"Version":"8.4;8.3;7.1.1;7.1","Edition":"All Editions","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
17 June 2018

UID

swg21205960