Option definition file (usrconf.cfg)

Organization of this page

Function
Name of file
Location
Timing of applying definition information
Notes
How to modify
Setting items
Definition example

Function

The option definition file is the file for setting the JavaVM startup options. It defines the language settings used by PFM - Web Console and the maximum amount of memory to be used.

To Page Top

Name of file

usrconf.cfg (Option definition file)

To Page Top

Location

In Windows:: PFM-Web-Console-installation-folder\CPSB\CC\server\usrconf\ejb\PFMWebConsole\
In UNIX:: /opt/jp1pcwebcon/CPSB/CC/server/usrconf/ejb/PFMWebConsole/

To Page Top

Timing of applying definition information

The definition information is applied when the Web Console service is restarted.

To Page Top

Notes

You might need to revise the setting user.language if you want to change the system locale in one of the following ways after PFM-Web Console is installed:
- From Japanese to a language other than Japanese
- From a language other than Japanese to Japanese
- From English to Chinese
- From Chinese to English
If you are running PFM - Web Console in a logical host environment, change the usrconf.cfg file on both the active and standby hosts.
If you change any of the following items while PFM - Web Console is running, a different character encoding might be mixed with the original encoding, thereby causing the contents of log files to become garbled.
- add.jvm.arg=-Duser.language
- add.jvm.arg=-Duser.country
- add.jvm.arg=-DprGB18030check
If you have changed any of these items while PFM - Web Console is running, back up log files as necessary, and then delete them.

Log files are stored in the following directories.

In Windows:

PFM-Web-Console-installation-folder\log\

In UNIX:

/opt/jp1pcwebcon/log/

To Page Top

How to modify

See Procedure for modifying PFM - Web Console definition files.

To Page Top

Setting items

The following table lists and describes the setting items available in the usconf.cfg file:

Item	Description
`add.jvm.arg=-Duser.language=language`	The default language setting used for PFM - Web Console. Values are as follows: `en` `ja` For Japanese, specify `ja`. For others, specify `en`. The default value depends on the server's locale. If you omit the specification, or if you specify an invalid value, the default value is set.
`add.jvm.arg=-Duser.country=country`	The default country setting used for PFM - Web Console. Values are as follows: `US` `JP` For Japan, specify `JP`. For others, specify `US`. The default value depends on the server's locale. If you omit the specification, or if you specify an invalid value, the default value is set.
`add.jvm.arg=-DprGB18030check=setting-value`	The setting to use GB18030 as the encoding format of PFM - Web Console. Values are as follows: `true` `false` When using Chinese (Simplified Chinese) and performing encoding in the GB18030 format, specify `true`. In other cases, specify `false`. The default value is `false`. Letter case is not distinguished. If you omit the specification, or if you specify an invalid value, the default value is set.
`add.jvm.arg=-Xmxmemory-limitm`	Specifies the upper limit on memory to be used by the PFM - Web Console service. The specified amount of memory is not always used. Specify a value in megabytes (as a multiple of 2) in the range from `1` to unlimited. The default value is `1024`. If you omit the specification, or if you specify an invalid value, the default value is set.

To Page Top

Definition example

If the system locale is Japanese but the language settings in the file usrconf.cfg are for English, you can change the settings to Japanese as follows:

add.jvm.arg=-Duser.language=ja
add.jvm.arg=-Duser.country=JP
add.jvm.arg=-DprGB18030check=false

This example sets the limit on the amount of memory used by the PFM - Web Console service to 1,024 megabytes.

add.jvm.arg=-Xmx1024m

To Page Top