East Asian (CJK) Language Support Configuration

The CJK language set includes support for the following languages:

  • Traditional Chinese (supported in Control-M Web)

  • Simplified Chinese (supported in Control-M Web)

  • Japanese

  • Korean

CJK supports specific job definition attributes, product files, and command line utilities, as follows:

To set up your environment to support the CJK language set, you must configure and synchronize all the computer systems and databases before configuring the language settings for the following Control-M components:

  • Agent

  • Control-M/EM

  • Control-M/Server

  • Control-M Reports

  • Control-M for AFT

Control-M/EM can communicate in English with earlier versions of Control-M/Server and with Control-M for z/OS installations that do not handle CJK characters. This communication is possible because the Gateway detects the type and version of the connected Control-M/Servers (and other Control-M installations, such as z/OS) and translates the data accordingly.

Setting the Code Page for CJK Support on Windows

This procedure describes how to set the code page for CJK support on Windows. This must be done before you install Control-M.

Update the locale to the same value on every computer running Windows that runs the following components:

  • Control-M/EM

  • Control-M/Server

  • Agent

  • Control-M Application Plug-Ins

Begin

  1. From a command line, type chcp <codePage>, where <codePage> can be one of the following values:

    • 932: ANSI/OEM, Japanese Shift-JIS

    • 936: ANSI/OEM, Simplified Chinese GBK

    • 949: ANSI/OEM, Korean

    • 950: ANSI/OEM, Traditional Chinese Big5

      chcp 932.

      If the code page is invalid, contact your system Administrator to install the required code page.

      For Control-M components to communicate properly with each other, you must set the locale for all product components to the same value. Discrepancies between locale settings can corrupt data while data is passed from one component to another.

  2. Ensure that the corresponding code page is selected on the list of Code Page Conversion Tables.

Setting the Locale Environment on UNIX or Linux

This procedure describes how to set the locale environment on a UNIX and Linux machine. This should be done on computers that runs components of the following products:

  • Control-M/EM

  • Control-M/Server

  • Agent

  • Control-M Application Plug-Ins

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.

    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 described in CJK character set locale settings for UNIX and Linux. If the required locale is missing, ask your UNIX administrator to install it.

  • When configuring Agent on operating systems not listed in the following table, use the locale setting for the operating system that corresponds to the one selected for ControlM/EM and Control-M/Server. Contact your UNIX administrator for additional assistance.

CJK Character Set Locale Settings for UNIX and Linux

The following table lists the CJK character set locale settings for UNIX and Linux.

Language

AIX

Solaris

Linux

Chinese (Simplified)

ZH_CN.UTF-8

zh.UTF-8

zh_CN.utf8

Chinese (Traditional)

ZH_TW.UTF-8

zh_TW.UTF-8

zh_TW.utf8

Japanese

JA_JP.UTF-8

ja_JP.UTF-8

ja_JP.utf8

Korean

KO_KR.UTF-8

ko.UTF-8

ko_KR.utf8

Configuring CJK Support for Jobs Submitted on Agentless Hosts

This procedure describes how to configure CJK support for jobs submitted on an Agentless Host.

Begin

  1. Configure the Agentless Host with Agents that are set to the required encoding as defined in Agent Language Encodings Available through ctmunixcfg and Agent Language Encodings Available through ctmwincfg.

  2. Select Agentless Hosts according to the encoding available on either Windows or UNIX platforms. Windows CJK encoding is available only on Agents installed on Windows. Similarly, UNIX CJK encoding is available only on Agents installed on UNIX.

Configuring Language Support on Agent

This procedure describes how to configure language support for CJK on the Agent.

Begin

  1. From the command-prompt window, run the ctmagcfg command-line utility.

  2. Select 7 Advanced Parameters.

  3. Select 7 Foreign Language Support and then select CJK.

  4. Set the encoding that the Agent uses to run jobs.

  5. Ensure that the required language locale or code page is present on the computer, as described in CJK Locale Settings for Operating Systems Jobs. On UNIX, you can use the locale -a command to list the information.

  6. Ensure that the environment of the owner responsible for running jobs is set to the correct locale.

  7. Use the appropriate command-line utility to set the language encoding for jobs that the Agent runs.

  8. From UNIX, run the ctmunixcfg utility, and set the CJK Encoding parameter to one of the language encodings, as listed in Agent Language Encodings Available through ctmunixcfg. The Agent assumes that all jobs run in the same user-defined locale.

  9. From Windows, run the ctmwincfg utility and set the CJK Encoding parameter to one of the available language encodings, as listed in Agent Language Encodings Available through ctmwincfg.

  10. Restart the Agent.

CJK Locale Settings for Operating Systems Jobs

The following table lists the CJK locale settings for operating system jobs.

Language

AIX

Solaris

Linux

Windows

Chinese (Simplified)

ZH_CN.UTF-8

Zh_CN.GBK

Zh_CN.GB18030

zh.UTF-8

zh.GBK

zh_CN.GB18030

zh_CN.utf8

zh_CN.gb18030

zh_CN.gbk

CP936

Chinese (Traditional)

ZH_TW.UTF-8

Zh_TW.big5

zh_TW.IBM-eucTW

zh_TW.UTF-8

zh_TW.BIG5

zh_TW (EUC)

zh_TW.utf8

zh_TW.big5

zh_TW.euctw

CP950

Japanese

JA_JP.UTF-8

JA_JP.IBM-eucJP

Ja_JP.IBM-943

ja_JP.UTF-8

ja_JP.eucJP

ja_JP.PCK (Shiftjis)

ja_JP.utf8

ja_JP.eucjp

ja_JP.PCK (Shiftjis)

CP932

Korean

KO_KR.UTF-8

KO_KR.IBM-eucKR

ko.UTF-8

ko (EUC)

ko_KR.utf8

ko_KR.euckr

CP949

Agent Language Encodings Available through ctmunixcfg

The following table list the language encodings available through the ctmunixcfg utility.

Job Language Option

Encoding

UTF-8

*.UTF-8

Japanese EUC

*.eucJP

Japanese SHIFT-JIS

Ja_JP.IBM-943

ja_JP.SJIS

ja_JP.PCK

Korean EUC

*.eucKR

Simplified Chinese GBK

*.GBK

Simplified Chinese GB

*.GB18030

Traditional Chinese EUC

*.eucTW

Traditional Chinese BIG5

*.big5

Agent Language Encodings Available through ctmwincfg

The following table lists the language encodings available through the ctmwincfg utility.

Job Language Option

Encoding

Japanese

CP932

Korean

CP949

Simplified Chinese

CP936

Traditional Chinese

CP950

UTF-16

UNICODE

CJK Database Configuration

Before creating a Control-M/Server or Control-M/EM database, ensure that the database server fulfills the prerequisites, as listed in CJK Prerequisites.

Review the additional CJK support issues, as described in CJK Support Issues for Database Installation when creating or installing a new database.

CJK Prerequisites

The following table lists the CJK prerequisites.

Type of Database

Prerequisites

PostgreSQL

Installed with UTF8 character sets

Oracle

Configured with AL32UTF8 or UTF8 character sets

MSSQL

None

CJK Support Issues for Database Installation

The following table lists the support issues for database installation.

If You Are

CJK Support Issue

Creating a Control-M/Server or Control-M/EM database on an Oracle database server

If CJK settings are detected, they are inherited automatically from the database server. Installation continues.

Creating a Control-M/Server or Control-M/EM database on an MSSQL database server

If CJK settings are detected, you are asked whether CJK support is required.

Installing a BMC-supplied PostgreSQL database

Choose the custom option for installation mode. During the custom installation, you are asked whether CJK support is required.

Configuring English Support on Japanese Microsoft Windows 7 and Higher

This procedure describes how to configure English support on Japanese Microsoft Windows 7 and higher. The settings vary according to the version of Windows installed.

The system locale for all of the following product components must be set to the same value:

  • Control-M/EM

  • Control-M/Server

  • Agent

  • Control-M Application Plug-Ins

Begin

  1. Set the system locale and language settings to English before installing any of the associated Control-M components.

    1. From the Control Panel select Regional Options > Language Settings.

    1. To receive all messages in English, select Western Europe and United States.

    1. At Control Panel > Regional Options > Your locale (location), select English (USA).

  1. After installation, reconfigure your computer to work with a non-English language.

Configuring English Support on Japanese UNIX

This procedure describes how to configure English support on Japanese UNIX systems that run the following components:

  • Control-M/EM

  • Control-M

  • Control-M Reports

  • Control-M/Server

  • Agent

  • BMC Batch Impact Manager

  • Control-M Application Plug Ins

Begin

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

    A list of locales available on your computer appears.

  2. Check that C, c, POSIX, or an English locale, as listed in ISO English-character-set locale settings for UNIX or Linux (for Japanese operating systems) is displayed. If none of these locales is displayed, ask your UNIX administrator to install it.

  3. Set the following values in the .cshrc file. If necessary, add lines for these environment variables.

    Add the lines in the same order as the environment variables, as listed in UNIX environment variables for English on Japanese systems in .cshrc.

  4. Run the source ~/.cshrc command to apply the new settings to the environment.

ISO English-Character-Set Locale Settings for UNIX or Linux (for Japanese Operating Systems)

The following table lists the ISO English-character-set locale settings for UNIX or Linux for a Japanese operating system.

Language

AIX, Solaris, Compaq (OSF)

Linux (Red Hat)

Linux (SuSE)

English (USA)

en_US.ISO8859-1

en_US.iso8859-1

en_US

English (British)

en_GB.ISO8859-1

en_US.iso8859-1

en_GB

UNIX Environment Variables for English on Japanese Systems in .cshrc

The following table list the UNIX environment variables for English on Japanese systems in .cshrc.

Environment Variable

Description / Value

LC_ALL

*.UTF-8

LC_CTYPE

LANG

LC_COLLATE

LC_MESSAGES

These environment variables should be C (or c, as defined on the computer).

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 these variables by adding the following lines to the .cshrc file:

setenv LC_CTYPE C

setenv LANG C

setenv LC_COLLATE C

setenv LC_MESSAGES C

CJK Support for Product Files

The following table summarizes the level of CJK support for various types of product files.

File Type

File Names and Paths

File Contents

Drafts

English Only

CJK (UTF-8)

Reports

English Only

CJK (UTF-8)

Templates (skeletons)

English Only

CJK (UTF-8)

OUTPUT (Job Log)

CJK Supported

Various CJK encodings

Job Scripts (for Edit JCL)

CJK Supported

Various CJK encodings

OS Job Executable

CJK Supported

Various CJK encodings

Doc Path (Formerly Doc Lib)

CJK Supported

Various CJK encodings

Doc File (Formerly Doc Mem)

CJK Supported

Various CJK encodings

%%LIBMEMSYM Variable

CJK Supported

CJK (UTF-8)

XML Files

English Only

CJK (UTF-8)

Command-Line Arguments*

N/A

UNIX: CJK (UTF-8)

Windows: CJK (UTF-8)

File Watcher Rule File

English Only

UNIX: CJK (UTF-8)

Windows: CJK (UTF-8)

input_file

English Only

UNIX: CJK (UTF-8)

Windows: CJK (UTF-8)

CJK Support for Job Definition Attributes

The following table lists parameters that support CJK characters.

Parameter

Subparameter

Application*

 

Command*

 

Condition Name*

 

Lock Resources*

Resource Name

Description

 

Set Variable*

Name

Set Variable*

Value

Do Condition Name*

 

Do Mail*

cc

Do Mail*

Message

Do Mail*

Subject

Do Mail*

To

Notify*

Destination

Notify*

MSG

handle Output*

Prm

Do OUTPUT*

From Class

Doc File* (formerly called Doc Mem)

 

Doc Path* (formerly called Doc Lib)

 

File Name*

 

From Class*

 

Sub Application*

 

Wait for Event*

Name

Job Name*

 

Mem Lib*

 

Mem Name*

 

On Code*

 

On Statement*

 

OUTPUT*

Parameter

Event*

Name

Override Path*

 

Path*

 

Resource Pool*

Name

Shout*

Message

Shout*

To (Destination)

Step Range*

Name

Order Method

 

User Daily Name*

 

Variable (Set Var)*

Name

Variable (Set Var)*

Value

* CJK characters for this parameter are not supported on z/OS.

The following table lists parameters that accept English characters only.

Parameter

Subparameter

Component Names

 

Control-M/Server Name

 

Host Names

 

Host Group

 

Host ID

 

Run As

 

Password

 

Periodic Calendar Values

 

Rule Based Calendar

Name

User Name

 

The following are exception alert fields that support CJK special characters:

  • Message

  • Note

  • Key1

  • Key2

  • Key3

  • Key4

  • Key5

CJK Support for Command-Line Utilities

The following table lists the command-line utilities that support CJK characters. These utilities accept parameters in UTF-8 on UNIX and also UTF-8 on Windows.

Product/Component

Command-Line Utilities

Control-M

Agent

EM Servers

These functions include the following operations of the util utility:

  • Export data from the Control-M/EM database.

  • Import data to the Control-M/EM database.

  • Delete the Control-M/EM database.

  • Clear the Control-M/EM database.

  • Build the Control-M/EM database.

  • Export a specified definition folder.

  • Export a specified definition SMART folder.

  • Import a specified definition folder.

  • Import a specified definition SMART folder.

EM Clients

(Deprecated) XML Utilities: