2.3.5 Settings required immediately after installation

Specify the language encoding in which JP1/IM - Manager runs to set the environment variables of JP1/IM. You need to specify the language encoding in both the environment variable file and the common definitions. The language encoding in the environment variable file and common definitions must match on all local hosts. Additionally, use the character encoding of events in the JP1/SES format to unify the language environment of a system that monitors events in the JP1/SES format. This subsection describes how to set the language encoding in the environment variable file and common definitions.

Organization of this subsection

(1) Setting the language encoding in the environment variable file
(2) Checking the language environment settings of JP1/Base
(3) Setting the language encoding in the common definitions

(1) Setting the language encoding in the environment variable file

Use a text editor such as vi to open the /etc/opt/jp1cons/conf/jp1co_env.conf file. After LANG= on the first line, set a value for the LANG environment variable based on the following table.

Table 2‒1: Values that can be specified for LANG in the jp1co_env.conf file
OS	Language type	Code	LANG value
Solaris	Japanese	Shift JIS code	`ja_JP.PCK`
		EUC code	Solaris 10 or earlier `ja` or `japanese` Solaris 11 or later `ja_JP.eucJP`^#1
		UTF-8 code^#2	`ja_JP.UTF-8`
	English		`C`
	Chinese		`zh_CN.GB18030`
AIX	Japanese	Shift JIS code	`Ja_JP.IBM-932 or Ja_JP`
	Japanese	EUC code	`ja_JP.IBM-eucJP` or `ja_JP`
	English		`C`
	Chinese		`Zh_CN.GB18030`
Linux	Japanese	UTF-8 code^#3	`ja_JP.UTF-8` or `ja_JP.utf8`
	English		`C`
	Chinese		`zh_CN.gb18030`

#1

When you newly install JP1/IM - Manager in a Solaris 11 or later environment, the language type to be set in the jp1co_env.conf file is ja. If you want to operate the system in Japanese EUC encoding, change ja to ja_JP.eucJP.

#2

UTF-8 encoding can be specified in Solaris 11 or later.

#3

In UTF-8 encoding, two character codes are used to represent each of the following symbols:

Yen sign (\): 0x5C or 0xC2A5

Tilde (~): 0x7E or 0xE280BE

In JP1/IM - Manager, \ is represented by 0x5C and ~ is represented by 0x7E.

These definitions take effect the next time JP1/IM - Manager starts.

Important note: When you select English as the language type, do not use multi-byte characters when you configure JP1/IM - Manager. If you do, JP1/IM - Manager handles the multi-byte characters as ASCII characters. As a result, JP1/IM - Manager might not operate normally.

To Page Top

(2) Checking the language environment settings of JP1/Base

Check the setting value in the /etc/opt/jp1base /conf/jp1bs_env.conf file.

Confirm that the value set after LANG = in the jp1bs_env.conf file matches the value set in 2.3.5(1) Setting the language encoding in the environment variable file.

For details about the jp1bs_env.conf file, see the Job Management Partner 1/Base User's Guide.
Check the setting value in the /etc/opt/jp1base/jbs_start file.

Confirm that the value set after LANG = in the jbs_start file matches the value set in 2.3.5(1) Setting the language encoding in the environment variable file.

For details about the jbs_start file, see the Job Management Partner 1/Base User's Guide.

For details about the language environment settings of JP1/Base, see the part that describes the language type settings in the Job Management Partner 1/Base User's Guide.

To Page Top

(3) Setting the language encoding in the common definitions

Edit the jp1bs_param.conf file.

Use a text editor to open the /etc/opt/jp1base/conf/jp1bs_param.conf file. After LANG=, set a value for the LANG environment variable based on the table below.

Table 2‒2: Values that can be specified for LANG in the jp1bs_param.conf file
Language type	Code	LANG value
Japanese	Shift JIS code	`SJIS`
	EUC code	`EUCJIS`
	UTF-8 code	`UTF-8`
English		`C`
Chinese		`GB18030`

Stop JP1/IM - Manager.
Stop JP1/Base.
Execute the following command:

/opt/jp1base/bin/jbssetcnf /etc/opt/jp1base/conf/jp1bs_param.conf
Start JP1/Base.
Start JP1/IM - Manager.

If you need to change the environment variables of JP1/IM - Manager while Central Scope is running, perform the following procedure:

Use the jcsdbexport command to output the information stored in the monitoring object database to a local file.
Stop JP1/IM - Manager.
Change the language encoding used by JP1/IM - Manager when it runs and start JP1/IM - Manager.
Use the jcsdbimport command to apply the contents of the monitoring object database (output to the local file) to the monitoring object database of Central Scope.

If you do not perform the above procedure, the Monitoring Tree window and Visual Monitoring window will not be displayed correctly.

To Page Top