Job Management Partner 1/Automatic Job Management System 3 System Design (Configuration) Guide

2.4.3 Language type of the system

You can display messages either in English or Japanese. Consider which language should be used for the language to display according to the usage.

The following table shows which version combinations are supported in an environment in which both domestic and overseas versions of JP1/AJS products are being used.

Table 2-16 Supported combinations of domestic and overseas JP1/AJS products

JP1/AJS - View JP1/AJS - Agent

Domestic Overseas Domestic Overseas

Japanese English English Japanese English English

JP1/AJS - Manager Domestic Japanese Yes -- -- Yes (Yes)2^# Yes^#

English (Yes)1^# -- (Yes)1 -- (Yes)1,(Yes)2 (Yes)1

Overseas English Yes^# -- Yes -- (Yes)2 Yes

Legend:

Yes: Supported

(Yes)1: Supported only for the UNIX version of JP1/AJS - Manager.

(Yes)2: Supported only for the UNIX version of JP1/AJS - Agent.

--: Not supported

#

Set C (English) in the LANG environment variable for JP1/AJS service startup. Set alphanumeric characters (ASCII) for all text and information used in JP1/AJS, including unit names, file names, characters used in files, messages in jobs being executed, monitoring conditions for event jobs, and information inherited by event jobs.

Organization of this subsection

(1) Values that can be specified in the LANG environment variable

(2) Changing the character code set

(3) Notes on an environment where more than one character code set is used

	JP1/AJS - View	JP1/AJS - Agent
Domestic	Overseas	Domestic	Overseas
Japanese	English	English	Japanese	English	English
JP1/AJS - Manager	Domestic	Japanese	Yes	--	--	Yes	(Yes)2^#	Yes^#
English	(Yes)1^#	--	(Yes)1	--	(Yes)1,(Yes)2	(Yes)1
Overseas	English	Yes^#	--	Yes	--	(Yes)2	Yes

(1) Values that can be specified in the LANG environment variable

In UNIX, to set the systems language environment, use the LANG environment variable. The table below lists the values that can be specified in the LANG environment variable. Use this table to select a value. If you do not use a value listed in this table, C (English) will be set. Operation is not guaranteed when Unicode (UTF-8) is set in the LANG environment variable for a product that does not support Unicode.

In Windows, the system language environment cannot be changed.

Table 2-17 Values that can be specified in the LANG environment variable

OS Language and code LANG environment variable

HP-UX Japanese Shift-JIS

ja_JP.SJIS^#

japanese

EUC

ja_JP.eucJP

japanese.euc

English

C

Solaris Japanese Shift-JIS

ja_JP.PCK

EUC

ja^#

japanese

English

C

AIX Japanese Shift-JIS

Ja_JP^#

Ja_JP.IBM-932

EUC

ja_JP

ja_JP.IBM-eucJP

English

C

#

This value is specified in jp1ajs_env.conf when you install or set up JP1/AJS3 for the first time. For details about the locations where you need to specify a character encoding, see (2) Changing the character code set.

OS	Language and code	LANG environment variable
HP-UX	Japanese	Shift-JIS	ja_JP.SJIS^# japanese
EUC	ja_JP.eucJP japanese.euc
English	C
Solaris	Japanese	Shift-JIS	ja_JP.PCK
EUC	ja^# japanese
English	C
AIX	Japanese	Shift-JIS	Ja_JP^# Ja_JP.IBM-932
EUC	ja_JP ja_JP.IBM-eucJP
English	C

(2) Changing the character code set

In UNIX, you must set the same character encoding for the definition files, environment variables, and environment setting parameters listed in the following table.

Table 2-18 Settings you must specify when changing the character code set

Settings (definition files, environment variables, and environment setting parameters) What the change affects

JP1/AJS3 environment definition file

For a physical host:
/etc/opt/jp1ajs2/conf/jp1ajs_env.conf

For a logical host:
The LANG environment variable in: shared-directory/jp1ajs2/conf/jp1ajs_env.conf

Value of the LANG environment variable to be applied when the JP1/AJS3 service starts

Character encoding of the information to be output to integrated trace logs and internal logs by schedule control, event/action control, and job execution control

When the user profile does not contain the LANG environment variable, the default for LANG during job execution.

JP1/Base parameter definition file

For a physical host:
/etc/opt/jp1base/conf/jp1bs_param.conf

For a logical host:
The LANG environment variable in: shared-directory/jp1base/conf/jp1bs_param.conf

Character encoding of the data to be transmitted between the JP1/AJS3 manager and JP1/AJS3 agents when standard jobs and event jobs are executed

AJSCHARCODE parameter in the scheduler service environment definition The character code set for the information that will be stored in the scheduler database.

SYSLOGCODE parameter in the scheduler service environment definition

The character code set for messages output by the scheduler services to SYSLOG.

The value of the LANG environment variable used at the start of the service when a value other than C (English) is specified.

CHARCODE parameter in the JP1/AJS3 Console Manager environment definition The character code for information that will be stored in the user definition data.

SYSLOGCODE parameter in the JP1/AJS3 Console Manager environment definition

The character code set of messages output by the JP1/AJS3 Console Manager service to SYSLOG.

The value of the LANG environment variable used at the start of the service when a value other than C (English) is specified.

The LANG environment variable when the JP1/AJS3 Console Manager service is active The messages output from the JP1/AJS3 Console Manager service

SYSLOGCODE parameter in the JP1/AJS3 Console Agent environment definition

The character code set for messages output by the JP1/AJS3 Console Agent service to SYSLOG.

The value of the LANG environment variable used at the start of the service when a value other than C (English) is specified.

The LANG environment variable when the JP1/AJS3 Console Agent service is active The messages output from the JP1/AJS3 Console Agent service

The LANG environment variable when the queueless agent service is active The messages output from the queueless agent service

The AJSQL_CHARCODE^#1 environment setting parameter used by the queueless agent service

Data accepted from the scheduler service

Transfer file data

Result file data

Reply data to the scheduler service

The LANG environment variable^#3 when a command^#2 for unit operation is executed

The values stored in the scheduler database by the command that operates on the unit

The log data and messages that are output by the command that operates on the unit

#1

If the manager and agent hosts use different character code sets, the AJSQL_CHARCODE environment setting parameter must be set for character code conversion.

For details about character code conversion for queueless jobs, see 7.2.2 Environment settings for executing queueless jobs.

#2

For details about the commands for manipulating units, see 1.5 Commands in the manual Job Management Partner 1/Automatic Job Management System 3 Command Reference 1.

#3

Specify the character encoding that is specified in the AJSCHARCODE environment setting parameter of the scheduler service where the unit to be manipulated by the command is defined.

The following figure shows what is affected by changing the character code set from the default one.

Figure 2-34 What is affected by changing the character code set

You must redefine any unit names containing Kana characters or two-byte characters that are already being used in JP1/AJS3.

Settings (definition files, environment variables, and environment setting parameters)	What the change affects
JP1/AJS3 environment definition file For a physical host: /etc/opt/jp1ajs2/conf/jp1ajs_env.conf For a logical host: The LANG environment variable in: shared-directory/jp1ajs2/conf/jp1ajs_env.conf	Value of the LANG environment variable to be applied when the JP1/AJS3 service starts Character encoding of the information to be output to integrated trace logs and internal logs by schedule control, event/action control, and job execution control When the user profile does not contain the LANG environment variable, the default for LANG during job execution.
JP1/Base parameter definition file For a physical host: /etc/opt/jp1base/conf/jp1bs_param.conf For a logical host: The LANG environment variable in: shared-directory/jp1base/conf/jp1bs_param.conf	Character encoding of the data to be transmitted between the JP1/AJS3 manager and JP1/AJS3 agents when standard jobs and event jobs are executed
AJSCHARCODE parameter in the scheduler service environment definition	The character code set for the information that will be stored in the scheduler database.
SYSLOGCODE parameter in the scheduler service environment definition	The character code set for messages output by the scheduler services to SYSLOG. The value of the LANG environment variable used at the start of the service when a value other than C (English) is specified.
CHARCODE parameter in the JP1/AJS3 Console Manager environment definition	The character code for information that will be stored in the user definition data.
SYSLOGCODE parameter in the JP1/AJS3 Console Manager environment definition	The character code set of messages output by the JP1/AJS3 Console Manager service to SYSLOG. The value of the LANG environment variable used at the start of the service when a value other than C (English) is specified.
The LANG environment variable when the JP1/AJS3 Console Manager service is active	The messages output from the JP1/AJS3 Console Manager service
SYSLOGCODE parameter in the JP1/AJS3 Console Agent environment definition	The character code set for messages output by the JP1/AJS3 Console Agent service to SYSLOG. The value of the LANG environment variable used at the start of the service when a value other than C (English) is specified.
The LANG environment variable when the JP1/AJS3 Console Agent service is active	The messages output from the JP1/AJS3 Console Agent service
The LANG environment variable when the queueless agent service is active	The messages output from the queueless agent service
The AJSQL_CHARCODE^#1 environment setting parameter used by the queueless agent service	Data accepted from the scheduler service Transfer file data Result file data Reply data to the scheduler service
The LANG environment variable^#3 when a command^#2 for unit operation is executed	The values stored in the scheduler database by the command that operates on the unit The log data and messages that are output by the command that operates on the unit

(3) Notes on an environment where more than one character code set is used

When applications are executed by two or more linked hosts working together, text that includes Japanese character codes cannot be displayed in an English environment. Set the same language type for all hosts. For details about the language types that can be combined in heterogeneous JP1/AJS products, see Table 2-16.

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

Remote execution of commands
When a command is remotely executed, the same character code set must be set for the host where the command is entered and for the host where the command is executed. For details about remote execution of commands, see 1.1.6 Remote execution of a command in the manual Job Management Partner 1/Automatic Job Management System 3 Command Reference 1.
The character code set of the host where the command is entered is the character code set specified in the OS by using the LANG environment variable, for example.
The character code set 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 code sets of the host where the remote job is defined and the host where the remote job is executed must match.
The character code set of the host where the remote job is defined and the character code set 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

Character encoding of the JP1/AJS3 Console Manager data directory
When the character encoding of the JP1/AJS3 Console Manager data directory is English, you can only specify the AJS3 unit names in alphanumeric characters (ASCII). If you want to use both English and Japanese to monitor applications, specify a Japanese character encoding for the JP1/AJS3 Console Manager data directory.
When you use the function for automatically creating the monitored objects for a unit to be monitored whose full unit name contains Japanese, and C (English) is specified as the character encoding in the environment settings of JP1/AJS3 Console Manager, an error message (KAVC4635-E The automatically created monitored object information is not saved.) appears. Also note that the function might not work for units whose full unit names do not contain Japanese if multiple units are to be automatically created.
If you use the function, select only units whose full unit names do not include Japanese.

[Contents][Back][Next]

[Trademarks]