CA Workload Automation DE: Incorrect Chinese/Japanese/Korean Characters in mail

Products

• CA Workload Automation DE - Business Agents (dSeries)
• CA Workload Automation DE
• DSERIES- SERVER
• CA Workload Automation DE - System Agent (dSeries)
• CA Workload Automation DE - Scheduler (dSeries)

Issue/Introduction

When DE (dSeries) sends an email, the UTF-8 (Japanese/Chinese) characters are not properly displayed.

Environment

Release :  12.x

Component : CA WORKLOAD AUTOMATION DE (DSERIES)

Cause

The UTF-8 encoding is needed.  The OS must be able to support UTF-8 characters.  In Linux/UNIX, make sure user profile that starts DE service has UTF-8.

E.g. for Linux add the following in user profile (.profile or .bash_profile)

LC_ALL=en_US.UTF-8
LANG=en_US.UTF-8
LANGUAGE=en_US.UTF-8

Resolution

Additionally, add the following property 

In Windows:

Edit windows.service.properties in <drive:>/<DE  Install Directroy>/conf

jvmproperty_11=-Dfile.encoding=UTF8

Note: The number for jvmproperty_nn will depend on the last property on the windows.service.properties file.  Change the number to appropriately.  There should not be any gaps in the number sequencing.

In Linux and UNIX:

Edit the startServer file in /<DE  Install Directroy>/bin  

In ARGS  add -Dfile.encoding=UTF8  at the end of the statement.  

E.g.

ARGS=" -Xms${MIN_HEAP_SIZE}m -Xmx${MAX_HEAP_SIZE}m  -XX:-PrintGC -XX:HeapDumpPath=./java_pid<pid>.hprof -Duser.dir=${CAWA_HOME} -Dserver.pidfile=${PID_FILE} -Duser.language=en -Dlog4j.configuration=file:///${CAWA_HOME}/conf/server.log4j.xml  -Dlax.root.install.dir=${CAWA_HOME}/

 -Dfile.encoding=UTF8 "

Add the encoding parameter at the end but before the ending double quote (").

Restart the server for the changes to effect.

Additional Information

Note: Consult your OS manual for variables needed for UTF-8 support .

Windows: Install the language pack for the language needed.

Database:  The database must also support UTF-8 encoding for DE to store messages and data.