6.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)
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.
(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-folder\sample\conf\ and overwrite on the above folder.
(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.
Locale |
Default pattern |
Format |
---|---|---|
en_US |
pattern-MMddyyyy |
MM |
en |
pattern-ddMMyyyy |
dd |
ja |
pattern-yyyyMMdd |
yyyy |
Other (browser) |
pattern-yyyyMMdd (selectFormat in the initialization file (config.xml)) |
yyyy |
Other (command) |
pattern-ddMMyyyy |
dd |
- Legend:
-
dd: Date
MM: Month
yyyy: Year
: 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).
Tag |
Attribute |
Description |
---|---|---|
format |
-- |
Specifies the root tag for specifying the date display format. |
param |
name |
Specify selectFormat. |
value |
Values are as follows:
|
- 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>
(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.
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.
Setting |
Value that can be specified |
---|---|
Decimal mark |
|
Digits separator |
|
Note that the numeric format settings are not applied to the data shown in the following table.
Item |
Window in which the item is displayed |
---|---|
Message text for alarms |
|
Description of records and fields |
|
Description of property information for services |
|
(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.
Tag |
Attribute |
Description |
---|---|---|
number-format |
-- |
Specifies the root tag for specifying the decimal mark. |
param |
name |
Specify decimalPointSymbol. |
value |
Values are as follows:
|
- 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.
Tag |
Attribute |
Description |
---|---|---|
number-format |
-- |
Specifies the root tag for specifying the digits separator. |
param |
name |
Specify numericSeparator. |
value |
Values are as follows:
|
- 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>