Western European Language Configuration

The Western-European (Latin-1) language set includes support for the following languages - English (USA), English (British), Spanish, German, and French.

You can configure the following components to support the Latin-1 character set (ISO 8859-1) in most text fields and parameters:

  • Control-M

  • Control-M/EM

  • Control-M/Forecast

  • Control-M/Server utilities

  • Control-M/Agent utilities

  • BMC Batch Impact Manager

  • Control-M Reports

    Control-M assumes that all third-party databases communicate with Control-M in English only even if the data is in another language.

For a list of parameters that support Western European Language special characters, see Parameters that Support Western European Special Characters. The following characters are not supported for any parameters:

The following procedures describe how to configure the Latin-1 language support for Control-M:

Installing Display Language for Western European in Windows

This procedure describes how to install the display language for Western European in Windows.

Windows uses the display language for the user interface.

Begin

  1. From the Control Panel, click Clock, Language and Region and then click Install or uninstall display languages.

    The Choose to install or uninstall display languages window appears.

  2. Click Install display languages.

    The Select the display languages to install window appears.

  3. Click Browse and browse to the location that contains the display language files.

  4. Click Next.

    The display language appears in the Choose a display language drop-down list.

  5. Click OK.

Setting the Code Page via the Windows Registry

This procedure describes how to set up the code page via the Windows registry.

This is what defines the character set for the Latin-1 language. The code page includes the characters and corresponding binary digits which are used to display and print the language correctly.

Begin

  1. From the Start menu, type regedit.

    The registry editor window opens.

  2. Navigate to

    [HKEY_LOCAL_MACHINE\Software\Microsoft\Command Processor]

  3. Click Edit > New > String Value.

  4. In the Name field, type AutoRun.

  5. Right-click on AutoRun and select Modify.

    The Edit String dialog appears.

  6. In the Value data field, type chcp 1252.

Setting the Code Page via the Windows Command Prompt

This procedure describes how to set the active code page for Latin-1 language via the Windows command prompt.

Begin

  1. From a command prompt, type chcp.

    The current active code page appears.

  2. Change the active code page to Multilingual (Latin 1), type chcp 1252.

Configuring Western European Language Support on UNIX or Linux

This procedure describes how to configure Western European language support on UNIX or Linux.

Update the locale to the same value on every computer or UNIX account.

Before You Begin

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.

Begin

  1. From a command prompt, type the locale -a command.

    A list including the supported character set locale settings appears, as described in ISO Latin-1 character set locale settings for UNIX or Linux.

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

  2. Set the values as described in UNIX environment variables for West European languages in the following files:

    • Control-M/Server - .cshrc or .profile file

    • All other components - .cshrc or .profile file

    • Control-M/EM - If the .cshrc or .profile file is not updated with environment variables, create a em_env_local.sh file under $HOME/ctm_em/etc/

      LC_ALL=

      LC_CTYPE=de_DE.ISO8859-1

      LANG=de_DE.ISO8859-1

      LC_COLLATE=C

      LC_MESSAGES=C

      If necessary, add lines for these environment variables, listing them in the order, as described in UNIX environment variables for West European languages.

  3. Run the following command from the relevant component:

    • Control-M/Server: source ~/.ctmcshrc

    • Other components: source ~/.cshrc (there is no need to run this command for Control-M/EM)

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

ISO Latin-1 Character Set Locale Settings for UNIX or Linux

The following table lists the character set locale settings for each of the UNIX or Linux machines for each of the ISO-Latin-1 supported languages.

If the required locale is missing, ask your UNIX administrator to install.

Language AIX\®, Solaris, Compaq (OSF) Linux (RedHat) Linux (SuSE)

English (USA)

en_US.ISO8859-1

en_US.iso88591

en_US

English (British)

en_GB.ISO8859-1

en_GB.iso88591

en_GB

German

de_DE.ISO8859-1

german

german

French

fr_FR.ISO8859-1

french

french

Spanish

es_ES.ISO8859-1

spanish

spanish

UNIX Environment Variables for West European Languages

The following table lists the environment variables and values to use for setting Western European language support on UNIX or Linux machines, as described in Configuring Western European Language Support on UNIX or Linux.

Environment Variable

Description / Value

LC_ALL

"" (an empty string)

Set this variable by adding the setenv LC_ALL "" to the following:

  • Control-M/Server: .cshrc or .profile file

  • Other components: .cshrc or .profile file:

  • Control-M/EM: If the .cshrc or .profile file is not updated with environment variables, create the $HOME/ctm_em/etc/em_env_local.csh file and then add the line

LC_CTYPE
and
LANG

The value of the required language locale for UNIX, as described in ISO Latin-1 character set locale settings for UNIX or Linux.

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 setenv LC_COLLATE C to the following:

  • Control-M/Server: .cshrc or .profile file

  • Other components: .cshrc or .profile file

  • Control-M/EM: If the .cshrc or .profile file is not updated with environment variables, create the $HOME/ctm_em/etc/em_env_local.csh file and then add the line

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 setenv LC_MESSAGES C to the following:

  • Control-M/Server: ..cshrc or .profile file

  • Other components: .cshrc or .profile file

  • Control-M/EM: If the .cshrc or .profile file is not updated with environment variables, create the $HOME/ctm_em/etc/em_env_local.csh file and then add the line

Configuring Language Settings in Control-M

This procedure describes how to configure Control-M/EM system parameters from the Control-M Configuration Manager.

Begin

  1. From the Control-M Configuration Manager, select Tools > System Configuration > Control-M/EM System Parameters.

    The Control-M/EM System Parameters dialog box appears.

  2. Click Advanced.

  3. Set the system parameters, as described in System parameters for Control-M/EM components .

System Parameters for Control-M/EM Components

The following table lists the parameters for Control-M/EM components:

Parameter

Section

Description

Valid Values

Language

General

Defines the language for the entire Control-M.

use_account_locale for the local system locale (as defined on the account or computer)

English (for USA or UK)

German

French

Spanish

These values are not case-sensitive.

EBCDIC_cp

Gateway

(Control-M for z/OS users only)

Defines the EBCDIC code page to which ASCII data is translated.

The same character set code should be defined in Control-M for z/OS.

Use the Comp. Name field to set the scope for this parameter. Specify a specific Control-M name in the Comp. Name field, or an asterisk * for all occurrences of Control-M.

For more information, see Administration.

0 for the default translation table (created in a previous version of Control-M)

1047 for English (USA)

285 for English (UK)

273 for German

297 for French

284 for Spanish

I18N

General

Indicates if set automatically by the system.

latin1