13.4.1 Setting the language environment

(1) Changing the character encoding type

The following describes the procedure for changing the character encoding.

If you change the language and character encoding types during operation, you might have to re-install software when JP1/AJS3 - Manager, JP1/AJS3 - Agent, JP1/AJS3 - View, and the OS have been installed in specific combinations. For the combinations of JP1/AJS3 software and OSs for which re-installation is required, see 2.4.2(10) Changing the language setting during operation in the JP1/Automatic Job Management System 3 System Design (Configuration) Guide.

The procedure for changing the character encoding type is described below. For the settings, see (2) Settings for character encoding types.

1. Stop JP1 services, the connected JP1/AJS3 - View, and any commands that are being executed.

2. Change the character encoding type used in JP1/Base.

   For details about how to change the character encoding type used in JP1/Base, see the JP1/Base User's Guide.

3. To change the output character encoding type of events issued by a JP1/AJS3 service or the job execution environment, open the following file by using an editor such as vi.

   • For physical host

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

   • For logical host

     shared-directory/jp1ajs2/conf/jp1ajs_env.conf

4. Change the existing LANG environment variable value to the desired value on the LANG= line in the file you opened in step 3. After making the change, save the file.

5. To change the character encoding type to UTF-8, add AJSCONVERTUTF8=no to the last line in the file opened in step 3 and save the file.

6. To change the character encoding type of the job execution environment and unit definition environment, change the environment setting parameter.

   Execute the following command:

   jajs_config -k "[{JP1_DEFAULT|logical-host-name}\JP1AJSMANAGER\scheduler-service-name]" "AJSCHARCODE"="character-code"

   The specification of the {JP1_DEFAULT|logical-host} part depends on whether the host is a physical host or a logical host. For a physical host, specify JP1_DEFAULT. For a logical host, specify the logical host name.

   For details about the AJSCHARCODE environment setting parameter, see 20.4 Setting up the scheduler service environment.

7. If you change the character encoding type to UTF-8, set the environment setting parameter so that a queueless job is correctly executed by an agent that does not support UTF-8.

   Execute the following command:

   jajs_config -k "[JP1_DEFAULT\JP1AJSMANAGER]" "QLMANCHARCODE"="UTF-8"

   For details about the QLMANCHARCODE environment setting parameter, see 20.10 Setting up the queueless job execution environment.

8. If you set UTF-8 for the QLMANCHARCODE environment setting parameter, set the following environment setting parameter on all hosts that will be used as an agent for the queueless job, and restart the JP1/AJS3 Queueless Agent service.

   Execute the following command:

   jajs_config -k "[JP1_DEFAULT\JP1QLAGENT]" "AJSQL_CHARCODE"="UTF-8"

   For details about the AJSQL_CHARCODE environment setting parameter, see 20.10 Setting up the queueless job execution environment.

9. To execute a definition pre-check, change the environment setting parameter.

   Execute the following command:

   jajs_config -k "[JP1_DEFAULT\JP1AJS2\CHECK]" "AJSCHK_CHARCODE"="character-code"

   For details about the AJSCHK_CHARCODE environment setting parameter, see 20.7 Setting for the JP1/AJS3 definition pre-check function.

10. To change the character encoding type of the messages that scheduler services output to syslog, change the environment setting parameter.

    Execute the following command:

    jajs_config -k "[{JP1_DEFAULT|logical-host-name}\JP1AJSMANAGER\scheduler-service-name]" "SYSLOGCODE"="LANG-environment-variable-value"

    The specification of the {JP1_DEFAULT|logical-host} part depends on whether the host is a physical host or a logical host. For a physical host, specify JP1_DEFAULT. For a logical host, specify the logical host name.

    Note that if a value other than C is specified, the character encoding depends on the LANG environment variable of the environment in which the scheduler service starts. If necessary, change the LANG environment variable value of the environment in which the scheduler service is to be started.

    LANG="ja_JP.SJIS"

    export LANG

    Cautionary notes:

    - It might not be possible for the character encoding specified for the LANG environment variable to be output to syslog. In such cases, make sure you specify C.

    - When you use Chinese, you must specify C.

11. Change the setting of the environment parameter that specifies whether to use Chinese.

    Execute the following command:

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

    Specify yes for setting to use Chinese or no not to use Chinese.

To Page Top

(2) Settings for character encoding types

The following table lists the values to be set for individual language type settings.

Table 13‒12: Values to be set for individual language type settings

No.	OS	Language and character encoding types to be used			Value to be set
		Language	code	LANG environment variable	jp1ajs_env.conf		AJSCHARCODE	SYSLOGCODE	AJSI18N
					LANG	AJSCONVERTUTF8
1	HP-UX	Japanese	Shift-JIS	ja_JP.SJIS	ja_JP.SJIS	Undefined	SJIS	C or ja_JP.SJIS	No setting or no
2				japanese	japanese	Undefined	SJIS	C or japanese	No setting or no
3			EUC	ja_JP.eucJP	ja_JP.eucJP	Undefined	EUC	C or ja_JP.eucJP	No setting or no
4				japanese.euc	japanese.euc	Undefined	EUC	C or japanese.euc	No setting or no
5			UTF-8	ja_JP.utf8	ja_JP.utf8	no	UTF-8	C or ja_JP.utf8	No setting or no
6		English	ASCII	C	C	Undefined	C	C	No setting or no
7		Chinese	GB18030	zh_CN.gb18030	zh_CN.gb18030	Undefined	C	C	yes
8	Solaris	Japanese	Shift-JIS	ja_JP.PCK	ja_JP.PCK	Undefined	SJIS	C or ja_JP.PCK	No setting or no
9			EUC	ja	ja	Undefined	EUC	C or ja	No setting or no
10				ja_JP.eucJP	ja_JP.eucJP	Undefined	EUC	C or ja_JP.eucJP	No setting or no
11			UTF-8	ja_JP.UTF-8	ja_JP.UTF-8	no	UTF-8	C or ja_JP.UTF-8	No setting or no
12		English	ASCII	C	C	Undefined	C	C	No setting or no
13		Chinese	GB18030	zh_CN.GB18030	zh_CN.GB18030	Undefined	C	C	yes
14	AIX	Japanese	Shift-JIS	Ja_JP	Ja_JP	Undefined	SJIS	C or Ja_JP	No setting or no
15				Ja_JP.IBM-932	Ja_JP.IBM-932	Undefined	SJIS	C or Ja_JP.IBM-932	No setting or no
16			EUC	ja_JP	ja_JP	Undefined	EUC	C or ja_JP	No setting or no
17				ja_JP.IBM-eucJP	ja_JP.IBM-eucJP	Undefined	EUC	C or ja_JP.IBM-eucJP	No setting or no
18			UTF-8	JA_JP	JA_JP	no	UTF-8	C or JA_JP	No setting or no
19				JA_JP.UTF-8	JA_JP.UTF-8	no	UTF-8	C or JA_JP.UTF-8	No setting or no
20		English	ASCII	C	C	Undefined	C	C	No setting or no
21		Chinese	GB18030	Zh_CN.GB18030	Zh_CN.GB18030	Undefined	C	C	yes
22	Linux	Japanese	Shift-JIS	ja_JP.SJIS#	ja_JP.SJIS	Undefined	SJIS	C or ja_JP.SJIS	No setting or no
23				ja_JP.sjis#	ja_JP.sjis	Undefined	SJIS	C or ja_JP.sjis	No setting or no
24			UTF-8	ja_JP.UTF-8	ja_JP.UTF-8	no	UTF-8	C or ja_JP.UTF-8	No setting or no
25				ja_JP.utf8	ja_JP.utf8	no	UTF-8	C or ja_JP.utf8	No setting or no
26		English	ASCII	C	C	Undefined	C	C	No setting or no
27		Chinese	GB18030	zh_CN.gb18030	zh_CN.gb18030	Undefined	C	C	yes

To Page Top