4.7.1 Changing the storage location of performance data

Performance data collected by PFM - Agent for Platform is managed in the Store database of the Agent Store service of PFM - Agent for Platform. The following explains how to change the storage location for performance data.

Organization of this subsection
(1) Using the jpcconf db define (jpcdbctrl config) command to change settings
(2) Editing the jpcsto.ini file to change settings (for Store version 1.0 only)

(1) Using the jpcconf db define (jpcdbctrl config) command to change settings

The Store database uses the following directories to manage the collected performance data. These directoris can be changed by using the jpcconf db define (jpcdbctrl config) command. If you need the performance data collected before the Store database storage location is changed, execute the jpcconf db define (jpcdbctrl config) command with the -move option specified. For details about the jpcconf db define (jpcdbctrl config) command, see the manual Job Management Partner 1/Performance Management Reference.

#: This directory can be set only when the Store version is 2.0.

The following table describes the options of the jpcconf db define (jpcdbctrl config) command, including the values that can be specified.

Table 4-4 Options of the command that changes the performance data storage location

ItemOptionSpecifiable value (Store 1.0)#Specifiable value (Store 2.0)#Default
Save destination directorysdDirectory name of 1-127 bytesDirectory name of 1-214 bytes/opt/jp1pc/agtu/store
Backup destination directorybdDirectory name of 1-127 bytesDirectory name of 1-211 bytes/opt/jp1pc/agtu/store/backup
Partial backup destination directorypbd--Directory name of 1-214 bytes/opt/jp1pc/agtu/store/partial
Maximum backup generation numberbs1 to 91 to 95
Export destination directoryddDirectory name of 1-127 bytesDirectory name of 1-127 bytes/opt/jp1pc/agtu/store/dump
Import destination directoryid--Directory name of 1-222 bytes/opt/jp1pc/agtu/store/import
Legend:
--: This item cannot be set.
#
The directory name must be an absolute path name or a relative path name from the default Store database directory (/opt/jp1pc/agtu/store).

(2) Editing the jpcsto.ini file to change settings (for Store version 1.0 only)

If the Store version is 1.0, you can directly edit the jpcsto.ini file to change the settings of the above items.

(a) Items to be set in the jpcsto.ini file

The table below shows the label names and setting ranges that can be edited in the jpcsto.ini file.

Table 4-5 Setting items in the performance data storage destination ([Data Section] section of jpcsto.ini)

ItemLabel nameSpecifiable value (Store 1.0)#1Default
Save destination directoryStore Dir#2Directory name of 1-127 bytes/opt/jp1pc/agtu/store
Backup destination directoryBackup Dir#2Directory name of 1-127 bytes/opt/jp1pc/agtu/store/backup
Maximum backup generation numberBackup Save1 to 95
Export destination directoryDump Dir#2Directory name of 1-127 bytes/opt/jp1pc/agtu/store/dump
#1
  • The directory name must be an absolute path name or a relative path name from the default Store database directory (/opt/jp1pc/agtu/store).
  • Characters that can be specified are alphanumeric characters, symbols, and spaces, excluding the characters listed below:
    ;, ,, *, ?, ', ", <, >, |
  • If the specified value is invalid, the Agent Store service cannot start.
#2
You cannot specify the same directories for Store Dir, Backup Dir, and Dump Dir.
(b) Before editing the jpcsto.ini file
(c) Editing the jpcsto.ini file

To edit the jpcsto.ini file:

  1. Stop the PFM - Agent service.
    If PFM - Agent programs and services are active on the local host, stop them all.
  2. Use a text editor, for example, to open the jpcsto.ini file.
  3. Change the storage destination directory for performance data, for example.
    Modify the shaded areas below as needed.

    [Figure]

    Note
    • Do not insert a space at the beginning of the line or before or after the equal sign (=).
    • (.) in each label value indicates the default storage destination directory (/opt/jp1pc/agtu/store) for the Store database of the Agent Store service. To change the storage destination, specify a relative path from the storage destination directory, or specify an absolute path.
    • The jpcsto.ini file also describes definition information in addition to the database storage destination directory. Therefore, do not change values other than those in the [Data Section] section. If you change values other than those in the [Data Section] section, Performance Management may not operate normally.
  4. Save and close the jpcsto.ini file.
  5. Start the Performance Management programs and services.
Note:
When you use this procedure to change the Store database directory, the performance data files are not deleted from the previous directory. If these files are no longer necessary, delete only the following files:
  • All files with the .DB extension
  • All files with the .IDX extension