5.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) Notes on the 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 the initialization file in the manual Job Management Partner 1/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) Notes on the date format

For browsers, the default date format is specified using the locale settings. For commands, the default date format is set by the locale used to execute the commands. The following table shows the default pattern and format of the date that is displayed for each locale.

Table 5‒17: Default pattern and format of the date that is displayed for each locale
Locale	Default pattern	Format
`en_US`	`pattern-MMddyyyy`	`MMddyyyy`
`en`	`pattern-ddMMyyyy`	`ddMMyyyy`
`ja`	`pattern-yyyyMMdd`	`yyyyMMdd`
Other (browser)	`pattern-yyyyMMdd` (`selectFormat` in the initialization file (`config.xml`))	`yyyyMMdd`
Other (command)	`pattern-ddMMyyyy`	`ddMMyyyy`

Legend:

dd: Date

MM: Month

yyyy: Year

[Figure] : Separator (a single-byte space)

You can change the date format for a locale from the default display format by the following methods:

For browsers

Specify selectFormat in the <format> tag in the initialization file (config.xml).

This method is applicable to locales other than en_US, en, and ja.
For commands

Specify -dateformat, -dateseparator, and -exportseparator in the arguments when you execute commands. For details, see the chapter that describes commands in the manual Job Management Partner 1/Performance Management Reference.

This method is applicable to all locales.

(a) 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 5‒18: 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

(b) 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 5‒19: 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 5‒20: 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 5‒21: 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 5‒22: 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 5‒23: 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