4.1.2 Modifying the retention conditions for performance data (in Store 2.0)

(1) Modifying the retention conditions for performance data from the monitoring console

To modify the retention conditions for performance data from the monitoring console, use the Services window in PFM - Web Console.

1. From the monitoring console Web browser, log on to PFM - Web Console.

   Log on to a user account that has administrator user permissions. You must have administrator user permissions to use the Services window.

2. In the navigation frame of the main window, select the Services tab.

3. In the navigation frame of the Services window, expand the hierarchy under the Machines folder.

   The hierarchy displays folders with the same names as the hosts where Performance Management services are installed. When you expand one of these folders, the services installed on that host are displayed. The name of each service is represented by a service ID. The service ID format differs depending on whether the product name display function is enabled. For details on the product name display function, see the chapter that describes the Performance Management functions in the JP1/Performance Management Planning and Configuration Guide.

4. Expand the hierarchy under the folder that has the same name as the host whose retention conditions you want to change, and select an Agent Store or Remote Monitor Store service.

   If the product name display function is enabled, the Agent Store or Remote Monitor Store service is indicated by host-name<service-key>(Store).

   If the product name display function is not enabled, select an Agent Store or Remote Monitor Store service with an ID that does not begin with a P and has an S as the second character. (Service IDs that begin with PS refer to a Master Store service.)

   For details on service IDs, see the description of the service naming rules in an appendix of the JP1/Performance Management Planning and Configuration Guide and the list of identifiers described in the appropriate PFM - Agent or PFM - RM manual.

   The selected Agent Store or Remote Monitor Store service is marked with a checkmark.

5. In the method frame, select the Properties method.

6. In the Properties window of the Agent Store or Remote Monitor Store service, select the RetentionEx node from the tree.

   At the bottom of the information frame, the properties of the RetentionEx node are displayed.

   You can modify the property settings. The following table gives a description of each property and lists the available settings.

   Table 4‒8: Description and settings for each property

   Record type	Node name	Property name	Settings
   PI record type	Product Interval - record-ID-of-PI-record-type	Period - Minute Drawer (Day)	The retention period for performance data collected on a per-minute basis for each record ID of PI-type records. Specify the retention period (in days) as an integer in the range from 0 to 366.
   		Period - Hour Drawer (Day)	The retention period for performance data collected on an hourly basis for each record ID of PI-type records. Specify the retention period (in days) as an integer in the range from 0 to 366.
   		Period - Day Drawer (Week)	The retention period for performance data collected on a daily basis for each record ID of PI-type records. Specify the retention period (in weeks) as an integer in the range from 0 to 522.
   		Period - Week Drawer (Week)	The retention period for performance data collected on a weekly basis for each record ID of PI-type records. Specify the retention period (in weeks) as an integer in the range from 0 to 522.
   		Period - Month Drawer (Month)	The retention period for performance data collected on a monthly basis for each record ID of PI-type records. Specify the retention period (in months) as an integer in the range from 0 to 120.
   		Period - Year Drawer (Year)	The retention period for performance data collected on a yearly basis for each record ID of PI-type records. No retention period applies to data collected on a yearly basis.
   PD record type	Product Detail - record-ID-of-PD-record-type	Period (Day)	The retention period for performance data for each record ID of PD-type records. Specify the retention period (in days) as an integer in the range from 0 to 366.
   PL record type	Product Log - record-ID-of-PL-record-type	Period (Day)	The retention period for performance data for each record ID of PL-type records. Specify the retention period (in days) as an integer in the range from 0 to 366.

7. Click Finish or Apply.

   The new settings take effect.

To Page Top

(2) Modifying the retention conditions for performance data by using commands

To modify the retention conditions for performance data by using commands, follow these general procedures:

1. Use the jpcaspsv output command to output the current definitions of the retention conditions to an XML file.

2. Based on the resulting XML file, modify the definitions of the retention conditions.

3. Use the jpcaspsv update command to update the definitions of the retention conditions from the modified XML file.

Each procedure is described below.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE pr-cli-parameters SYSTEM "aspsv_params.dtd">
<pr-cli-parameters ver="0110">
<agent-store-db-preserve-definition>
    <service id="service-ID">
        <ex-product-interval>
            <ex-interval-record id="record-ID">
                <minute-drawer-days period="retention-period-for-per-minute-data"/>
                <hour-drawer-days period="retention-period-for-hourly-data"/>
                <day-drawer-weeks period="retention-period-for-daily-data"/>
                <week-drawer-weeks period="retention-period-for-weekly-data"/>
                <month-drawer-months period="retention-period-for-monthly-data"/>
                <!-- year-drawer-years period="10" -->#
            </ex-interval-record>
        </ex-product-interval>
        <ex-product-detail>
            <ex-detail-record id="record-ID" period="record-retention-period"/>
                :
                :
        </ex-product-detail>
        <ex-product-log>
            <ex-log-record id="record-ID" period="record-retention-period"/>
                :
        </ex-product-log>
    </service>
</agent-store-db-preserve-definition>
</pr-cli-parameters>

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE pr-cli-parameters SYSTEM "aspsv_params.dtd">
<pr-cli-parameters ver="0110">

To Page Top