Configuring Western European language support (UNIX and Linux)

For Control-M components to communicate properly with each other, you must set the locale for all product components to the same value. Complete this task on every computer or UNIX account that runs components of the following products:

• Control-M/EM
• Control-M/Server
• Control-M/Agent
• BMC Batch Impact Manager
• Control-M Application Plug-Ins

To configure the UNIX or Linux environment:

1. Ensure that the required language locale is present on the computer.

   Use the same language locale for all affected computers. Discrepancies between locale settings, especially those involving different character sets, can corrupt data as it passes between components.

   1. To get a list of locales available on your computer, enter the locale -a command.
   2. Confirm that the list includes the required locale as shown in the following table. If the required locale is missing, ask your UNIX administrator to install it.

   ISO Latin -1 character set locale settings for UNIX and Linux

   Language	AIX\®, Solaris, Compaq (OSF)	HP-UX	Linux (RedHat)	Linux (SuSE)
   English (USA)	en_US.ISO8859-1	en_US.iso88591	en_US.iso88591	en_US
   English (British)	en_GB.ISO8859-1	en_GB.iso88591	en_GB.iso88591	en_GB
   German	de_DE.ISO8859-1	de_DE.iso88591	german	german
   French	fr_FR.ISO8859-1	fr_FR.iso88591	french	french
   Spanish	es_ES.ISO8859-1	es_ES.iso88591	spanish	spanish

   When configuring Control-M/Agent on operating systems not listed in the above table, use the locale setting for the operating system that corresponds to the one selected for Control‑M/EM and Control-M/Server. For help, contact your UNIX administrator.

2. Set the values shown in the following table in the .ctmcshrc file for Control-M/Server, the $HOME/ctm_em/etc/em_env.csh file for Control-M/EM, and in the .cshrc file for all other components.

   If necessary, add lines for these environment variables, listing them in the order shown in the following table.

   UNIX environment variables for West European languages

   Environment variable	Description / value
   LC_ALL	"" (an empty string) Set this variable by adding the following line to the .ctmcshrc file for Control-M/Server, the $HOME/ctm_em/etc/em_env.csh file for Control-M/EM, and in the .cshrc file for all other components: setenv LC_ALL ""
   LC_CTYPE and LANG	the value of the required language locale. See the previous table for UNIX locales. Set these variables by adding the following lines to the .ctmcshrc file for Control-M/Server, the $HOME/ctm_em/etc/em_env.csh file for Control-M/EM, and in the .cshrc file for all other components: setenv LC_CTYPE localeName setenv LANG localeName
   LC_COLLATE	C for all languages (or c, as defined on the computer). To determine whether the C locale is present, use the locale -a command. If the C (or c) locale is not present, you can use POSIX or one of the English locales that appear in the previous table. Set this variable by adding the following line to the .ctmcshrc file for Control-M/Server, the $HOME/ctm_em/etc/em_env.csh file for Control-M/EM, and in the .cshrc file for all other components: setenv LC_COLLATE C
   LC_MESSAGES	C (or c, as defined on the computer) for all languages on accounts where Control-M/Server is installed. This variable only applies to Control-M/Server only. To determine whether the C locale is present, use the locale -a command. If the C (or c) locale is not present, use POSIX or one of the English locales that appear in the previous table. Set this variable by adding the following line to the .ctmcshrc file for Control-M/Server, the $HOME/ctm_em/etc/em_env.csh file for Control-M/EM, and in the .cshrc file for all other components: setenv LC_MESSAGES C

   The following examples reflect the values that are set after applying the values to the environment in the next step.

   LC_ALL=
   LC_CTYPE=de_DE.ISO8859-1
   LANG=de_DE.ISO8859-1
   LC_COLLATE=C
   LC_MESSAGES=C

3. To apply the new settings to the environment, run the following command:
   • for Control-M/Server source ~/.ctmcshrc
   • for all other components (there is no need to run this command for Control-M/EM) source ~/.cshrc

   For more information about the Locale parameter, see Agent configuration parameters.