2.4.2 Language type and character encoding of the system

■ Cautionary notes when the manager host and agent host have different character encodings

If the language type is Japanese or English, and the manager host and agent host have different character encodings, the character encodings are converted to the one used by the communication destination when the manager host communicates with the agent host. The following lists the definitions, input files, and execution results whose character encodings are converted. That is, if data is transmitted from the manager to the agent, the data is converted to the character encoding used at the agent. If data is transmitted from the agent to the manager, the data is converted to the character encoding used at the manager. This conversion of the character encoding occurs for the following definitions, input files, and execution results.

For PC jobs, Unix jobs, flexible jobs, and QUEUE jobs

Definitions

• Name of executable file

• Command statement

• Parameter

• Script file name

• Environment variable

• Environment variable filename

• Name of the work directory used during agent process execution

• Standard input filename

• Standard output filename

• Standard error output filename

• Transfer filename

• Job name (for QUEUE job)

• Values of macro variables defined in jobs

Input files

• Contents of transfer files 1 to 4

Execution results

• Contents of the standard output file

• Contents of the standard error output file (execution result details)

HTTP connection jobs

Definitions

• Conn. configuration file name

• Trans. info. file name

• Trans. info. file name (URL parameter)

• Trans. info. file name (message body)

• Status file name

• Received header file name

• Received body file name

• Standard output file name

• Standard error output file name

Execution results

• Contents of the standard output file

• Contents of the standard error output file (execution result details)

Action jobs and custom jobs

Definitions

• Information defined for jobs

• Values of macro variables defined in jobs

Execution results

• Contents of the standard error output file (execution result details)

Event jobs and custom event jobs

Definitions

• Information defined for jobs

Execution results

• Contents of the standard error output file (execution result details)

• Inherited information (values of macro variables defined in jobs)

In the case of Chinese, the character encoding is not converted at the time when the manager host communicates with the agent host. All the manager hosts and agent hosts must have the Chinese character encoding.

■ Cautionary notes when mixed Japanese character encodings are used

The following restrictions apply to combining different types of Japanese character encodings.

• Remote execution of commands

  When a command is remotely executed, the same character encoding must be set for the host where the command is entered and for the host where the command is executed.

  If the character encoding on the host where the command is executed is UTF-8, you can remotely execute the command by setting EUC as the character encoding of the host where the command is entered.

  For details about remote execution of commands, see 1.1.7 Remote execution of a command in the manual JP1/Automatic Job Management System 3 Command Reference.

  The character encoding of the host where the command is entered is the character encoding specified in the OS by using the LANG environment variable, for example.

  The character encoding of the host where the command is executed refers to one of the following:

  • Character encoding specified in the AJSCHARCODE environment setting parameter

  • Setting of the OS used when the JP1/AJS3 service is started

• Remote jobnet

  When a remote jobnet is executed, the character encodings of the host where the remote job is defined and the host where the remote job is executed must match.

  The character encoding of the host where the remote job is defined and the character encoding of the host where the remote job is executed refer to one of the following:

  • Character encoding specified in the AJSCHARCODE environment setting parameter on each host

  • Setting of the OS used when the JP1/AJS3 service is started

• Unix job, HTTP connection job, flexible job, action job, event job, and custom event job

  For JP1/AJS3 - View or a command, if the definition items for a job executed on the agent host in a UTF-8 environment contain Japanese characters, assume that one Japanese character requires 4 bytes. Based on this assumption, define the job so that the maximum value for each item is not exceeded. If sjis is specified for the DEFLENTYPE environment setting parameter, the maximum number of characters that can be specified for the following items is the same as in a Shift-JIS environment:

  • Unit name in the detailed unit definition

  • Comment in the detailed unit definition

  • Exclusive jobnet in the schedule settings

  A Unix job, action job, event job, or custom event job can be executed in a system configuration where the manager host operates in a Shift-JIS or EUC environment and the agent host operates in a UTF-8 environment. In this case, the number of bytes converted to the character encoding of the agent host is checked as the size of the information defined for the job. As a result, a job execution error might occur even if the definition in JP1/AJS3 - View or a command does not exceed the maximum number of bytes that can be entered for job items.

• Event job, custom event job

  If the sum of the size of the event job and the custom event job passing information and the size of the macro variable name exceeds 4,096 bytes on the agent host, the excess data is truncated.

  To pass information containing Japanese characters in a UTF-8 environment, assume that one Japanese character requires 4 bytes.

  To use JP1/AJS3 that does not support UTF-8 to receive JP1 events issued from a UTF-8 environment, configure JP1/Base to run in character encoding compatibility mode. If you do not use character encoding compatibility mode, a JP1 event might not be detected correctly or another kind of error might occur.

  For details on the character encoding compatibility mode, see JP1/Base User's Guide.

• Commands used for executing submit jobs

  If a command is executed from a host in a Shift-JIS or EUC environment for a manager host in a UTF-8 environment, an error might occur on the manager host even when the values of the options do not exceed the maximum number of bytes on the command execution host. The reason for the error is that the number of bytes in the option values containing Japanese characters increases due to character encoding conversion when the command execution host transfers data to the manager host.

  Therefore, when you specify option values containing Japanese characters for commands executed on the manager host in the UTF-8 environment, assume that one Japanese character require 4 bytes. Based on this assumption, specify the options so that the value of each option is within the maximum number of specifiable bytes.

  Commands:

  jpqjobsub, jpqjobcan, jpqjobalt, jpqjobmove, jpqjobget, jpqjobshow, jpqendjobshow, jpqjobdel, jpqqueopen, jpqqueclose, jpqqueshow, jpqqueadd, jpqquedel, jpqquealt, jpqagtlink, jpqagtunlink, jpqagtshow, jpqagtadd, jpqagtdel, jpqagtalt, jpqresshow, jpqresadd, jpqresdel

■ Notes on using UTF-8 encoding

• If a command entered from a host that uses UTF-8 encoding is remotely executed on a host for which UTF-8 is specified as the character encoding in AJSCHARCODE, you must specify no for the AJSCONVERTUTF8 environment variable. If the AJSCONVERTUTF8 environment variable is not specified or if the command is remotely executed with yes specified, characters in the display results might be garbled or processing on the unit might not be performed correctly.

  For details about the AJSCONVERTUTF8 environment variable, see 1.4 Environment variables in the manual JP1/Automatic Job Management System 3 Command Reference.

• For details about the characters that you can use in a UTF-8 environment, see (a) Available characters.

• If a queueless job entered from the manager host that uses UTF-8 encoding is executed on an agent host that does not support UTF-8 encoding, you must specify the QLMANCHARCODE environment setting parameter on the manager host. For details about the QLMANCHARCODE environment setting parameter, see 20.10 Setting up the queueless job execution environment in the JP1/Automatic Job Management System 3 Configuration Guide.

• If UTF-8 encoding is used and sjis is specified for the DEFLENTYPE environment setting parameter, the number of characters that can be specified for the following items is the same as in a Shift-JIS environment:

  • Unit name in the detailed unit definition

  • Comment in the detailed unit definition

  • Exclusive jobnet in the schedule settings

  Note, however, that the maximum number of nested units (maximum number of levels) is 10 (the default is 30).

• For a version of JP1/AJS3 - View earlier than 09-50, if sjis is specified for the DEFLENTYPE environment setting parameter, a scheduler service and its lower units are not displayed. If sjis is specified for the DEFLENTYPE environment setting parameter for all scheduler services, the KAVV187-E message is output and none of the scheduler services or their lower units are displayed. If you use the ajs command or manager jobnet to access the scheduler service for which sjis is specified for the DEFLENTYPE environment setting parameter, the KAVV455-E message is output. The scheduler service and its lower units are not displayed.

■ For JP1/AJS3 - Manager and JP1/AJS3 - Agent

The detailed procedure for definition is as follows:

1. Change the language settings in the OS.

2. Install JP1/AJS3 - Manager or JP1/AJS3 - Agent.

3. Execute the following command:

   jajs_config -k "[JP1_DEFAULT\JP1AJS2COMMON]" "AJSI18N"="yes"

■ For JP1/AJS3 - View

The detailed procedure for definition is as follows:

1. Change the language settings in the OS.

2. Install JP1/AJS3 - View.

3. In the environment settings file (ajs.conf), add the SetCharEncodingNameI18N definition line, and then specify the appropriate value as shown in the following table.

   File storage folder

   JP1/AJS3-View-installation-folder\conf\ajs.conf

   Table 2‒36: Values that can be specified in the environment settings file (ajs.conf)

   Language	Connection destination JP1/AJS3 - Manager OS	Value that can be specified for SetCharEncodingNameI18N
   Korean	Windows	EUC_KR
   	Linux	EUC_KR
   German French Spanish	Windows	ISO8859_1
   	Linux	ISO8859_1
   Russian	Windows	CP1251
   	Linux	KOI8_R
   Thai	Windows	MS874
   	Linux	UTF8

Example: When using German language

Change from:

[STARTUP]
lang=1

Change to:

[STARTUP]
lang=1
SetCharEncodingNameI18N=ISO8859_1

■ For JP1/AJS3 - Web Console

The detailed procedure for definition is as follows:

1. Change the language settings in the OS.

2. Install JP1/AJS3 - Web Console.

3. Specify the value in the following table for the I18N definition line of the environment settings file (ajscharcodemapping.properties).

   File storage folder

   Web_Data_Path^#\conf\ajscharcodemapping.properties

   File storage folder for operation in a cluster system

   shared-folder\jp1ajs3web\conf\ajscharcodemapping.properties

   #

   One of the following paths is indicated in Web_Data_Path:

   If the installation folder is the default installation folder or is in a folder protected by the system:

   %ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\jp1ajs3web

   The default value for %ALLUSERSPROFILE% is system-drive\ProgramData.

   A folder protected by the system is the path to a folder in any of the following:

   - system-drive\Windows

   - system-drive\Program Files

   If the installation folder is other than the above:

   JP1/AJS3 - Web Console-installation-folder

   Table 2‒37: Values that can be specified in the environment settings file (ajscharcodemapping.properties)

   Language	Connection destination JP1/AJS3 - Manager OS	I18N value
   Korean	Windows	EUC_KR
   	Linux	EUC_KR
   German French Spanish	Windows	ISO8859_1
   	Linux	ISO8859_1
   Russian	Windows	CP1251
   	Linux	KOI8_R
   Thai	Windows	MS874
   	Linux	UTF8

Example: When using German language

Change from:

C=ASCII
SJIS=MS932
EUC=EUC_JP
UTF-8=UTF8
I18N=GB18030

Change to:

C=ASCII
SJIS=MS932
EUC=EUC_JP
UTF-8=UTF8
I18N=ISO8859_1

■  For JP1/AJS3 - Manager and JP1/AJS3 - Agent

The detailed procedure for definition is as follows:

1. Specify C for LANG environment variable.

   export LANG=C

2. Install JP1/AJS3 - Manager or JP1/AJS3 - Agent.

   JP1/AJS3 - Manager or JP1/AJS3 - Agent is installed with English language settings.

3. Use the jajs_config command to set yes for the AJSI18N environment setting parameter.

   jajs_config -k "[JP1_DEFAULT\JP1AJS2COMMON]" "AJSI18N"="yes"

4. Change the value of the LANG environment variable that is defined in the JP1/AJS3 environment definition file (jp1ajs_env.conf).

   For a physical host:

   /etc/opt/jp1ajs2/conf/jp1ajs_env.conf

   For a logical host:

   shared-directory/jp1ajs2/conf/jp1ajs_env.conf

   Table 2‒38: Values that can be specified in the LANG environment variable

   Language	Character encoding	Value of LANG environment variable
   Korean	EUC-KR	ko_KR.EUC-KR
   German	ISO-8859-1	de_DE.ISO-8859-1
   French	ISO-8859-1	fr_FR.ISO-8859-1
   Spanish	ISO-8859-1	es_ES.ISO-8859-1
   Russian	KOI8-R	ru_RU.KOI8-R
   Thai	UTF-8	en_US.UTF-8 en_US.utf8

Example: When using German language

Change from:

LANG=C

Change to:

LANG=de_DE.ISO-8859-1

■ For JP1/AJS3 - Web Console

The detailed procedure for definition is as follows:

1. Specify C for LANG environment variable

   export LANG=C

2. Install JP1/AJS3 - Web Console

   JP1/AJS3 - Web Console is installed with English language settings.

3. Specify the value in the following table for the I18N definition line of the environment settings file (ajscharcodemapping.properties).

   Specified place

   /etc/opt/jp1ajs3web/conf/ajscharcodemapping.properties

   Cluster configuration

   shared-directory/jp1ajs3web/conf/ajscharcodemapping.properties

   Table 2‒39: Values that can be specified in the environment settings file (ajscharcodemapping.properties)

   Language	Connection destination JP1/AJS3 - Manager OS	I18N value
   Linux	Windows	EUC_KR
   	Linux	EUC_KR
   German French Spanish	Windows	ISO8859_1
   	Linux	ISO8859_1
   Russian	Windows	CP1251
   	Linux	KOI8_R
   Thai	Windows	MS874
   	Linux	UTF8

Example: When using German language

Change from:

C=ASCII
SJIS=MS932
EUC=EUC_JP
UTF-8=UTF8
I18N=GB18030

Change to:

C=ASCII
SJIS=MS932
EUC=EUC_JP
UTF-8=UTF8
I18N=ISO8859_1