4.4.7 Changing PFM - Web Console settings

Use the Windows initialization file (config.xml) to set the environment necessary to operate PFM - Web Console.

The Windows initialization file (config.xml) is stored in installation-folder\conf\.

Note:: The Windows initialization file (config.xml) is loaded when a PFM - Web Console service starts. Restart the PFM - Web Console service to enable the settings you changed in the Windows initialization file. Change only the required information. PFM - Web Console might not operate correctly if you change locations that are not specified.

Organization of this subsection

(1) Items to set in Windows initialization file (config.xml)
(2) Procedure to return a changed Windows initialization file (config.xml) to the default
(3) Date format
(4) Notes on the numeric format

(1) Items to set in Windows initialization file (config.xml)

For details about the initialization file (config.xml), see the chapter that describes definition files in the manual JP1/Performance Management Reference.

To Page Top

(2) Procedure to return a changed Windows initialization file (config.xml) to the default

It is possible that the configuration of the config.xml file is changed when the version upgrade is performed. After the version upgrade, use the following procedure to reflect the edited content of the config.xml file in the new config.xml file.

To return a changed Windows initialization file to the default:

Check the content of installation-folder\conf\config.xml and take note of the edited content.
Backup installation-folder\conf\config.xml.
Overwrite installation-folder\sample\conf\config.xml on the installation-folder\conf\config.xml.
Apply the edited content you checked in step 1 to config.xml (Installation directory\conf\config.xml) copied by step3.
Restart PFM - Web Console.

Note:: When you wish to return the data of the config.xml file to the status of the initial installation, copy the config.xml file in installation-folder\sample\conf\ and overwrite on the above folder.

To Page Top

(3) Date format

The date format differs depending on whether a browser or command is used for operation. In the explanation of the date format below, dd, MM, yyyy, and Δ indicate the day, the month, the year, and a single-byte space, respectively.

(a) When a browser is used for operation

When a language is specified in a browser, the date format is determined according to the specified language as shown in the following table:

Language specified in the browser	Date format
`en` (excluding `en_US`)	`dd`Δ`MM`Δ`yyyy`
`en_US`	`MM`Δ`dd`Δ`yyyy`
`ja`	`yyyy`Δ`MM`Δ`dd`
Other	Value of `selectFormat` specified in the initialization file (`config.xml`) (The default value following installation is `dd`Δ`MM`Δ`yyyy`.)

When a language is not specified in a browser, the date format is determined according to the value of user.language in usrconf.cfg, as shown in the following table:

user.language value in usrconf.cfg	Date format
`en_US`	`MM`Δ`dd`Δ`yyyy`
`ja`	`yyyy`Δ`MM`Δ`dd`

To use a date format other than those shown above, specify a language in the browser.

Note: If no value is specified for user.language of usrconf.cfg, the date format is determined according to the OS locale. For the date format that corresponds to the relevant OS locale, see Table 4-21 Date formats that correspond to OS locales.

(b) When a command is used for operation

When a command is used, the date format is determined according to the OS locale at the time of command execution, as shown in the following table.

Table 4‒21: Date formats that correspond to OS locales
OS locale	Date format
`en_US`	`MM`Δ`dd`Δ`yyyy`
`ja`	`yyyy`Δ`MM`Δ`dd`
Other	`dd`Δ`MM`Δ`yyyy`

To change the date format, when you execute a command, specify -dateformat, -dateseparator, and -exportseparator for the arguments. For details, see the chapter that explains commands in the manual JP1/Performance Management Reference.

(c) Specifying tags for the date display format

For browsers, use the tags shown in the following table to specify the date display format in the initialization file (config.xml).

Table 4‒22: List of tags for the date display format
Tag	Attribute	Description
`format`	--	Specifies the root tag for specifying the date display format.
`param`	`name`	Specify `selectFormat`.
`param`	`value`	Values are as follows: `pattern-ddMMyyyy` `pattern-MMddyyyy` `pattern-yyyyMMdd`

Legend:: --: Not applicable

(d) Example specification of date format

This example initialization file (config.xml) specifies the date display format for browsers when the locale is other than en_US, en, or ja.

Example:

This example specifies pattern-MMddyyyy as the pattern of the date format. The date is displayed as MM dd yyyy.

<format>
   <param name="selectFormat" value="pattern-MMddyyyy"/>
</format>

To Page Top

(4) Notes on the numeric format

The decimal mark and digits separator might depend on the region.

PFM - Web Console enables you to change the numeric format (decimal mark and digits separator). The following table lists the items whose numeric format can be changed.

Table 4‒23: Items whose numeric format can be changed in PFM - Web Console
Item
GUI (browser)	Browser display
	csv output
	User input (numeric values)
Command	html output
	csv output
	Values specified in command parameter files (numeric values)

The following table lists the values that can be specified in the numeric format.

Table 4‒24: Values that can be specified in the numeric format handled by PFM - Web Console
Setting	Value that can be specified
Decimal mark	`.` (period) `,` (single-byte comma)
Digits separator	Single-byte space `'` (single quotation mark) `.` (period) `,` (single-byte comma)

Note that the numeric format settings are not applied to the data shown in the following table.

Table 4‒25: Items to which the numeric format settings are not applied in the windows of PFM - Web Console
Item	Window in which the item is displayed
Message text for alarms	Summary Print Summary Event Monitor Event History Print Event History
Description of records and fields	Record Description Field Description Quick Guide Quick Guide > Search Fields (records) Quick Guide > Search fields (list of field(s) found in record) Search Fields Edit Report Definition Service Logif
Description of property information for services	Properties method Properties window Distribute Properties

(a) Specifying tags for the decimal mark in numeric values

When you specify the decimal mark to be used for numeric values handled by PFM - Web Console in the initialization file (config.xml), specify the tags shown in the following table.

Table 4‒26: Specification of tags for the decimal mark
Tag	Attribute	Description
`number-format`	--	Specifies the root tag for specifying the decimal mark.
`param`	`name`	Specify `decimalPointSymbol`.
`param`	`value`	Values are as follows: `period` `comma`

Legend:: --: Not applicable

The following example initialization file (config.xml) specifies a comma as the decimal mark for numeric values in PFM - Web Console.

Example:

This example specifies comma as the decimal mark for numeric values.

For example, decimal value 99.1 is displayed as 99,1.

<number-format>
   <param name="decimalPointSymbol" value="comma"/>
</number-format>

(b) Specifying tags for the digits separator in numeric values

When you specify the digits separator to be used for the numeric values handled by PFM - Web Console in the initialization file (config.xml), specify the tags shown in the following table.

Table 4‒27: Specification of tags for the digits separator
Tag	Attribute	Description
`number-format`	--	Specifies the root tag for specifying the digits separator.
`param`	`name`	Specify `numericSeparator`.
`param`	`value`	Values are as follows: `space` `quotation` `period` `comma`

Legend:: --: Not applicable

The following example initialization file (config.xml) specifies a period as the digits separator for numeric values in PFM - Web Console.

Example:

This example specifies period as the digits separator.

For example, value 2,000 is displayed as 2.000.

<number-format>
   <param name="numericSeparator" value="period"/>
</number-format>

To Page Top