5.4.7 Changing PFM - Web Console settings

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

The initialization file (config.xml) is stored in /opt/jp1pcwebcon/conf/.

Note:: The 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 initialization file. Change only the required information. PFM - Web Console might not operate correctly if you change locations other than the specified ones.

The items to set in the initialization file are described below.

Organization of this subsection

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

(1) Items to set in the 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 initialization file (config.xml) to the default

The configuration of the config.xml file might be changed when you perform an upgrade installation of PFM - Web Console. After the upgrade, use the following procedure to apply the edited content to the new config.xml file.

Take note of the edited content in /opt/jp1pcwebcon/conf/config.xml.
Back up /opt/jp1pcwebcon/conf/config.xml.
Replace /opt/jp1pcwebcon/conf/config.xml with the file at /opt/jp1pcwebcon/sample/conf/config.xml.
Apply the edited content you checked in step 1 to config.xml (/opt/jp1pcwebcon/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-directory\sample\conf\ and overwrite on the above directory.

To Page Top

(3) Notes on the date format

The date format differs depending on whether a browser or command is used for operation.

For details, see 4.4.7(3) Date format.

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